名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
クラウド PC のプロビジョニングに使用できる現在のorganizationのギャラリー イメージ リソースを表します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | cloudPcGalleryImage コレクション | cloudPcGalleryImage オブジェクトのプロパティとリレーションシップを一覧表示します。 |
| Get | cloudPcGalleryImage | 特定の cloudPcGalleryImage オブジェクトのプロパティとリレーションシップを読み取ります。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| displayName | 文字列 | このギャラリー イメージの表示名。 たとえば、「 Windows 11 Enterprise + Microsoft 365 Apps 22H2 」のように入力します。 読み取り専用です。 |
| endDate | Date | イメージの状態が supportedWithWarningになる日付。 現在の時刻が endDate より後で expirationDate より前の場合でも、ユーザーは新しいクラウド PC をプロビジョニングできます。 たとえば、ギャラリー イメージの endDate が 2023-9-14 され、 expirationDate が 2024-3-14されると、現在が 2023-10-01 の場合、ユーザーは新しいクラウド PC をプロビジョニングできます。 読み取り専用です。 |
| expirationDate | Date | イメージが使用できなくなった日付。 現在の時刻が expirationDate より後の場合、ユーザーは新しいクラウド PC をプロビジョニングできません。 値は通常 、endDate と 6 か月です。 たとえば、 startDate が 2025-10-14されている場合、 expirationDate は通常 2026-04-14。 読み取り専用です。 |
| id | 文字列 | Cloud PC 上のギャラリー イメージ リソースの一意識別子 (ID)。 ID 形式は {publisherName_offerName_skuName} です。 たとえば、「 MicrosoftWindowsDesktop_windows-ent-cpc_win11-22h2-ent-cpc-m365 」のように入力します。
publisherName、offerName、skuName は、Azure Marketplace にあります。 読み取り専用です。 |
| offerName | 文字列 | イメージ リソースを取得するために ARM に渡されるこのギャラリー イメージのオファー名。 読み取り専用です。 |
| osVersionNumber | 文字列 | このギャラリー イメージのオペレーティング システム バージョン。 たとえば、「 10.0.22000.296 」のように入力します。 読み取り専用です。 |
| publisherName | String | イメージ リソースを取得するために ARM に渡される、このギャラリー イメージの発行元名。 読み取り専用です。 |
| sizeInGB | Int32 | このイメージのサイズをギガバイト単位で示します。 たとえば、「 64 」のように入力します。 読み取り専用です。 |
| skuName | 文字列 | イメージ リソースを取得するために ARM に渡されるこのイメージの SKU 名。 読み取り専用です。 |
| startDate | Date | クラウド PC イメージを新しいクラウド PC のプロビジョニングに使用できる日付。 たとえば、「 2022-09-20 」のように入力します。 読み取り専用です。 |
| status | cloudPcGalleryImageStatus | クラウド PC 上のギャラリー イメージの状態。 使用可能な値: supported、supportedWithWarning、notSupported、unknownFutureValue。 既定値は supported です。 読み取り専用です。 |
| オファー (非推奨) | 文字列 | イメージ リソースを取得するために ARM に渡されるこのギャラリー イメージのオファー名。 読み取り専用です。 オファー プロパティは非推奨であり、2024 年 1 月 31 日にデータの返しを停止します。 今後は、 offerName プロパティを使用します。 |
| offerDisplayName (非推奨) | 文字列 | このギャラリー イメージの公式表示オファー名。 たとえば、「 Windows 11 Enterprise 」のように入力します。
offerDisplayName プロパティは非推奨となり、2024 年 1 月 31 日にデータの返しを停止します。 |
| publisher (非推奨) | 文字列 | イメージ リソースを取得するために ARM に渡される、このギャラリー イメージの発行元名。 読み取り専用です。 publisher プロパティは非推奨であり、2024 年 1 月 31 日にデータの返しを停止します。 今後は、 publisherName プロパティを使用します。 |
| recommendedSku (非推奨) | 文字列 | このギャラリー イメージに推奨されるクラウド PC SKU。 読み取り専用です。 recommendedSku プロパティは非推奨であり、2024 年 1 月 31 日にデータの返しを停止します。 |
| sku (非推奨) | 文字列 | イメージ リソースを取得するために ARM に渡されるこのイメージの SKU 名。 読み取り専用です。 sku プロパティは非推奨であり、2024 年 1 月 31 日にデータの返しを停止します。 今後は、 skuName プロパティを使用します。 |
| skuDisplayName (非推奨) | 文字列 | このギャラリー イメージの公式表示 SKU 名。 たとえば、「 2004 」のように入力します。 読み取り専用です。
skuDisplayName プロパティは非推奨となり、2024 年 1 月 31 日にデータの返しを停止します。 |
cloudPcGalleryImageStatus 値
| メンバー | 説明 |
|---|---|
| サポートされる | ギャラリー イメージはアクティブであり、プロビジョニングに使用する準備が整いました。 |
| supportedWithWarning | ギャラリー イメージの有効期限は切れていますが、クラウド PC は 6 か月間サポートを継続し、その後はサポートされ、使用できなくなります。 |
| notSupported | ギャラリー イメージはサポート対象外です。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.cloudPcGalleryImage",
"displayName": "String",
"endDate": "String (Date)",
"expirationDate": "String (Date)",
"id": "String (identifier)",
"offer": "String",
"offerDisplayName": "String",
"offerName": "String",
"osVersionNumber": "String",
"publisher": "String",
"publisherName": "String",
"recommendedSku": "String",
"sizeInGB": "Int32",
"sku": "String",
"skuDisplayName": "String",
"skuName": "String",
"startDate": "String (Date)",
"status": "String"
}