accessReviewInstance tipo de recurso

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.

Observação

Esta é a API recomendada para revisões de acesso. A versão anterior da API de revisões de acesso foi preterida.

Representa uma periodicidade de revisão de acesso do Microsoft Entra. Se o acesso principalReviewScheduleDefinition for uma revisão de acesso periódica, as instâncias representam cada periodicidade. Uma revisão que não se repita terá exatamente uma instância. As instâncias também representam cada grupo exclusivo que está a ser revisto na definição de agenda. Se uma definição de agenda rever vários grupos, cada grupo tem uma instância exclusiva para cada periodicidade.

Cada accessReviewInstance contém uma lista de decisões nas quais os revisores podem tomar medidas. Há uma decisão por identidade a ser revista.

Métodos

Método	Tipo de retorno	Descrição
List	accessReviewInstance collection (coleção accessReviewInstance )	Obtenha uma lista dos objetos accessReviewInstance e respetivas propriedades.
Get	accessReviewInstance	Leia as propriedades e relações de um objeto accessReviewInstance .
Atualizar	accessReviewInstance	Atualize os revisores de um objeto accessReviewInstance .
Filtrar por utilizador atual	accessReviewInstance collection (coleção accessReviewInstance )	Devolve todas as instâncias num determinado accessReviewScheduleDefinition para o qual o utilizador que chama é o revisor de uma ou mais decisões.
Listar revisores contactados	accessReviewReviewer collection	Obtenha os revisores que receberam notificações de uma instância de revisão de acesso.
Enviar lembrete	Nenhuma.	Envie um lembrete aos revisores de um accessReviewInstance.
Stop	Nenhuma.	Parar manualmente um accessReviewInstance.
Aceitar recomendações	Nenhuma.	Permite que o utilizador que chama aceite a recomendação de decisão para cada acesso Não VisualizadoReviewInstanceDecisionItem em que é o revisor para um acesso específicoReviewInstance.
Aplicar decisões	Nenhuma.	Aplicar manualmente decisões num accessReviewInstance.
Parar de aplicar decisões	Nenhuma.	Permite que o utilizador que chama pare a ação de decisão aplicar num accessReviewInstance específico.
Decisões de registo do Batch	Nenhum	Reveja lotes de principais ou recursos numa chamada.
Repor decisões	Nenhum	Repõe todos os itens de decisão numa instância para notReviewed.
Fases da lista	coleção accessReviewStage	Obtenha as fases numa instância de revisão de acesso em várias fases.
Listar decisões	accessReviewInstanceDecisionItem collection (coleção accessReviewInstanceDecisionItem )	Obtenha os recursos accessReviewInstanceDecisionItem a partir da propriedade de navegação de decisões.
Listar instâncias de revisão de acesso pendentes (preteridas)	accessReviewInstance collection.	Obtenha todos os recursos de accessReviewInstance pendentes atribuídos ao utilizador que chama. Este método está a ser preterido e substituído por filterByCurrentUser.

Propriedades

Propriedade	Tipo	Descrição
endDateTime	DateTimeOffset	DateTime quando a instância de revisão está agendada para o fim. O tipo DatetimeOffset representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Oferece suporte para $select. Somente leitura.
erros	accessReviewError collection (coleção accessReviewError )	Coleção de erros num ciclo de vida da instância de revisão de acesso. Somente leitura.
fallbackReviewers	accessReviewReviewerScope collection (coleção accessReviewReviewerScope )	Esta coleção de âmbitos de revisores é utilizada para definir a lista de revisores de contingência. Estes revisores de contingência são notificados para tomar medidas se não forem encontrados utilizadores na lista de revisores especificados. Isto pode ocorrer quando o proprietário do grupo é especificado como revisor, mas o proprietário do grupo não existe ou o gestor é especificado como revisor, mas o gestor de um utilizador não existe. Oferece suporte para $select.
id	Cadeia de caracteres	Identificador exclusivo da instância. Oferece suporte para $select. Somente leitura.
scope	accessReviewScope	Criado com base no âmbito e instanceEnumerationScope no nível accessReviewScheduleDefinition. Define o âmbito dos utilizadores revistos num grupo. $select Suporta e $filter (contains apenas). 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 estado de um accessReview. Valores possíveis: Initializing, NotStarted, , StartingInProgress, Completing, , Completed, AutoReviewinge AutoReviewed. $selectSuporta apenas , $orderbye $filter (eq ). Somente leitura.
revisores	accessReviewReviewerScope collection (coleção accessReviewReviewerScope )	Esta coleção de âmbitos de revisão de acesso é utilizada para definir quem são os revisores. Oferece suporte para $select. Para obter exemplos de opções para atribuir revisores, veja Atribuir revisores à definição de revisão de acesso com a Microsoft Graph API.

Relações

Relação	Tipo	Descrição
contactedReviewers	accessReviewReviewer collection	Devolve a coleção de revisores que foram contactados para concluir esta revisão. Embora os revisores e as propriedades fallbackReviewers do accessReviewScheduleDefinition possam especificar proprietários ou gestores de grupos como revisores, contactedReviewers devolve as respetivas identidades individuais. Oferece suporte para $select. Somente leitura.
definição	accessReviewScheduleDefinition	Existe exatamente um accessReviewScheduleDefinition associado a cada instância. É a agenda principal da instância, em que as instâncias são criadas para cada periodicidade de uma definição de revisão e cada grupo selecionado para rever pela definição.
Estágios	coleção accessReviewStage	Se a instância tiver várias fases, esta ação devolve a coleção de fases. Só será criada uma nova fase quando a fase anterior terminar. A existência, número e definições de fases numa instância de revisão são criadas com base no accessReviewStageSettings no acesso principalReviewScheduleDefinition.
decisões	accessReviewInstanceDecisionItem collection (coleção accessReviewInstanceDecisionItem )	Cada utilizador revisto num accessReviewInstance tem um item de decisão que representa se foi aprovado, negado ou ainda não revisto.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "id": "string (identifier)",
 "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"
    }
  ]
}