cloudPC: getProvisionedCloudPCs
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Получите все подготовленные облачные компьютеры определенного плана обслуживания для пользователей в группе пользователей Microsoft Entra.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | CloudPC.Read.All | CloudPC.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | CloudPC.Read.All | CloudPC.ReadWrite.All |
HTTP-запрос
GET /deviceManagement/virtualEndpoint/cloudPCs/getProvisionedCloudPCs(groupId='{groupId}',servicePlanId='{servicePlanId}')
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Параметр запроса
Параметр | Тип | Описание |
---|---|---|
groupId | String | Уникальный идентификатор для Microsoft Entra группы пользователей. |
servicePlanId | String | Уникальный идентификатор плана обслуживания. |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK
и коллекцию cloudPC в тексте отклика.
Примеры
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/getProvisionedCloudPCs(groupId='30d0e128-de93-41dc-89ec-33d84bb662a0',servicePlanId='9ecf691d-8b82-46cb-b254-cd061b2c02fb')
Отклик
Ниже приводится пример отклика.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.cloudPC",
"id": "662009bc-7732-4f6f-8726-25883518b33e",
"displayName": "Demo-0",
"imageDisplayName": "Windows-10 19h1-evd",
"aadDeviceId": "f5ff445f-7488-40f8-8ab9-ee784a9c1f33",
"diskEncryptionState": "encryptedUsingCustomerManagedKey",
"managedDeviceId": "bdc8e6dd-0455-4412-83d9-c818664fe1f1",
"managedDeviceName": "CPC-ps1-SHYL-46",
"provisioningPolicyId": "7ed725ad-0a00-4117-b557-d965c3732450",
"servicePlanId": "9ecf691d-8b82-46cb-b254-cd061b2c02fb",
"servicePlanName": "Cloud PC Enterprise 4vCPU/16GB/256GB",
"servicePlanType": "enterprise",
"status": "provisioned",
"powerState": "running",
"userPrincipalName": "pmitchell@contoso.com",
"lastModifiedDateTime": "2020-07-23T10:29:57Z",
"statusDetails": null,
"provisioningType": "dedicated",
"allotmentDisplayName": null,
"deviceRegionName": "eastus2",
"connectivityResult": "",
"gracePeriodEndDateTime": null,
"lastLoginResult": "2020-07-23T10:29:57Z",
"lastRemoteActionResult": "Succeed",
"onPremisesConnectionName": "Test-OPNC",
"osVersion": null,
"partnerAgentInstallResults": null,
"provisioningPolicyName": "Test-Policy",
"userAccountType": null
},
{
"@odata.type": "#microsoft.graph.cloudPC",
"id": "ac74ae8b-85f7-4272-88cc-5419267403ed",
"displayName": "Demo-1",
"imageDisplayName": "Custom image name",
"aadDeviceId": "61289490-ef06-4962-8f49-455329c8893c",
"diskEncryptionState": "encryptedUsingCustomerManagedKey",
"managedDeviceId": "e87f50c7-fa7f-4687-aade-dd45f3d65970",
"managedDeviceName": "CPC-ps2-7ERZ-QE",
"provisioningPolicyId": "13fa0778-ba00-438a-96d3-488c86029dff",
"servicePlanId": "9ecf691d-8b82-46cb-b254-cd061b2c02fb",
"servicePlanName": "Cloud PC Enterprise 4vCPU/16GB/256GB",
"servicePlanType": "enterprise",
"status": "provisioned",
"powerState": "running",
"userPrincipalName": "pmitchell@contoso.com",
"lastModifiedDateTime": "2020-07-28T18:14:34Z",
"statusDetails": null,
"provisioningType": "dedicated",
"allotmentDisplayName": null,
"deviceRegionName": "eastus2",
"connectivityResult": "",
"gracePeriodEndDateTime": null,
"lastLoginResult": "2020-07-23T10:29:57Z",
"lastRemoteActionResult": "Succeed",
"onPremisesConnectionName": "Test-OPNC",
"osVersion": null,
"partnerAgentInstallResults": null,
"provisioningPolicyName": "Test-Policy",
"userAccountType": null
}
]
}
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по