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 de versão.

Observação

As APIs de revisão de acesso estão preteridas e deixarão de retornar dados em 19 de maio de 2023. Use as avaliações do Access.

Representa uma Azure AD de acesso.

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	Crie um novo accessReview.
Atualizar accessReview	accessReview	Atualize um accessReview.
Excluir accessReview	Nenhum	Exclua um accessReview.
Listar revisores accessReview	coleção userIdentity	Obtenha os revisores de um accessReview.
Adicionar revisor accessReview	Nenhum	Adicione um revisor a um accessReview.
Remover o revisor accessReview	Nenhum	Remover um revisor de um accessReview.
Listar decisões de accessReview	coleção accessReviewDecision	Obtenha as decisões de um accessReview.
Listar minhas decisões de accessReview	coleção accessReviewDecision	Como revisor, obtenha minhas decisões de um accessReview.
Enviar lembrete accessReview	Nenhum	Envie um lembrete aos revisores de um accessReview.
Parar accessReview	Nenhum	Pare um accessReview.
Redefinir decisões de accessReview	Nenhum	Redefina as decisões em um accessReview em andamento.
Aplicar decisões accessReview	Nenhum	Aplique as decisões de um accessReview concluído.

Propriedades

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	O identificador exclusivo atribuído ao 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	O DateTime quando a revisão está agendada para ser iniciada. Isso pode ser uma data 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	Esse campo somente leitura especifica o status de um accessReview. Os estados típicos incluem Initializing, NotStarted, Starting,InProgress , Completing, Completede AutoReviewed``AutoReviewing.
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 do modelo de fluxo de negócios. Obrigatório durante a criação. Esse valor diferencia maiúsculas de minúsculas.
reviewerType	Cadeia de caracteres	O tipo de relação do revistor com o objeto de destino, um de self, delegated ou entityOwners. Obrigatório durante a criação.
createdBy	userIdentity	O usuário que criou essa revisão.
reviewedEntity	identity	O objeto para o qual as revisões de acesso estão revisando as atribuições de direitos de acesso. Esse 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 de usuários a um aplicativo. Obrigatório durante a criação.
settings	accessReviewSettings	As configurações de um accessReview, consulte a 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 reviewerType de acesso 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 revisores.
instances	coleção accessReview	A coleção de revisões de acesso revisões de 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	Tem revisores?	Tem decisões e myDecisions?	Tem instâncias?
Revisão de acesso única	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

Veja a seguir uma representação JSON do 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"}]
}