Compartir a través de

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, sourceImageNotGeneralizedsourceImageInvalid, unknownFutureValue, , vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation, sourceImageWithDataDiskNotSupported, , sourceImageWithDiskEncryptionSetNotSupported, sourceImageWithAzureDiskEncryptionNotSupported. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation, sourceImageWithDataDiskNotSupported, , sourceImageWithDiskEncryptionSetNotSupported. sourceImageWithAzureDiskEncryptionNotSupported 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 11 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.
sizeInGB Int32 Tamaño de la imagen en GB. Por ejemplo, 64. 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, warning, failed, 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 generaliza. 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 de 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.
sourceImageWithDataDiskNotSupported Indica el código de error donde la imagen de origen tiene asociado un disco de datos asociado. La configuración de una directiva de aprovisionamiento con esta configuración no es compatible con W365 Frontline.
sourceImageWithDiskEncryptionSetNotSupported Indica que la imagen cargada usa un conjunto de cifrado de disco con una clave administrada por el cliente, que no se admite en Windows 365. Cargue una nueva imagen cifrada con una clave administrada por la plataforma.
sourceImageWithAzureDiskEncryptionNotSupported Indica que la imagen cargada se capturó de una máquina virtual Azure que tenía Azure cifrado de disco habilitado, que no se admite en Windows 365. Cargue una nueva imagen capturada desde una máquina virtual cifrada solo con una clave administrada por la plataforma.

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 sigue siendo compatible. Si los usuarios siguen usándolo, 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.
warning Indica que es posible que la imagen de PC en la nube cargada no se aprovisione en determinados escenarios. Para obtener más información, consulte el mensaje de error.
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 generaliza. 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 Máquina virtual que genera una imagen de origen para crear una imagen de dispositivo que se unió Microsoft Entra. 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 de 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",
  "sizeInGB": "Int32",
  "sourceImageResourceId": "String",
  "status": "String",
  "statusDetails": "String",
  "version": "String"
}
  • Last updated on