Tipo de recurso cloudPcDeviceImage
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa el recurso de imagen en un equipo en la nube.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | cloudPcDeviceImage (colección) | Enumere las propiedades y las relaciones de los objetos cloudPcDeviceImage . |
| Get | cloudPcDeviceImage | Lea las propiedades y relaciones de un objeto cloudPcDeviceImage . |
| Crear | cloudPcDeviceImage | Cree un nuevo objeto cloudPcDeviceImage . |
| Delete | Ninguno | Elimine un objeto cloudPcDeviceImage . |
| Obtención de imágenes de origen | colección cloudPcSourceDeviceImage | Obtenga objetos cloudPcSourceDeviceImage . |
| Volver a cargar | Ninguno | Vuelva a cargar un objeto cloudPcDeviceImage que no se pudo cargar. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| displayName | Cadena | Nombre para mostrar de la imagen de dispositivo asociada. El nombre para mostrar de la imagen de dispositivo y la versión se usan para identificar de forma única la imagen del dispositivo de PC en la nube. Solo lectura. |
| errorCode | cloudPcDeviceImageErrorCode | Código de error del estado de la imagen que indica por qué se produjo un error en la carga, si procede. Los valores posibles son: internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName y sourceImageSizeExceedsLimitation. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Solo lectura. |
| expirationDate | Fecha | Fecha en la que la imagen deja de estar disponible. Solo lectura. |
| id | Cadena | Identificador único (ID) del recurso de imagen en el equipo en la nube. Solo lectura. |
| lastModifiedDateTime | DateTimeOffset | Los datos y la hora en que se modificó la imagen por última vez. La marca de tiempo representa la información de fecha y hora con formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Solo lectura. |
| operatingSystem | Cadena | Sistema operativo de la imagen. Por ejemplo, Windows 10 Enterprise. Solo lectura. |
| osBuildNumber | Cadena | Versión de compilación del sistema operativo de la imagen. Por ejemplo, 1909. Solo lectura. |
| osStatus | cloudPcDeviceImageOsStatus | Estado del sistema operativo de esta imagen. Los valores posibles son: supported, supportedWithWarning, unknown y unknownFutureValue. El valor predeterminado es unknown. Solo lectura. |
| osVersionNumber | Cadena | La versión del sistema operativo de esta imagen. Por ejemplo, 10.0.22000.296. Solo lectura. |
| sourceImageResourceId | Cadena | Identificador único (ID) del recurso de imagen de origen en Azure. El formato de identificador necesario es: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}". Solo lectura. |
| status | cloudPcDeviceImageStatus | Estado de la imagen en el equipo en la nube. Los valores posibles son: pending, ready, failed y unknownFutureValue. Solo lectura. |
| version | Cadena | Versión de la imagen. Por ejemplo, 0.0.1 y 1.5.13. Solo lectura. |
| statusDetails (en desuso) | cloudPcDeviceImageStatusDetails | Los detalles del estado de la imagen que indica por qué se produjo un error en la carga, si procede. Los valores posibles son: internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName y sourceImageSizeExceedsLimitation. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Solo lectura. La propiedad statusDetails está en desuso y dejará de devolver datos el 31 de enero de 2024. En el futuro, use la propiedad errorCode . |
valores cloudPcDeviceImageErrorCode
| Member | Descripción |
|---|---|
| internalServerError | Error interno del servidor durante el procesamiento de la imagen. |
| sourceImageNotFound | No se puede acceder a la imagen de origen o no se encuentra. |
| osVersionNotSupported | No se admite la versión del sistema operativo. |
| sourceImageInvalid | La imagen de origen no es válida para aprovisionar una máquina virtual (VM) Windows. |
| sourceImageNotGeneralized | La imagen cargada no se ha generalizado. Vuelva a cargar la imagen después de ejecutar el comando sysprep/generalize. Para obtener más información, consulte Quitar información específica de la máquina desaprovisionando o generalizando una máquina virtual antes de crear una imagen. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
| vmAlreadyAzureAdJoined | La máquina virtual que genera una imagen de origen para crear una imagen de dispositivo ya se ha unido a Microsoft Entra. Esto impide que el proceso de validación permita la creación de una imagen de dispositivo mediante dicha imagen de origen. |
| paidSourceImageNotSupport | Esta imagen de origen se compila a partir de otra imagen de pago del Azure Marketplace y no se admite; use otro origen para continuar. |
| sourceImageNotSupportCustomizeVMName | Existe un problema de configuración de nombre de equipo en la imagen generalizada resultante, lo que impide la personalización del nombre de la máquina virtual con la imagen proporcionada. |
| sourceImageSizeExceedsLimitation | El tamaño de la imagen de origen cargada por el cliente supera las limitaciones de la galería de imágenes compartidas (SIG), lo que da lugar a un error de creación de imágenes. |
valores cloudPcDeviceImageOsStatus
| Member | Descripción |
|---|---|
| compatible | Indica que el sistema operativo de imagen de dispositivo de PC en la nube está activo y listo para usarse para el aprovisionamiento. |
| supportedWithWarning | Indica que el sistema operativo de imagen de dispositivo de PC en la nube ha expirado, pero el equipo en la nube continúa con la compatibilidad. Si los usuarios siguen usando, es posible que no puedan obtener actualizaciones de seguridad. |
| desconocido | Valor predeterminado. Indica que se desconoce el estado de la imagen del sistema operativo del dispositivo pc en la nube. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
valores cloudPcDeviceImageStatus
| Member | Descripción |
|---|---|
| pendiente | La carga de imágenes está en curso. |
| listo | La imagen está lista para su uso en equipos en la nube. |
| fracasado | Indica que la imagen no se pudo cargar. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
valores cloudPcDeviceImageStatusDetails
| Member | Descripción |
|---|---|
| internalServerError | Error interno del servidor durante el procesamiento de la imagen. |
| sourceImageNotFound | No se puede acceder a la imagen de origen o no se encuentra. |
| osVersionNotSupported | No se admite la versión del sistema operativo. |
| sourceImageInvalid | La imagen de origen no es válida para aprovisionar una máquina virtual (VM) Windows. |
| sourceImageNotGeneralized | La imagen cargada no se ha generalizado. Vuelva a cargar la imagen después de ejecutar el comando sysprep/generalize. Para obtener más información, consulte Quitar información específica de la máquina desaprovisionando o generalizando una máquina virtual antes de crear una imagen. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
| vmAlreadyAzureAdJoined | La máquina virtual que genera una imagen de origen para crear una imagen de dispositivo ya se ha unido a Microsoft Entra. Esto impide que el proceso de validación permita la creación de una imagen de dispositivo mediante dicha imagen de origen. |
| paidSourceImageNotSupport | Esta imagen de origen se compila a partir de otra imagen de pago del Azure Marketplace y no se admite; use otro origen para continuar. |
| sourceImageNotSupportCustomizeVMName | Existe un problema de configuración de nombre de equipo en la imagen generalizada resultante, lo que impide la personalización del nombre de la máquina virtual con la imagen proporcionada. |
| sourceImageSizeExceedsLimitation | El tamaño de la imagen de origen cargada por el cliente supera las limitaciones de la galería de imágenes compartidas (SIG), lo que da lugar a un error de creación de imágenes. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el 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"
}