次の方法で共有


cloudPcDeviceImage リソースの種類

名前空間: 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 アップロードが失敗した理由 (該当する場合) を示すイメージの状態のエラー コード。 可能な値は、internalServerErrorsourceImageNotFoundosVersionNotSupportedsourceImageInvalidsourceImageNotGeneralizedunknownFutureValuevmAlreadyAzureAdJoinedpaidSourceImageNotSupportsourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation です。 この進化可能な列挙型から次の値を取得するには、Prefer: include-unknown-enum-members要求ヘッダーを使用する必要があることに注意してください。vmAlreadyAzureAdJoinedpaidSourceImageNotSupportsourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation。 読み取り専用です。
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 状態。 使用可能な値: supportedsupportedWithWarningunknownunknownFutureValue。 既定値は 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 上のイメージの状態。 使用可能な値: pendingreadyfailedunknownFutureValue。 読み取り専用です。
version String イメージのバージョン。 たとえば、0.0.1 および 1.5.13 などです。 読み取り専用です。
statusDetails (非推奨) cloudPcDeviceImageStatusDetails アップロードが失敗した理由を示す画像の状態の詳細 (該当する場合)。 可能な値は、internalServerErrorsourceImageNotFoundosVersionNotSupportedsourceImageInvalidsourceImageNotGeneralizedunknownFutureValuevmAlreadyAzureAdJoinedpaidSourceImageNotSupportsourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation です。 この進化可能な列挙型から次の値を取得するには、Prefer: include-unknown-enum-members要求ヘッダーを使用する必要があることに注意してください。vmAlreadyAzureAdJoinedpaidSourceImageNotSupportsourceImageNotSupportCustomizeVMNamesourceImageSizeExceedsLimitation。 読み取り専用です。 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"
}