Share via


Atualizar accessReviewInstanceDecisionItem

Namespace: microsoft.graph

Atualize as decisões de acesso, conhecidas como accessReviewInstanceDecisionItems, para as quais o usuário é o revisor.

Observação

Todas as atualizações feitas em um accessReviewInstanceDecisionItem só podem ser feitas chamando usuários listados como revisores para o acesso paiReviewInstance.

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

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas
Delegado (conta corporativa ou de estudante) AccessReview.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

Para atualizar uma decisão sobre um accessReviewInstance:

PATCH /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/decisions/{accessReviewInstanceDecisionItemId}

Para atualizar uma decisão em um estágio de um accessReviewInstance que tem vários estágios:

PATCH /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/stages/{accessReviewStageId}/decisions/{accessReviewInstanceDecisionItemId}

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

A tabela a seguir mostra as propriedades aceitas para atualizar um accessReviewInstanceDecisionItem.

Propriedade Tipo Descrição
Decisão Cadeia de caracteres Decisão de acesso para a entidade que está sendo revisada. Os valores possíveis são: ApproveNotReviewedDenyDontKnow. Obrigatório.
Justificação Cadeia de caracteres Contexto da revisão fornecida aos administradores. Necessário se a justificativaRequiredOnApproval for True no accessReviewScheduleDefinition.

Resposta

Se for bem-sucedido, esse método retornará um código de 204 No Content resposta e nenhum corpo de resposta.

Exemplos

Exemplo 1: atualizar uma decisão sobre um accessReviewInstance

Solicitação

A seguir está um exemplo de uma decisão de aprovar o acesso para um usuário.

PATCH https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/5eac5a70-7cd7-4f20-92b0-f9dba70dd7f0/instances/6444d4fd-ab55-4608-8cf9-c6702d172bcc/stages/9458f255-dff2-4d86-9a05-69438f49d7f8/decisions/e6cafba0-cbf0-4748-8868-0810c7f4cc06
Content-Type: application/json

{
  "decision": "Approve",
  "justification": "This person is still on my team",
}

Resposta

HTTP/1.1 204 Accepted

Exemplo 2: atualizar uma decisão em um estágio em uma revisão de acesso em vários estágios

Solicitação

PATCH https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/5eac5a70-7cd7-4f20-92b0-f9dba70dd7f0/instances/6444d4fd-ab55-4608-8cf9-c6702d172bcc/stages/9458f255-dff2-4d86-9a05-69438f49d7f8/decisions/e6cafba0-cbf0-4748-8868-0810c7f4cc06
Content-Type: application/json

{
  "decision": "Approve",
  "justification": "This person is still on my team",
}

Resposta

HTTP/1.1 204 Accepted