Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Cuidado
- Os
/me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfopontos de extremidade e/users/{userId}/cloudPCs/{id}/getCloudPcLaunchInfoestão obsoletos e deixarão de retornar dados em 30 de outubro de 2026. - O
/deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getCloudPcLaunchInfoponto de extremidade foi preterido e deixará de retornar dados em 18 de junho de 2026. - No futuro, use a API retrieveCloudPcLaunchDetail .
Obtenha o cloudPCLaunchInfo para um cloudPC específico que pertence ao usuário conectado atual.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ❌ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | CloudPC.Read.All | CloudPC.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | Sem suporte. | Sem suporte. |
Solicitação HTTP
Para obter o cloudPCLaunchInfo para um cloudPC específico do usuário especificado (que é o usuário conectado) na organização usando a permissão delegada:
GET /me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo
GET /users/{userId}/cloudPCs/{id}/getCloudPcLaunchInfo
Para obter o cloudPCLaunchInfo para um cloudPC específico na organização usando a permissão delegada (o usuário conectado deve ser o administrador):
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo
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-sucedida, essa função retornará um código de 200 OK resposta e um objeto cloudPcLaunchInfo no corpo da resposta.
Exemplos
Solicitação
GET https://graph.microsoft.com/beta/me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo
Resposta
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.cloudPcLaunchInfo",
"cloudPcId": "a20d556d-85f7-88cc-bb9c-08d9902bb7bb",
"cloudPcLaunchUrl": "https://rdweb-r0.wvdselfhost.microsoft.com/api/arm/weblaunch/tenants/662009bc-7732-4f6f-8726-25883518b33e/resources/662009bc-7732-4f6f-8726-25883518b33e",
"windows365SwitchCompatible":false,
"windows365SwitchNotCompatibleReason":"CPCHardwareNotMeetRequirement"
}