Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. 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.
Crie ou substitua o objeto approverDelegate configurado para um usuário. O representante aprovador pode aprovar ou negar o gerenciamento de direitos do Microsoft Entra, solicitações de atribuição de pacote de acesso e revisões de acesso em nome do usuário pelo período especificado na agenda.
A delegação se aplica a todas as solicitações de atribuição de pacote de acesso e revisões de acesso atribuídas ao usuário. Enquanto a delegação estiver em vigor, o usuário ainda poderá aprovar ou negar seus próprios itens pendentes.
Os usuários conectados podem definir seu próprio representante de aprovador. Os administradores podem definir o representante do aprovador de qualquer usuário no locatário.
Como esse método é uma PUT operação, o corpo da solicitação substitui o representante do aprovador existente. Para interromper uma delegação, envie um novo representante aprovador com uma agenda que já expirou.
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) | EntitlementManagement.ReadWrite.All | 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 Governança de Identidade é a função com menos privilégios com suporte para esta operação.
Nenhuma função de diretório é necessária para definir seu próprio representante de /me aprovador pelo caminho.
Solicitação HTTP
Para definir o representante do aprovador do usuário conectado:
PUT /me/identityGovernance/approverDelegate
Para definir o representante do aprovador de outro usuário:
PUT /users/{user-id}/identityGovernance/approverDelegate
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 do objeto approverDelegate .
A tabela a seguir mostra as propriedades que você pode usar ao definir um representante aprovador.
| Propriedade | Tipo | Descrição |
|---|---|---|
| representante | userSet | O usuário ou grupo que recebe a delegação de aprovação. Especifique a @odata.type propriedade para identificar o subtipo. Há suporte apenas para os subtipos singleUser e groupMembers . Obrigatório. |
| Cronograma | requestSchedule | O período durante o qual a delegação está em vigor. Se você não especificar um agendamento, a delegação começará imediatamente e não expirará. Opcional. |
Resposta
Se tiver êxito, este método retornará um código de resposta 204 No Content. Ele não retorna nada no corpo da resposta.
Erros
Esse método retorna o seguinte erro quando o representante não é um subtipo userSet com suporte ou quando o representante não pode ser resolvido.
| Código de status de HTTP | Código de erro | Mensagem de erro |
|---|---|---|
| 400 | Request_BadRequest | Representante do aprovador inválido ou sem suporte. |
Exemplos
Exemplo 1: Definir um usuário como o representante aprovador do usuário conectado
Solicitação
O exemplo a seguir delega aprovações a um único usuário por uma semana.
PUT https://graph.microsoft.com/beta/me/identityGovernance/approverDelegate
Content-type: application/json
{
"delegate": {
"@odata.type": "#microsoft.graph.singleUser",
"id": "d8f4bcd2-4d5a-4a1e-88a5-b0f1c98d2f27"
},
"schedule": {
"startDateTime": "2026-08-31T08:21:41.338Z",
"expiration": {
"endDateTime": "2026-09-07T08:21:41.339Z",
"type": "afterDateTime"
}
}
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content
Exemplo 2: Definir um grupo como o representante aprovador de outro usuário
Solicitação
O exemplo a seguir delega aprovações para outro usuário aos membros de um grupo, sem expiração.
PUT https://graph.microsoft.com/beta/users/87ec4b08-df41-4e9c-8f0c-2e6c9e19b0d3/identityGovernance/approverDelegate
Content-type: application/json
{
"delegate": {
"@odata.type": "#microsoft.graph.groupMembers",
"id": "1c5f0b3e-8d4a-4e39-9f2b-6a7c1d3e5f80"
},
"schedule": {
"startDateTime": "2026-08-31T08:21:41.338Z",
"expiration": {
"type": "noExpiration"
}
}
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content