Share via


accessReviewInstance: batchRecordDecisions

Namespace: microsoft.graph

Permite que os revisores examinem todos os objetos accessReviewInstanceDecisionItem em lotes usando principalId, resourceId ou nenhum deles.

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.
Application AccessReview.ReadWrite.All Indisponível.

Para cenários delegados, o usuário conectado deve ter pelo menos uma das seguintes funções de Microsoft Entra.

Gravar revisões de acesso de um grupo ou aplicativo Escrever revisões de acesso de uma função de Microsoft Entra
Administrador do usuário
Administrador de Governança de Identidade
Administrador de funções privilegiadas do administrador
de governança de identidade

Solicitação HTTP

POST /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/batchRecordDecisions

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 de um accessReviewInstanceDecisionItem.

A tabela a seguir lista as propriedades que você pode usar para examinar objetos accessReviewInstanceDecisionItem .

Parâmetro 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: Approve, Deny, NotReviewed, DontKnow. Obrigatório.
Justificação Cadeia de caracteres Contexto da revisão fornecida aos administradores. Necessário se a justificativaRequiredOnApproval da propriedade configurações do accessReviewScheduleDefinition for true .
principalId Cadeia de caracteres Se fornecido, todos os accessReviewInstanceDecisionItems com valores principalId correspondentes serão revisados neste lote. Se não for fornecido, todos os accessReviewInstanceDecisionItems serão revisados .
resourceId Cadeia de caracteres Se fornecido, todos os accessReviewInstanceDecisionItems com resourceId correspondente serão revisados neste lote. Se não for fornecido, todos os accessReviewInstanceDecisionItems serão revisados .

Resposta

Se tiver êxito, esta ação retornará um código de resposta 204 No Content.

Exemplos

Solicitação

POST https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/e6cafba0-cbf0-4748-8868-0810c7f4cc06/instances/1234fba0-cbf0-6778-8868-9999c7f4cc06/batchRecordDecisions
Content-type: application/json

{
  "decision": "Approve",
  "justification": "All principals with access need continued access to the resource (Marketing Group) as all the principals are on the marketing team",
  "resourceId": "a5c51e59-3fcd-4a37-87a1-835c0c21488a"
}

Resposta

HTTP/1.1 204 No Content