名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
サインインしているユーザーがアクセスできる cloudPcPool オブジェクトのプロパティとリレーションシップを読み取ります。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | CloudPC.ReadWrite | CloudPC.Read.All、CloudPC.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | サポートされていません。 | サポートされていません。 |
HTTP 要求
GET /me/cloudPcPools/{cloudPcPool-id}
オプションのクエリ パラメーター
このメソッドは、応答のカスタマイズに役立つ OData クエリ パラメーター をサポートしていません。
パス パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| cloudPcPool-id | 文字列 | クラウド PC プールの一意の識別子。 |
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文に cloudPcPool オブジェクトを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/beta/me/cloudPcPools/a1b2c3d4-e5f6-7890-abcd-ef1234567890
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.cloudPcAgentPool",
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"displayName": "Contoso Development Pool",
"description": "A Cloud PC Pool for development agents",
"cloudPcConfiguration": {
"imageId": "microsoftwindowsdesktop_windows-ent-cpc_win11-23h2-ent-cpc-m365",
"imageType": "gallery",
"osLocale": "en-US",
"imageDisplayName": "Windows 11 Enterprise + Microsoft 365 Apps 23H2"
},
"networkConfiguration": {
"@odata.type": "#microsoft.graph.cloudPcMicrosoftHostedNetworkConfiguration",
"geographicLocationType": "usWest",
"regionGroups": [
{
"regionGroup": "usWest",
"regions": ["westus2", "westus3"]
}
]
},
"billingConfiguration": {
"billingType": "payAsYouGo",
"billingPlanId": "00000000-0000-0000-0000-000000000001"
},
"scalingPolicy": {
"minimumCount": 2,
"maximumCount": 10
},
"capabilities": {
"enableSingleSignOn": true
},
"sessionUsage": {
"activeSessionsCount": 3,
"availableSessionsCount": 5
},
"poolUrl": "https://westus2.sessionmanagement.regional.cloudinferenceplatform.azure.com/sessions",
"createdDateTime": "2026-01-15T10:00:00Z",
"lastModifiedDateTime": "2026-01-20T14:30:00Z"
}