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 . |
| Carregar novamente | 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, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Tenha em atenção que tem de utilizar 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. |
| 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 10 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. |
| 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, 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. Tenha em atenção que tem de utilizar 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 foi 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. |
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 utilizar, 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. |
| 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 foi 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. |
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",
"sourceImageResourceId": "String",
"status": "String",
"statusDetails": "String",
"version": "String"
}