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
Esta API foi preterida e deixará de devolver dados a 30 de outubro de 2026. No futuro, utilize a API retrieveCloudPcLaunchDetail .
Obtenha o cloudPCLaunchInfo para um cloudPC específico que pertence ao utilizador com sessão iniciada atual.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| 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 utilizador especificado (que é o utilizador com sessão iniciada) na organização com 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 com permissão delegada (o utilizador com sessão iniciada deve ser o administrador):
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo
Cuidado
O /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo ponto final foi preterido e deixará de devolver dados a 30 de outubro de 2025.
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, esta função devolve um 200 OK código de 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"
}