Compartilhar via


Atualizar o ApprovalStage

Namespace: microsoft.graph

Aprovar ou negar um objeto approvalStage em uma aprovação.

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

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Permissões necessárias para chamar essa API para gerenciamento de direitos

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) EntitlementManagement.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sem suporte.

Permissões necessárias para chamar essa API para PIM para grupos

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sem suporte.

Solicitação HTTP

Para atualizar uma decisão de aprovação no gerenciamento de direitos:

PATCH /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{accessPackageAssignmentRequestId}/stages/{approvalStageId}

Para atualizar uma decisão de aprovação no PIM para grupos:

PATCH /identityGovernance/privilegedAccess/group/assignmentApprovals/{privilegedaccessgroupassignmentschedulerequestId}/stages/{approvalStageId}

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

A tabela a seguir mostra as propriedades necessárias para esse método.

Propriedade Tipo Descrição
reviewResult Cadeia de caracteres Decisão do aprovador. Os valores possíveis são: Approve e Deny. Obrigatório.
Justificação Cadeia de caracteres Justificativa relacionada à decisão do aprovador.

Resposta

Se for bem-sucedido, esse método retornará um 204 No Content código de resposta no corpo da resposta. Se o chamador não tiver as permissões certas, o método retornará um código de 403 Forbidden resposta ou se a ID de aprovação não for encontrada, o método retornará 404 Not found. Se a solicitação já tiver sido aprovada por outro aprovador no mesmo estágio de aprovação, o método retornará 409 Conflict o código de resposta.

Exemplos

Solicitação

PATCH https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/abd306ef-f7b2-4a10-9fd1-493454322489/stages/d4fa4045-4716-436d-aec5-57b0a713f095

{
 "reviewResult":"Approve",
 "justification":"OK"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content