tipo de recurso cloudPcDeviceImage

Artigo
01/23/2024

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa o recurso de imagem em um pc de nuvem.

Métodos

Método	Tipo de retorno	Descrição
Listar deviceImages	coleção cloudPcDeviceImage	Liste as propriedades e as relações dos objetos cloudPcDeviceImage .
Obter cloudPcDeviceImage	cloudPcDeviceImage	Leia as propriedades e as relações de um objeto cloudPcDeviceImage .
Criar cloudPcDeviceImage	cloudPcDeviceImage	Crie um novo objeto cloudPcDeviceImage .
Excluir cloudPcDeviceImage	Nenhum	Exclua um objeto cloudPcDeviceImage .
getSourceImages	coleção cloudPcSourceDeviceImage	Obtenha objetos cloudPcSourceDeviceImage .
Recarregar cloudPcDeviceImage	Nenhum	Recarregue um objeto cloudPcDeviceImage que não foi carregado.

Propriedades

Propriedade	Tipo	Descrição
displayName	Cadeia de caracteres	O nome de exibição da imagem do dispositivo associada. O nome de exibição da imagem do dispositivo e a versão são usados para identificar exclusivamente a imagem do dispositivo cloud pc. Somente leitura.
errorCode	cloudPcDeviceImageErrorCode	O código de erro do status da imagem que indica por que o upload falhou, se aplicável. Os valores possíveis são: `internalServerError`, `sourceImageNotFound`, `osVersionNotSupported`, `sourceImageInvalid`, `sourceImageNotGeneralized`, `unknownFutureValue`, `vmAlreadyAzureAdJoined`, `paidSourceImageNotSupport`, `sourceImageNotSupportCustomizeVMName`, `sourceImageSizeExceedsLimitation`. Observe que você deve usar o cabeçalho de `Prefer: include-unknown-enum-members` solicitação para obter os seguintes valores deste enumerável em evolução: `vmAlreadyAzureAdJoined`, `paidSourceImageNotSupport`, , `sourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation`. Somente leitura.
Expirationdate	Date	A data em que a imagem ficou indisponível. Somente leitura.
id	Cadeia de caracteres	O identificador exclusivo (ID) do recurso de imagem no PC de Nuvem. Somente leitura.
lastModifiedDateTime	DateTimeOffset	Os dados e a hora em que a imagem foi modificada pela última vez. O carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é `2014-01-01T00:00:00Z`. Somente leitura.
operatingSystem	Cadeia de caracteres	O sistema operacional da imagem. Por exemplo, `Windows 10 Enterprise`. Somente leitura.
osBuildNumber	Cadeia de caracteres	A versão de build do sistema operacional da imagem. Por exemplo, `1909`. Somente leitura.
osStatus	cloudPcDeviceImageOsStatus	O sistema operacional status dessa imagem. Os valores possíveis são: `supported`, `supportedWithWarning`, `unknown`, `unknownFutureValue`. O valor padrão é `unknown`. Somente leitura.
sourceImageResourceId	Cadeia de caracteres	O identificador exclusivo (ID) do recurso de imagem de origem no Azure. O formato de ID necessário é: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}". Somente leitura.
status	cloudPcDeviceImageStatus	O status da imagem no COMPUTADOR de Nuvem. Os valores possíveis são: `pending`, `ready`, `failed`, `unknownFutureValue`. Somente leitura.
versão	Cadeia de caracteres	A versão da imagem. Por exemplo, `0.0.1` e `1.5.13`. Somente leitura.
statusDetails (preterido)	cloudPcDeviceImageStatusDetails	Os detalhes do status da imagem que indica por que o upload falhou, se aplicável. Os valores possíveis são: `internalServerError`, `sourceImageNotFound`, `osVersionNotSupported`, `sourceImageInvalid`, `sourceImageNotGeneralized`, `unknownFutureValue`, `vmAlreadyAzureAdJoined`, `paidSourceImageNotSupport`, `sourceImageNotSupportCustomizeVMName`, `sourceImageSizeExceedsLimitation`. Observe que você deve usar o cabeçalho de `Prefer: include-unknown-enum-members` solicitação para obter os seguintes valores deste enumerável em evolução: `vmAlreadyAzureAdJoined`, `paidSourceImageNotSupport`, , `sourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation`. Somente leitura. A propriedade statusDetails está preterida e deixará de retornar dados em 31 de janeiro de 2024. Daqui para frente, use a propriedade errorCode .

valores cloudPcDeviceImageErrorCode

Member	Descrição
internalServerError	Ocorreu um erro interno do servidor durante o processamento da imagem.
sourceImageNotFound	A imagem de origem é inacessível ou não encontrada.
osVersionNotSupported	A versão do sistema operacional não tem suporte.
sourceImageInvalid	A imagem de origem é inválida para provisionar uma VM (máquina virtual do Windows).
sourceImageNotGeneralized	A imagem carregada não foi generalizada. Recarregue a imagem depois de executar o comando sysprep/generalize. Para saber mais, confira Remover informações específicas do computador desprovisionando ou generalizando uma VM antes de criar uma imagem.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.
vmAlreadyAzureAdJoined	A VM que gera uma imagem de origem para criar uma imagem de dispositivo já foi ingressada no Microsoft Entra. Isso impede que o processo de validação permita a criação de uma imagem de dispositivo usando essa imagem de origem.
paidSourceImageNotSupport	Essa imagem de origem é criada a partir de outra imagem paga do Azure Marketplace e não tem suporte; use outra fonte para prosseguir.
sourceImageNotSupportCustomizeVMName	Existe um problema de configuração de nome do computador na imagem generalizada resultante, o que impede a personalização do nome da VM com a imagem fornecida.
sourceImageSizeExceedsLimitation	O tamanho da imagem de origem carregada pelo cliente excede as limitações da SIG (galeria de imagens compartilhadas), o que resulta em falha na criação de imagem.

valores cloudPcDeviceImageOsStatus

Member	Descrição
com suporte	Indica que o sistema operacional de imagem do dispositivo cloud pc está ativo e pronto para ser usado para provisionamento.
supportedWithWarning	Indica que o sistema operacional de imagem do dispositivo cloud pc expirou, mas o CLOUD PC continua com suporte. Se os usuários continuarem a usar, talvez não consigam obter atualizações de segurança.
desconhecido	Padrão. Indica que o status da imagem do sistema operacional para o dispositivo cloud pc é desconhecido.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.

valores cloudPcDeviceImageStatus

Member	Descrição
Pendente	O upload da imagem está em andamento.
Pronto	A imagem está pronta para uso em PCs de nuvem.
Falhou	Indica que a imagem não foi carregada.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.

valores cloudPcDeviceImageStatusDetails

Member	Descrição
internalServerError	Ocorreu um erro interno do servidor durante o processamento da imagem.
sourceImageNotFound	A imagem de origem é inacessível ou não encontrada.
osVersionNotSupported	A versão do sistema operacional não tem suporte.
sourceImageInvalid	A imagem de origem é inválida para provisionar uma VM (máquina virtual do Windows).
sourceImageNotGeneralized	A imagem carregada não foi generalizada. Recarregue a imagem depois de executar o comando sysprep/generalize. Para saber mais, confira Remover informações específicas do computador desprovisionando ou generalizando uma VM antes de criar uma imagem.
unknownFutureValue	Valor sentinela de enumeração evoluível. Não usar.
vmAlreadyAzureAdJoined	A VM que gera uma imagem de origem para criar uma imagem de dispositivo já foi ingressada no Microsoft Entra. Isso impede que o processo de validação permita a criação de uma imagem de dispositivo usando essa imagem de origem.
paidSourceImageNotSupport	Essa imagem de origem é criada a partir de outra imagem paga do Azure Marketplace e não tem suporte; use outra fonte para prosseguir.
sourceImageNotSupportCustomizeVMName	Existe um problema de configuração de nome do computador na imagem generalizada resultante, o que impede a personalização do nome da VM com a imagem fornecida.
sourceImageSizeExceedsLimitation	O tamanho da imagem de origem carregada pelo cliente excede as limitações da SIG (galeria de imagens compartilhadas), o que resulta em falha na criação de imagem.

Relações

Nenhum

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.cloudPcDeviceImage",
  "displayName": "String",
  "errorCode": "String",
  "expirationDate": "String (timestamp)",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "operatingSystem": "String",
  "osBuildNumber": "String",
  "osStatus": "String",
  "sourceImageResourceId": "String",
  "status": "String",
  "statusDetails": "String",
  "version": "String"
}