cloudPC: getFrontlineCloudPcAccessState
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.
Obtenha a linha de frenteCloudPcAccessState de um pc de nuvem de linha de frente.
Essa API só dá suporte a licenças de uso compartilhado. Para obter mais informações, consulte cloudPcProvisioningPolicy. As licenças de uso compartilhado permitem três usuários por licença, com um usuário conectado por vez. Os chamadores podem obter o mais recente front-frontline Cloud PC accessState e determinar se o pc de nuvem de linha de frente está acessível a um usuário.
Se um cliente Web precisar se conectar a um pc de nuvem de linha de frente, o CloudPcAccessState compartilhado valida o cenário de indicador. Se sharedCloudPcAccessState não estiver ativo/ativado/standbyMode, o cliente Web mostrará um indicador ruim.
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, CloudPC.ReadWrite |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | CloudPC.Read.All. | CloudPC.ReadWrite.All. |
Solicitação HTTP
Para obter o estado de acesso do pc na nuvem de linha de frente do usuário conectado usando a permissão delegada:
GET /me/cloudPCs/{cloudPCId}/getFrontlineCloudPcAccessState
Para obter o estado de acesso do PC na nuvem de linha de frente de um administrador conectado usando permissão delegada ou permissão de aplicativo:
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getFrontlineCloudPcAccessState
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 frontlineCloudPcAccessState no corpo da resposta.
Se o CLOUD PC foi provisionado como um dispositivo dedicado, esse método retornará um código de 400 Bad Request
resposta.
Exemplos
Exemplo 1: obter o estado de acesso do PC na nuvem de linha de frente para o usuário conectado
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/me/cloudPCs/b0a9cde2-e170-4dd9-97c3-ad1d3328a711/getFrontlineCloudPcAccessState
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context":"https://graph.microsoft.com/beta/$metadata#Edm.String",
"value": "noLicensesAvailable"
}
Exemplo 2: obter o estado de acesso do PC na nuvem de linha de frente para o administrador
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/b0a9cde2-e170-4dd9-97c3-ad1d3328a711/getFrontlineCloudPcAccessState
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context":"https://graph.microsoft.com/beta/$metadata#Edm.String",
"value": "noLicensesAvailable"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de