Type de ressource cloudPcDeviceImage
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente la ressource image sur un PC cloud.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| List | collection cloudPcDeviceImage | Répertorie les propriétés et les relations des objets cloudPcDeviceImage . |
| Obtenir | cloudPcDeviceImage | Lisez les propriétés et les relations d’un objet cloudPcDeviceImage . |
| Create | cloudPcDeviceImage | Créez un objet cloudPcDeviceImage . |
| Supprimer | Aucun | Supprime un objet cloudPcDeviceImage . |
| Obtenir des images sources | collection cloudPcSourceDeviceImage | Obtenir des objets cloudPcSourceDeviceImage . |
| Charger à nouveau | Aucun | Rechargez un objet cloudPcDeviceImage qui n’a pas pu être chargé. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| displayName | String | Nom complet de l’image d’appareil associée. Le nom complet et la version de l’image de l’appareil sont utilisés pour identifier de manière unique l’image de l’appareil PC cloud. En lecture seule. |
| errorCode | cloudPcDeviceImageErrorCode | Code d’erreur du status de l’image qui indique la raison de l’échec du chargement, le cas échéant. Les valeurs possibles sont les suivantes : internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName et sourceImageSizeExceedsLimitation. Notez que vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes de cette énumération évolutive : vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. En lecture seule. |
| expirationDate | Date | Date à laquelle l’image est devenue indisponible. En lecture seule. |
| id | String | Identificateur unique (ID) de la ressource image sur le PC cloud. En lecture seule. |
| lastModifiedDateTime | DateTimeOffset | Données et heure de la dernière modification de l’image. L’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. En lecture seule. |
| operatingSystem | String | Système d’exploitation de l’image. Par exemple : Windows 10 Enterprise. En lecture seule. |
| osBuildNumber | String | Version de build du système d’exploitation de l’image. Par exemple : 1909. En lecture seule. |
| osStatus | cloudPcDeviceImageOsStatus | Le système d’exploitation status de cette image. Les valeurs possibles sont les suivantes : supported, supportedWithWarning, unknown, unknownFutureValue. La valeur par défaut est unknown. En lecture seule. |
| osVersionNumber | String | Version du système d’exploitation de cette image. Par exemple : 10.0.22000.296. En lecture seule. |
| sourceImageResourceId | String | Identificateur unique (ID) de la ressource d’image source sur Azure. Le format d’ID requis est : « /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName} ». En lecture seule. |
| status | cloudPcDeviceImageStatus | Status de l’image sur le PC cloud. Les valeurs possibles sont les suivantes : pending, ready, failed, unknownFutureValue. En lecture seule. |
| version | String | Version de l’image. Par exemple, 0.0.1 et 1.5.13. En lecture seule. |
| statusDetails (déconseillé) | cloudPcDeviceImageStatusDetails | Les détails de la status de l’image qui indiquent la raison de l’échec du chargement, le cas échéant. Les valeurs possibles sont les suivantes : internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName et sourceImageSizeExceedsLimitation. Notez que vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes de cette énumération évolutive : vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. En lecture seule. La propriété statusDetails est déconseillée et cessera de retourner des données le 31 janvier 2024. À l’avenir, utilisez la propriété errorCode . |
Valeurs cloudPcDeviceImageErrorCode
| Member | Description |
|---|---|
| internalServerError | Une erreur de serveur interne s’est produite pendant le traitement de l’image. |
| sourceImageNotFound | L’image source est inaccessible ou introuvable. |
| osVersionNotSupported | La version du système d’exploitation n’est pas prise en charge. |
| sourceImageInvalid | L’image source n’est pas valide pour le provisionnement d’une machine virtuelle Windows. |
| sourceImageNotGeneralized | L’image chargée n’a pas été généralisée. Rechargez l’image après avoir exécuté la commande sysprep/generalize. Pour plus d’informations, consultez Supprimer des informations spécifiques à l’ordinateur en déprovisionnant ou en généralisant une machine virtuelle avant de créer une image. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
| vmAlreadyAzureAdJoined | La machine virtuelle qui génère une image source pour créer une image d’appareil a déjà été jointe à Microsoft Entra. Cela empêche le processus de validation d’autoriser la création d’une image d’appareil à l’aide d’une telle image source. |
| paidSourceImageNotSupport | Cette image source est générée à partir d’une autre image payante à partir du Place de marché Azure et n’est pas prise en charge. Utilisez une autre source pour continuer. |
| sourceImageNotSupportCustomizeVMName | Un problème de paramètre de nom d’ordinateur existe sur l’image généralisée résultante, ce qui empêche la personnalisation du nom de la machine virtuelle avec l’image fournie. |
| sourceImageSizeExceedsLimitation | La taille de l’image source chargée par le client dépasse les limites de la galerie d’images partagées (SIG), ce qui entraîne un échec de création d’image. |
Valeurs cloudPcDeviceImageOsStatus
| Member | Description |
|---|---|
| Pris en charge | Indique que le système d’exploitation d’image d’appareil PC cloud est actif et prêt à être utilisé pour l’approvisionnement. |
| supportedWithWarning | Indique que le système d’exploitation de l’image d’appareil PC cloud a expiré, mais que cloud PC continue de prendre en charge. Si les utilisateurs continuent à utiliser, ils peuvent ne pas être en mesure d’obtenir les mises à jour de sécurité. |
| unknown | Valeur par défaut. Indique que la status de l’image du système d’exploitation pour l’appareil PC cloud est inconnue. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
Valeurs cloudPcDeviceImageStatus
| Member | Description |
|---|---|
| en instance | Le chargement de l’image est en cours. |
| prêt | L’image est prête à être utilisée sur les PC cloud. |
| raté | Indique que le chargement de l’image a échoué. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
valeurs cloudPcDeviceImageStatusDetails
| Member | Description |
|---|---|
| internalServerError | Une erreur de serveur interne s’est produite pendant le traitement de l’image. |
| sourceImageNotFound | L’image source est inaccessible ou introuvable. |
| osVersionNotSupported | La version du système d’exploitation n’est pas prise en charge. |
| sourceImageInvalid | L’image source n’est pas valide pour le provisionnement d’une machine virtuelle Windows. |
| sourceImageNotGeneralized | L’image chargée n’a pas été généralisée. Rechargez l’image après avoir exécuté la commande sysprep/generalize. Pour plus d’informations, consultez Supprimer des informations spécifiques à l’ordinateur en déprovisionnant ou en généralisant une machine virtuelle avant de créer une image. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
| vmAlreadyAzureAdJoined | La machine virtuelle qui génère une image source pour créer une image d’appareil a déjà été jointe à Microsoft Entra. Cela empêche le processus de validation d’autoriser la création d’une image d’appareil à l’aide d’une telle image source. |
| paidSourceImageNotSupport | Cette image source est générée à partir d’une autre image payante à partir du Place de marché Azure et n’est pas prise en charge. Utilisez une autre source pour continuer. |
| sourceImageNotSupportCustomizeVMName | Un problème de paramètre de nom d’ordinateur existe sur l’image généralisée résultante, ce qui empêche la personnalisation du nom de la machine virtuelle avec l’image fournie. |
| sourceImageSizeExceedsLimitation | La taille de l’image source chargée par le client dépasse les limites de la galerie d’images partagées (SIG), ce qui entraîne un échec de création d’image. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@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"
}