Atualizar approverDelegate

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