Adicionar patrocinador
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.
Atribuir um patrocinador a um utilizador. Os patrocinadores são utilizadores e grupos responsáveis pelos privilégios deste utilizador convidado no inquilino e por manter as informações e o acesso do utilizador convidado atualizados.
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) | User.ReadWrite.All | Directory.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | User.ReadWrite.All | Directory.ReadWrite.All |
Importante
Em cenários delegados com contas escolares ou profissionais, tem de ser atribuída ao utilizador com sessão iniciada uma função de Microsoft Entra suportada ou uma função personalizada com a permissão de microsoft.directory/users/sponsors/update
função. As seguintes funções com menos privilégios são suportadas para esta operação:
- Escritores de diretório
- Administrador do usuário
Solicitação HTTP
POST /users/{id}/sponsors/$ref
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 do pedido, forneça um objeto JSON e transmita um @odata.id
parâmetro com o URL de leitura do objeto de utilizador ou grupo a adicionar.
Resposta
Se bem sucedido, este método retorna um código de resposta 204 No Content
. Não devolve nada no corpo da resposta.
Exemplos
Exemplo 1: Atribuir um utilizador como patrocinador
Solicitação
O exemplo a seguir mostra uma solicitação. O corpo do pedido é um objeto JSON com um @odata.id
parâmetro e o URL de leitura para o objeto de utilizador ser atribuído como patrocinador.
POST https://graph.microsoft.com/beta/users/d8ab5060-f636-4cff-ae97-d4687f5c83f3/sponsors/$ref
Content-Type: application/json
{
"@odata.id": "https://graph.microsoft.com/beta/users/{user-id}"
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content
Exemplo 2: Atribuir um grupo como patrocinador
Solicitação
O exemplo a seguir mostra uma solicitação. O corpo do pedido é um objeto JSON com um @odata.id
parâmetro e o URL de leitura para o objeto de grupo ser atribuído como patrocinador.
POST https://graph.microsoft.com/beta/users/d8ab5060-f636-4cff-ae97-d4687f5c83f3/sponsors/$ref
Content-Type: application/json
{
"@odata.id": "https://graph.microsoft.com/beta/groups/{group-id}"
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content