cloudPcDeviceImage-Ressourcentyp
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt die Imageressource auf einem Cloud-PC dar.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | cloudPcDeviceImage-Sammlung | Listet die Eigenschaften und Beziehungen von cloudPcDeviceImage-Objekten auf . |
| Get | cloudPcDeviceImage | Liest die Eigenschaften und Beziehungen eines cloudPcDeviceImage-Objekts . |
| Create | cloudPcDeviceImage | Erstellen Sie ein neues cloudPcDeviceImage-Objekt . |
| Delete | Keine | Löschen Sie ein cloudPcDeviceImage-Objekt . |
| Abrufen von Quellimages | cloudPcSourceDeviceImage-Sammlung | Abrufen von cloudPcSourceDeviceImage-Objekten . |
| Erneut hochladen | Keine | Laden Sie ein cloudPcDeviceImage-Objekt erneut hoch, das nicht hochgeladen werden konnte. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| displayName | Zeichenfolge | Der Anzeigename des zugeordneten Gerätebilds. Der Anzeigename des Geräteimages und die Version werden verwendet, um das Cloud-PC-Geräteimage eindeutig zu identifizieren. Schreibgeschützt. |
| errorCode | cloudPcDeviceImageErrorCode | Der Fehlercode des status des Bilds, der angibt, warum der Upload fehlgeschlagen ist, falls zutreffend. Mögliche Werte: internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Beachten Sie, dass Sie den Anforderungsheader Prefer: include-unknown-enum-members verwenden müssen, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Schreibgeschützt. |
| expirationDate | Datum | Das Datum, an dem das Image nicht mehr verfügbar war. Schreibgeschützt. |
| id | Zeichenfolge | Der eindeutige Bezeichner (ID) der Imageressource auf dem Cloud-PC. Schreibgeschützt. |
| lastModifiedDateTime | DateTimeOffset | Die Daten und die Uhrzeit, zu der das Bild zuletzt geändert wurde. Der Zeitstempel stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Schreibgeschützt. |
| operatingSystem | Zeichenfolge | Das Betriebssystem des Images. Beispiel: Windows 10 Enterprise. Schreibgeschützt. |
| osBuildNumber | Zeichenfolge | Die Buildversion des Betriebssystems des Images. Beispiel: 1909. Schreibgeschützt. |
| osStatus | cloudPcDeviceImageOsStatus | Die Betriebssystem-status dieses Images. Mögliche Werte: supported, supportedWithWarning, unknown, unknownFutureValue Der Standardwert ist unknown. Schreibgeschützt. |
| osVersionNumber | String | Die Betriebssystemversion dieses Images. Beispiel: 10.0.22000.296. Schreibgeschützt. |
| sourceImageResourceId | String | Der eindeutige Bezeichner (ID) der Quellimageressource in Azure. Das erforderliche ID-Format lautet: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}". Schreibgeschützt. |
| status | cloudPcDeviceImageStatus | Die status des Images auf dem Cloud-PC. Mögliche Werte: pending, ready, failed, unknownFutureValue Schreibgeschützt. |
| Version | String | Die Imageversion. Beispiel: 0.0.1 und 1.5.13. Schreibgeschützt. |
| statusDetails (veraltet) | cloudPcDeviceImageStatusDetails | Die Details der status des Bilds, die angeben, warum der Upload fehlgeschlagen ist, falls zutreffend. Mögliche Werte: internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Beachten Sie, dass Sie den Anforderungsheader Prefer: include-unknown-enum-members verwenden müssen, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Schreibgeschützt. Die statusDetails-Eigenschaft ist veraltet und gibt am 31. Januar 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die errorCode-Eigenschaft . |
cloudPcDeviceImageErrorCode-Werte
| Member | Beschreibung |
|---|---|
| internalServerError | Bei der Verarbeitung des Images ist ein interner Serverfehler aufgetreten. |
| sourceImageNotFound | Auf das Quellimage kann nicht zugegriffen werden oder nicht gefunden werden. |
| osVersionNotSupported | Die Betriebssystemversion wird nicht unterstützt. |
| sourceImageInvalid | Das Quellimage ist für die Bereitstellung eines virtuellen Windows-Computers (VM) ungültig. |
| sourceImageNotGeneralized | Das hochgeladene Bild wurde nicht generalisiert. Laden Sie das Image erneut hoch, nachdem Sie den Befehl sysprep/generalize ausgeführt haben. Weitere Informationen finden Sie unter Entfernen von computerspezifischen Informationen durch Aufheben der Bereitstellung oder Generalisierung eines virtuellen Computers vor dem Erstellen eines Images. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
| vmAlreadyAzureAdJoined | Der virtuelle Computer, der ein Quellimage zum Erstellen eines Geräteimages generiert, wurde bereits mit Microsoft Entra verknüpft. Dadurch wird verhindert, dass der Überprüfungsprozess die Erstellung eines Geräteimages mit einem solchen Quellimage zulässt. |
| paidSourceImageNotSupport | Dieses Quellimage basiert auf einem anderen kostenpflichtigen Image aus dem Azure Marketplace und wird nicht unterstützt. Verwenden Sie eine andere Quelle, um fortzufahren. |
| sourceImageNotSupportCustomizeVMName | Für das resultierende generalisierte Image liegt ein Problem mit der Computernameneinstellung vor, das die Anpassung des VM-Namens an das bereitgestellte Image verhindert. |
| sourceImageSizeExceedsLimitation | Die Größe des vom Kunden hochgeladenen Quellimages überschreitet die Sig-Einschränkungen (Shared Image Gallery), was zu einem Fehler bei der Imageerstellung führt. |
cloudPcDeviceImageOsStatus-Werte
| Member | Beschreibung |
|---|---|
| unterstützt | Gibt an, dass das Betriebssystem des Cloud-PC-Geräteimages aktiv und bereit für die Bereitstellung ist. |
| supportedWithWarning | Gibt an, dass das Betriebssystem des Cloud-PC-Geräteimages abgelaufen ist, cloud PC jedoch weiterhin unterstützt wird. Wenn Benutzer weiterhin verwenden, können sie möglicherweise keine Sicherheitsupdates erhalten. |
| unknown | Standard. Gibt an, dass die status des Betriebssystemimages für das Cloud-PC-Gerät unbekannt ist. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
cloudPcDeviceImageStatus-Werte
| Member | Beschreibung |
|---|---|
| anhängig | Der Bildupload wird ausgeführt. |
| fertig | Das Image kann auf Cloud-PCs verwendet werden. |
| misslungen | Gibt an, dass das Bild nicht hochgeladen werden konnte. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
cloudPcDeviceImageStatusDetails-Werte
| Member | Beschreibung |
|---|---|
| internalServerError | Bei der Verarbeitung des Images ist ein interner Serverfehler aufgetreten. |
| sourceImageNotFound | Auf das Quellimage kann nicht zugegriffen werden oder nicht gefunden werden. |
| osVersionNotSupported | Die Betriebssystemversion wird nicht unterstützt. |
| sourceImageInvalid | Das Quellimage ist für die Bereitstellung eines virtuellen Windows-Computers (VM) ungültig. |
| sourceImageNotGeneralized | Das hochgeladene Bild wurde nicht generalisiert. Laden Sie das Image erneut hoch, nachdem Sie den Befehl sysprep/generalize ausgeführt haben. Weitere Informationen finden Sie unter Entfernen von computerspezifischen Informationen durch Aufheben der Bereitstellung oder Generalisierung eines virtuellen Computers vor dem Erstellen eines Images. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
| vmAlreadyAzureAdJoined | Der virtuelle Computer, der ein Quellimage zum Erstellen eines Geräteimages generiert, wurde bereits mit Microsoft Entra verknüpft. Dadurch wird verhindert, dass der Überprüfungsprozess die Erstellung eines Geräteimages mit einem solchen Quellimage zulässt. |
| paidSourceImageNotSupport | Dieses Quellimage basiert auf einem anderen kostenpflichtigen Image aus dem Azure Marketplace und wird nicht unterstützt. Verwenden Sie eine andere Quelle, um fortzufahren. |
| sourceImageNotSupportCustomizeVMName | Für das resultierende generalisierte Image liegt ein Problem mit der Computernameneinstellung vor, das die Anpassung des VM-Namens an das bereitgestellte Image verhindert. |
| sourceImageSizeExceedsLimitation | Die Größe des vom Kunden hochgeladenen Quellimages überschreitet die Sig-Einschränkungen (Shared Image Gallery), was zu einem Fehler bei der Imageerstellung führt. |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@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"
}