Tipo de recurso cloudPcDeviceImage

Artículo
01/23/2024

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
Enumerar deviceImages	cloudPcDeviceImage (colección)	Enumere las propiedades y las relaciones de los objetos cloudPcDeviceImage .
Obtener cloudPcDeviceImage	cloudPcDeviceImage	Lea las propiedades y relaciones de un objeto cloudPcDeviceImage .
Creación de cloudPcDeviceImage	cloudPcDeviceImage	Cree un nuevo objeto cloudPcDeviceImage .
Eliminar cloudPcDeviceImage	Ninguno	Elimine un objeto cloudPcDeviceImage .
getSourceImages	colección cloudPcSourceDeviceImage	Obtenga objetos cloudPcSourceDeviceImage .
Volver a cargar cloudPcDeviceImage	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`. Tenga en cuenta que debe usar el `Prefer: include-unknown-enum-members` encabezado de 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.
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`. Tenga en cuenta que debe usar el `Prefer: include-unknown-enum-members` encabezado de 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.
Fallado	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",
  "sourceImageResourceId": "String",
  "status": "String",
  "statusDetails": "String",
  "version": "String"
}