Compartilhar via

cloudPcDeviceImage tipo de recurso

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 num PC na Cloud.

Métodos

Método Tipo de retorno Descrição
List cloudPcDeviceImage collection Liste as propriedades e relações dos objetos cloudPcDeviceImage .
Get cloudPcDeviceImage Leia as propriedades e relações de um objeto cloudPcDeviceImage .
Create cloudPcDeviceImage Crie um novo objeto cloudPcDeviceImage .
Delete Nenhum Eliminar um objeto cloudPcDeviceImage .
Obter imagens de origem cloudPcSourceDeviceImage collection Obter objetos cloudPcSourceDeviceImage .
Recarregar Nenhum Recarregue um objeto cloudPcDeviceImage que não conseguiu carregar.

Propriedades

Propriedade Tipo Descrição
displayName Cadeia de caracteres O nome a apresentar da imagem do dispositivo associada. O nome a apresentar da imagem do dispositivo e a versão são utilizados para identificar exclusivamente a imagem do dispositivo cloud PC. Somente leitura.
errorCode cloudPcDeviceImageErrorCode O código de erro do status da imagem que indica o motivo pelo qual o carregamento falhou, se aplicável. Os valores possíveis são: internalServerError, , osVersionNotSupportedsourceImageNotFound, , sourceImageNotGeneralizedsourceImageInvalid, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, , sourceImageSizeExceedsLimitation, sourceImageWithDataDiskNotSupported, , . sourceImageWithAzureDiskEncryptionNotSupportedsourceImageWithDiskEncryptionSetNotSupported Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: vmAlreadyAzureAdJoined, , paidSourceImageNotSupportsourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation, sourceImageWithDataDiskNotSupported, sourceImageWithDiskEncryptionSetNotSupported, . sourceImageWithAzureDiskEncryptionNotSupported Somente leitura.
expirationDate Data A data em que a imagem ficou indisponível. Somente leitura.
id Cadeia de caracteres O identificador exclusivo (ID) do recurso de imagem no CLOUD PC. Somente leitura.
lastModifiedDateTime DateTimeOffset Os dados e a hora em que a imagem foi modificada pela última vez. O carimbo de data/hora representa informações de data e hora com 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 operativo da imagem. Por exemplo, Windows 11 Enterprise. Somente leitura.
osBuildNumber Cadeia de caracteres A versão de compilação do SO da imagem. Por exemplo, 1909. Somente leitura.
osStatus cloudPcDeviceImageOsStatus O SO status desta imagem. Os valores possíveis são: supported, supportedWithWarning, unknown, unknownFutureValue. O valor padrão é unknown. Somente leitura.
osVersionNumber Cadeia de caracteres A versão do sistema operativo desta imagem. Por exemplo, 10.0.22000.296. Somente leitura.
sizeInGB Int32 O tamanho da imagem em GB. Por exemplo, 64. 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 CLOUD PC. Os valores possíveis são: pending, ready, warning, 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 o motivo pelo qual o carregamento falhou, se aplicável. Os valores possíveis são: internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Somente leitura. A propriedade statusDetails foi preterida e deixará de devolver dados a 31 de janeiro de 2024. No futuro, utilize a propriedade errorCode .

cloudPcDeviceImageErrorCode valores

Member Descrição
internalServerError Ocorreu um erro interno do servidor durante o processamento da imagem.
sourceImageNotFound A imagem de origem está inacessível ou não foi encontrada.
osVersionNotSupported A versão do SO não é suportada.
sourceImageInvalid A imagem de origem é inválida para aprovisionar uma máquina virtual (VM) do Windows.
sourceImageNotGeneralized A imagem carregada não é generalizada. Recarregue a imagem depois de executar o comando sysprep/generalize. Para saber mais, veja Remover informações específicas do computador ao desaprovisionar ou generalizar uma VM antes de criar uma imagem.
unknownFutureValue Valor da 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 associada ao Microsoft Entra. Isto impede que o processo de validação permita a criação de uma imagem de dispositivo com essa imagem de origem.
paidSourceImageNotSupport Esta imagem de origem é criada a partir de outra imagem paga do Azure Marketplace e não é suportada; utilize outra origem para continuar.
sourceImageNotSupportCustomizeVMName Existe um problema de definição de nome de 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 galeria de imagens partilhadas (SIG), o que resulta numa falha na criação de imagens.
sourceImageWithDataDiskNotSupported Indica o código de erro em que a imagem de origem tem um disco de dados associado anexado. A configuração de uma política de aprovisionamento com esta configuração não é suportada com o W365 Frontline.
sourceImageWithDiskEncryptionSetNotSupported Indica que a imagem carregada utiliza um conjunto de encriptação de disco com uma chave gerida pelo cliente, que não é suportada no Windows 365. Carregue uma nova imagem encriptada com uma chave gerida pela plataforma.
sourceImageWithAzureDiskEncryptionNotSupported Indica que a imagem carregada foi capturada a partir de uma máquina virtual Azure que tinha Azure encriptação de disco ativada, o que não é suportado no Windows 365. Carregue uma nova imagem capturada a partir de uma VM encriptada apenas com uma chave gerida pela plataforma.

cloudPcDeviceImageOsStatus values (valores cloudPcDeviceImageOsStatus)

Member Descrição
com suporte Indica que o sistema operativo da imagem do dispositivo do CLOUD PC está ativo e pronto para ser utilizado para aprovisionamento.
supportedWithWarning Indica que o sistema operativo da imagem do dispositivo cloud PC expirou, mas o Cloud PC continua a suportar. Se os utilizadores continuarem a utilizá-lo, poderão não conseguir obter atualizações de segurança.
desconhecido Padrão. Indica que a status da imagem do sistema operativo para o dispositivo Cloud PC é desconhecida.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.

cloudPcDeviceImageStatus values (valores cloudPcDeviceImageStatus)

Member Descrição
pendente O carregamento da imagem está em curso.
pronto A imagem está pronta para ser utilizada em PCs na Cloud.
warning Indica que a imagem do CLOUD PC carregada pode não ser aprovisionada em determinados cenários. Para obter detalhes, veja a mensagem de erro.
falha Indica que a imagem não conseguiu carregar.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.

cloudPcDeviceImageStatusDetails values (valores cloudPcDeviceImageStatusDetails)

Member Descrição
internalServerError Ocorreu um erro interno do servidor durante o processamento da imagem.
sourceImageNotFound A imagem de origem está inacessível ou não foi encontrada.
osVersionNotSupported A versão do SO não é suportada.
sourceImageInvalid A imagem de origem é inválida para aprovisionar uma máquina virtual (VM) do Windows.
sourceImageNotGeneralized A imagem carregada não é generalizada. Recarregue a imagem depois de executar o comando sysprep/generalize. Para saber mais, veja Remover informações específicas do computador ao desaprovisionar ou generalizar uma VM antes de criar uma imagem.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.
vmAlreadyAzureAdJoined A VM que gera uma imagem de origem para criar uma imagem de dispositivo que se associou Microsoft Entra. Impede que o processo de validação permita a criação de uma imagem de dispositivo com essa imagem de origem.
paidSourceImageNotSupport Esta imagem de origem é criada a partir de outra imagem paga do Azure Marketplace e não é suportada; utilize outra origem para continuar.
sourceImageNotSupportCustomizeVMName Existe um problema de definição de nome de 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 galeria de imagens partilhadas (SIG), o que resulta numa falha na criação de imagens.

Relações

Nenhum

Representação JSON

A representação JSON seguinte 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",
  "osVersionNumber": "String",
  "sizeInGB": "Int32",
  "sourceImageResourceId": "String",
  "status": "String",
  "statusDetails": "String",
  "version": "String"
}
  • Last updated on