cloudPC:getProvisionedCloudPC
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
为Microsoft Entra用户组下的用户获取特定服务计划的所有预配云电脑。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | CloudPC.Read.All | CloudPC.ReadWrite.All |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | CloudPC.Read.All | CloudPC.ReadWrite.All |
HTTP 请求
GET /deviceManagement/virtualEndpoint/cloudPCs/getProvisionedCloudPCs(groupId='{groupId}',servicePlanId='{servicePlanId}')
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {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,
"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,
"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 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈