Obter cloudPC
Namespace: microsoft.graph
Leia as propriedades e as relações de um objeto cloudPC específico.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | CloudPC.Read.All | CloudPC.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | CloudPC.Read.All | CloudPC.ReadWrite.All |
Solicitação HTTP
Para obter o cloudPC especificado na organização, usando a permissão delegada (o usuário conectado deve ser o administrador) ou a permissão do aplicativo:
GET /deviceManagement/virtualEndpoint/cloudPCs/{id}
Parâmetros de consulta opcionais
Esse método dá suporte ao $select
parâmetro de consulta OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e um objeto cloudPC no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação para obter as propriedades padrão de um PC na Nuvem.
GET https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/9ec90ff8-fd63-4fb9-ab5a-aa4fdcc43ec9
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.cloudPC",
"aadDeviceId": "f5ff445f-7488-40f8-8ab9-ee784a9c1f33",
"id": "ac74ae8b-85f7-4272-88cc-54192674ffff",
"displayName": "Demo-0",
"imageDisplayName": "Windows-10 19h1-evd",
"managedDeviceId": "e87f50c7-fa7f-4687-aade-dd45f3d6ffff",
"managedDeviceName": "A00002GI001",
"provisioningPolicyId": "13fa0778-ba00-438a-96d3-488c8602ffff",
"provisioningPolicyName": "Marketing provisioning policy",
"onPremisesConnectionName": "Azure network connection for Marketing",
"servicePlanId": "da5615b4-a484-4742-a019-2d52c91cffff",
"servicePlanName": "standard",
"userPrincipalName": "pmitchell@contoso.com",
"lastModifiedDateTime": "2020-11-03T18:14:34Z",
"gracePeriodEndDateTime": "2020-11-010T20:00:34Z",
"provisioningType": "shared"
}