cloudPcDeviceImage リソースの種類

[アーティクル]
09/27/2024

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

クラウド PC 上のイメージリソースを表します。

メソッド

メソッド	戻り値の種類	説明
List	cloudPcDeviceImage コレクション	cloudPcDeviceImage オブジェクトのプロパティとリレーションシップを一覧表示します。
Get	cloudPcDeviceImage	cloudPcDeviceImage オブジェクトのプロパティとリレーションシップを読み取ります。
Create	cloudPcDeviceImage	新しい cloudPcDeviceImage オブジェクトを作成します。
Delete	なし	cloudPcDeviceImage オブジェクトを削除します。
ソース画像を取得する	cloudPcSourceDeviceImage コレクション	cloudPcSourceDeviceImage オブジェクトを取得します。
再アップロード	なし	アップロードに失敗した cloudPcDeviceImage オブジェクトを再アップロードします。

プロパティ

プロパティ	型	説明
displayName	String	関連付けられているデバイスイメージの表示名。デバイスイメージの表示名とバージョンは、クラウド PC デバイスイメージを一意に識別するために使用されます。読み取り専用です。
errorCode	cloudPcDeviceImageErrorCode	アップロードが失敗した理由 (該当する場合) を示すイメージの状態のエラーコード。可能な値は、`internalServerError`、`sourceImageNotFound`、`osVersionNotSupported`、`sourceImageInvalid`、`sourceImageNotGeneralized`、`unknownFutureValue`、`vmAlreadyAzureAdJoined`、`paidSourceImageNotSupport`、`sourceImageNotSupportCustomizeVMName`、`sourceImageSizeExceedsLimitation` です。この進化可能な列挙型から次の値を取得するには、`Prefer: include-unknown-enum-members`要求ヘッダーを使用する必要があることに注意してください。`vmAlreadyAzureAdJoined`、`paidSourceImageNotSupport`、`sourceImageNotSupportCustomizeVMName`、`sourceImageSizeExceedsLimitation`。読み取り専用です。
expirationDate	Date	イメージが使用できなくなった日付。読み取り専用です。
id	String	クラウド PC 上のイメージリソースの一意識別子 (ID)。読み取り専用です。
lastModifiedDateTime	DateTimeOffset	イメージが最後に変更されたデータと時刻。タイムスタンプは、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。読み取り専用です。
operatingSystem	String	イメージのオペレーティングシステム。たとえば、「 `Windows 10 Enterprise` 」のように入力します。読み取り専用です。
osBuildNumber	String	イメージの OS ビルドバージョン。たとえば、「 `1909` 」のように入力します。読み取り専用です。
osStatus	cloudPcDeviceImageOsStatus	このイメージの OS 状態。使用可能な値: `supported`、`supportedWithWarning`、`unknown`、`unknownFutureValue`。既定値は `unknown` です。読み取り専用です。
osVersionNumber	String	このイメージのオペレーティングシステムバージョン。たとえば、「 `10.0.22000.296` 」のように入力します。読み取り専用です。
sourceImageResourceId	String	Azure 上のソースイメージリソースの一意識別子 (ID)。必要な ID 形式は、"/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}" です。読み取り専用です。
status	cloudPcDeviceImageStatus	クラウド PC 上のイメージの状態。使用可能な値: `pending`、`ready`、`failed`、`unknownFutureValue`。読み取り専用です。
version	String	イメージのバージョン。たとえば、`0.0.1` および `1.5.13` などです。読み取り専用です。
statusDetails (非推奨)	cloudPcDeviceImageStatusDetails	アップロードが失敗した理由を示す画像の状態の詳細 (該当する場合)。可能な値は、`internalServerError`、`sourceImageNotFound`、`osVersionNotSupported`、`sourceImageInvalid`、`sourceImageNotGeneralized`、`unknownFutureValue`、`vmAlreadyAzureAdJoined`、`paidSourceImageNotSupport`、`sourceImageNotSupportCustomizeVMName`、`sourceImageSizeExceedsLimitation` です。この進化可能な列挙型から次の値を取得するには、`Prefer: include-unknown-enum-members`要求ヘッダーを使用する必要があることに注意してください。`vmAlreadyAzureAdJoined`、`paidSourceImageNotSupport`、`sourceImageNotSupportCustomizeVMName`、`sourceImageSizeExceedsLimitation`。読み取り専用です。 statusDetails プロパティは非推奨となり、2024 年 1 月 31 日にデータの返しを停止します。今後は、 errorCode プロパティを使用します。

cloudPcDeviceImageErrorCode 値

メンバー	説明
internalServerError	イメージの処理中に内部サーバーエラーが発生しました。
sourceImageNotFound	ソースイメージにアクセスできないか、見つかりません。
osVersionNotSupported	OS バージョンはサポートされていません。
sourceImageInvalid	ソースイメージは、Windows 仮想マシン (VM) をプロビジョニングするために無効です。
sourceImageNotGeneralized	アップロードされたイメージは一般化されていません。 sysprep/generalize コマンドを実行した後、イメージを再アップロードします。詳細については、「イメージを作成する前に VM のプロビジョニングを解除または一般化して、コンピューター固有の情報を削除する」を参照してください。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。
vmAlreadyAzureAdJoined	デバイスイメージを作成するためのソースイメージを生成する VM は、既にMicrosoft Entraに参加しています。これにより、検証プロセスでは、このようなソースイメージを使用してデバイスイメージを作成できなくなります。
paidSourceImageNotSupport	このソースイメージは、Azure Marketplaceの別の有料イメージから構築されており、サポートされていません。別のソースを使用して続行します。
sourceImageNotSupportCustomizeVMName	結果の一般化されたイメージにコンピューター名設定の問題が存在するため、指定されたイメージを使用して VM 名をカスタマイズできなくなります。
sourceImageSizeExceedsLimitation	お客様がアップロードしたソースイメージのサイズが、共有イメージギャラリー (SIG) の制限を超えているため、イメージの作成が失敗します。

cloudPcDeviceImageOsStatus 値

メンバー	説明
サポートされる	クラウド PC デバイスイメージオペレーティングシステムがアクティブであり、プロビジョニングに使用できる状態であることを示します。
supportedWithWarning	クラウド PC デバイスイメージオペレーティングシステムの有効期限が切れているが、クラウド PC が引き続きサポートされていることを示します。ユーザーが引き続き使用する場合、セキュリティ更新プログラムを入手できない可能性があります。
不明	既定値。クラウド PC デバイスのオペレーティングシステムイメージの状態が不明であることを示します。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。

cloudPcDeviceImageStatus 値

メンバー	説明
ペンディング	画像のアップロードが進行中です。
準備完了	クラウド PC でイメージを使用する準備ができました。
失敗しました	イメージのアップロードに失敗したことを示します。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。

cloudPcDeviceImageStatusDetails 値

メンバー	説明
internalServerError	イメージの処理中に内部サーバーエラーが発生しました。
sourceImageNotFound	ソースイメージにアクセスできないか、見つかりません。
osVersionNotSupported	OS バージョンはサポートされていません。
sourceImageInvalid	ソースイメージは、Windows 仮想マシン (VM) をプロビジョニングするために無効です。
sourceImageNotGeneralized	アップロードされたイメージは一般化されていません。 sysprep/generalize コマンドを実行した後、イメージを再アップロードします。詳細については、「イメージを作成する前に VM のプロビジョニングを解除または一般化して、コンピューター固有の情報を削除する」を参照してください。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。
vmAlreadyAzureAdJoined	デバイスイメージを作成するためのソースイメージを生成する VM は、既にMicrosoft Entraに参加しています。これにより、検証プロセスでは、このようなソースイメージを使用してデバイスイメージを作成できなくなります。
paidSourceImageNotSupport	このソースイメージは、Azure Marketplaceの別の有料イメージから構築されており、サポートされていません。別のソースを使用して続行します。
sourceImageNotSupportCustomizeVMName	結果の一般化されたイメージにコンピューター名設定の問題が存在するため、指定されたイメージを使用して VM 名をカスタマイズできなくなります。
sourceImageSizeExceedsLimitation	お客様がアップロードしたソースイメージのサイズが、共有イメージギャラリー (SIG) の制限を超えているため、イメージの作成が失敗します。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@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"
}

次の方法で共有