Dispositivo: provisionar

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.

Provisione um dispositivo em nome de um provedor de VDI (Virtual Desktop Infrastructure aprovado).

Essa ação encapsula o protocolo ZTD (Zero Touch Deployment) para criar um dispositivo em um estado pendente no diretório do cliente. O dispositivo não pode ser usado para autenticação até que ele conclua seu registro. O dispositivo criado é carimbado com uma etiqueta do sistema que identifica o provedor VDI aprovado.

Somente aplicativos VDI na lista aprovada de provedores VDI da Microsoft podem chamar essa ação com êxito. As chamadas de outros aplicativos são bloqueadas mesmo quando o aplicativo recebe a permissão necessária.

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) Device.ProvisionForVDI Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Importante

Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. O Administrador de Dispositivo de Nuvem é a função com menos privilégios com suporte para essa operação.

Além da permissão, o aplicativo de chamada deve estar na lista aprovada da Microsoft de provedores de VDI.

Solicitação HTTP

POST /devices/provision

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON dos parâmetros.

A tabela a seguir mostra os parâmetros que você pode usar com essa ação.

Parâmetro Tipo Descrição
provisioningBlob Cadeia de caracteres Um blob opaco, gerado pela biblioteca de runtime de identidade do dispositivo do Microsoft Entra e compartilhado com provedores VDI aprovados, que contém as informações necessárias para provisionar o dispositivo. Obrigatório.

Resposta

Se for bem-sucedida, essa ação retornará um código de 201 Created resposta e um provisionResponse no corpo da resposta. A resposta também inclui um Location cabeçalho que contém o URI do objeto de dispositivo criado.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/devices/provision
Content-Type: application/json

{
  "provisioningBlob": "eyJ2ZXIiOiIxLjAiLCJub25jZSI6IjJkZjg1ZTdmYTk0ZjQ3In0"
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.provisionResponse",
  "challenge": "Y2hhbGxlbmdlVmFsdWVFeGFtcGxl",
  "deviceId": "2ec25e3b-9243-4f3c-8c83-2e2a9b8a4f1a"
}
  • Última atualização em