Tipo de recurso accessReviewInstance

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

Esta é a API recomendada para avaliações de acesso. A versão anterior da API de críticas de acesso foi preterida.

Representa uma Azure AD recorrência de revisão de acesso. Se o accessReviewScheduleDefinition pai for uma revisão de acesso recorrente, as instâncias representarão cada recorrência. Uma revisão que não se repetir terá exatamente uma instância. As instâncias também representam cada grupo exclusivo que está sendo revisado na definição de agendamento. Se uma definição de agenda examinar vários grupos, cada grupo terá uma instância exclusiva para cada recorrência.

Cada accessReviewInstance contém uma lista de decisões nas qual os revisores podem tomar medidas. Há uma decisão por identidade sendo revisada.

Métodos

Método	Tipo de retorno	Descrição
Listar accessReviewInstances	coleção accessReviewInstance	Obtenha uma lista dos objetos accessReviewInstance e suas propriedades.
Obter accessReviewInstance	accessReviewInstance	Leia as propriedades e as relações de um objeto accessReviewInstance .
Atualizar accessReviewInstance	accessReviewInstance	Atualize os revisores de um objeto accessReviewInstance .
filterByCurrentUser	coleção accessReviewInstance	Retorna todas as instâncias em um determinado accessReviewScheduleDefinition para o qual o usuário chamador é o revisor de uma ou mais decisões.
Listar revisores contatados	coleção accessReviewReviewer	Obtenha os revisores que receberam notificações para uma instância de revisão de acesso.
sendReminder	Nenhum.	Envie um lembrete aos revisores de um accessReviewInstance.
stop	Nenhum.	Interrompa manualmente um accessReviewInstance.
acceptRecommendations	Nenhum.	Permite que o usuário chamado aceite a recomendação de decisão para cada NotReviewed accessReviewInstanceDecisionItem em que ele é o revisor para um accessReviewInstance específico.
applyDecisions	Nenhum.	Aplicar decisões manualmente em um accessReviewInstance.
batchRecordDecisions	Nenhum	Examine lotes de entidades de segurança ou recursos em uma chamada.
resetDecisions	Nenhum	Redefine todos os itens de decisão em uma instância para notReviewed.
Fases da lista	coleção accessReviewStage	Recupere os estágios em uma instância de revisão de acesso de vários estágios.
Listar decisões	coleção accessReviewInstanceDecisionItem	Obtenha os recursos accessReviewInstanceDecisionItem da propriedade de navegação de decisões.
Listar pendingAccessReviewInstances (preterido)	coleção accessReviewInstance .	Obtenha todos os recursos de accessReviewInstance pendentes atribuídos ao usuário que está chamando. Esse método está sendo preterido e substituído por filterByCurrentUser.

Propriedades

Propriedade	Tipo	Descrição
endDateTime	DateTimeOffset	DateTime quando a instância de revisão está agendada para terminar. O tipo DatetimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Oferece suporte para $select. Somente leitura.
erros	coleção accessReviewError	Coleção de erros em um ciclo de vida da instância de revisão de acesso. Somente leitura.
fallbackReviewers	coleção accessReviewReviewerScope	Essa coleção de escopos de revisores é usada para definir a lista de revisores de fallback. Esses revisores de fallback serão notificados para tomar medidas se nenhum usuário for encontrado na lista de revisores especificados. Isso pode ocorrer quando o proprietário do grupo é especificado como revistor, mas o proprietário do grupo não existe, ou o gerente é especificado como revistor, mas o gerente de um usuário não existe. Oferece suporte para $select.
id	Cadeia de caracteres	Identificador exclusivo da instância. Oferece suporte para $select. Somente leitura.
escopo	accessReviewScope	Criado com base no escopo e instanceEnumerationScope no nível accessReviewScheduleDefinition. Define o escopo dos usuários revisados em um grupo. Dá $select suporte e $filter (contains somente). Somente leitura.
startDateTime	DateTimeOffset	DateTime quando a instância de revisão está agendada para iniciar. Pode ser no futuro. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Oferece suporte para $select. Somente leitura.
status	Cadeia de caracteres	Especifica o status de um accessReview. Valores possíveis: Initializing, NotStarted, Starting, InProgress, Completing, Completed, AutoReviewinge AutoReviewed. Dá $selectsuporte $orderbya , e $filter (eq somente). Somente leitura.
Revisores	coleção accessReviewReviewerScope	Essa coleção de escopos de revisão de acesso é usada para definir quem são os revisores. Oferece suporte para $select. Para obter exemplos de opções para atribuir revisores, consulte Atribuir revisores à sua definição de revisão de acesso usando o Microsoft API do Graph.

Relações

Relação	Tipo	Descrição
contactedReviewers	coleção accessReviewReviewer	Retorna a coleção de revisores que foram contatados para concluir esta revisão. Embora as propriedades reviewers e fallbackReviewers do accessReviewScheduleDefinition possam especificar proprietários ou gerentes de grupo como revisores , contactedReviewers retorna suas identidades individuais. Oferece suporte para $select. Somente leitura.
Definição	accessReviewScheduleDefinition	Há exatamente um accessReviewScheduleDefinition associado a cada instância. É o agendamento pai da instância, em que as instâncias são criadas para cada recorrência de uma definição de revisão e cada grupo selecionado para examinar pela definição.
Estágios	coleção accessReviewStage	Se a instância tiver vários estágios, isso retornará a coleção de estágios. Um novo estágio só será criado quando o estágio anterior terminar. A existência, o número e as configurações de estágios em uma instância de revisão são criados com base no accessReviewStageSettings no accessReviewScheduleDefinition pai.
Decisões	coleção accessReviewInstanceDecisionItem	Cada usuário revisado em um accessReviewInstance tem um item de decisão que representa se ele foi aprovado, negado ou ainda não revisado.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "id": "string (identifier)",
 "displayName": "string",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "contactedReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewer"
    }
  ]
}