tipo de recurso accessReview (preterido)

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.

Cuidado

Esta versão da API de revisão de acesso está preterida e deixará de retornar dados em 19 de maio de 2023. Use a API de revisões de acesso.

Representa uma revisão de acesso Microsoft Entra.

Métodos

Método Tipo de retorno Descrição
Listar accessReviews coleção accessReview Listar accessReviews para um businessFlowTemplate.
Obter accessReview accessReview Obtenha uma revisão de acesso com uma ID específica.
Criar accessReview accessReview Criar um novo accessReview.
Atualizar accessReview accessReview Atualizar um accessReview.
Excluir accessReview Nenhuma. Excluir um accessReview.
Revisores do AccessReview de lista coleção userIdentity Obtenha os revisores de um accessReview.
Adicionar revisor accessReview Nenhuma. Adicione um revisor a um accessReview.
Remover o revisor accessReview Nenhuma. Remova um revisor de um accessReview.
List accessReview decisions coleção accessReviewDecision Obtenha as decisões de um accessReview.
Listar minhas decisões do accessReview coleção accessReviewDecision Como revisor, obtenha minhas decisões de um accessReview.
Enviar lembrete accessReview Nenhuma. Envie um lembrete para os revisores de um accessReview.
Interromper o accessReview Nenhuma. Parar um accessReview.
Redefinir as decisões do accessReview Nenhuma. Redefinir as decisões em um access em andamentoReview.
Aplicar decisões accessReview Nenhuma. Aplique as decisões de um accessReview concluído.

Propriedades

Propriedade Tipo Descrição
id Cadeia de caracteres O identificador exclusivo atribuído pelo recurso de uma revisão de acesso.
displayName Cadeia de caracteres O nome da revisão de acesso. Obrigatório durante a criação.
startDateTime DateTimeOffset A data e a hora em que a revisão está agendada para ser iniciada. Essa data pode ser no futuro. Obrigatório durante a criação.
endDateTime DateTimeOffset O DateTime quando a revisão está agendada para terminar. Isso deve ser pelo menos um dia depois da data de início. Obrigatório durante a criação.
status Cadeia de caracteres Este campo somente leitura especifica o status de um accessReview. Os estados típicos incluem Initializing, NotStarted, Starting,InProgress, Completing, Completed, , AutoReviewinge AutoReviewed.
description Cadeia de caracteres A descrição fornecida pelo criador da revisão de acesso, para mostrar aos revisores.
businessFlowTemplateId Cadeia de caracteres O identificador de modelo de fluxo de negócios. Obrigatório durante a criação. Esse valor é sensível a maiúsculas de minúsculas.
reviewerType Cadeia de caracteres O tipo de relação do revisor para o objeto de destino, um de: self, delegated, entityOwners. Obrigatório durante a criação.
createdBy userIdentity O usuário que criou essa revisão.
entidade revisada identity O objeto para o qual a revisão de acesso está revisando as atribuições de direitos de acesso. Essa identidade pode ser o grupo para a revisão de associações de usuários em um grupo ou o aplicativo para uma revisão das atribuições dos usuários a um aplicativo. Obrigatório durante a criação.
settings accessReviewSettings As configurações de um accessReview, confira definição de tipo abaixo.

Relações

Relação Tipo Descrição
Revisores coleção userIdentity A coleção de revisores para uma revisão de acesso, se o revisor de revisão de acessoType for do tipo delegated.
Decisões coleção accessReviewDecision A coleção de decisões para essa revisão de acesso.
myDecisions coleção accessReviewDecision A coleção de decisões para o chamador, se o chamador for um revisor.
instances coleção accessReview A coleção de acesso examinará instâncias passadas, presentes e futuras, se esse objeto for uma revisão de acesso recorrente.

Se essas relações estão presentes em um objeto, depende se o objeto é uma revisão de acesso única, a série de uma revisão de acesso recorrente ou uma instância de uma revisão de acesso recorrente.

Cenário Os revisores? Tem decisões e minhasDecisões? Tem instâncias?
Revisão de acesso único Sim Sim, uma vez iniciado Não
Revisão de acesso recorrente Sim Não Sim
Instância de uma revisão de acesso recorrente Sim Sim, uma vez iniciado Não

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
 "id": "string (identifier)",
 "displayName": "string",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "description": "string",
 "businessFlowTemplateId": "string (identifier)",
 "reviewerType": "string",
 "createdBy": {"@odata.type": "microsoft.graph.userIdentity"},
 "reviewedEntity": {"@odata.type": "microsoft.graph.identity"},
 "settings": {"@odata.type": "microsoft.graph.accessReviewSettings"},
 "reviewers": [{"@odata.type": "microsoft.graph.userIdentity"}]
}