Compartilhar via


accessReviewStage 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 fase de uma revisão de acesso Microsoft Entra periodicidade. Se o accessReviewScheduleDefinition principal tiver definido a propriedade stageSettings , o accessReviewInstance é composto por até três fases subsequentes. Cada fase pode ter um conjunto diferente de revisores que podem tomar decisões em palco e definições que determinam quais as decisões que passam de fase em palco.

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

Métodos

Método Tipo de retorno Descrição
List coleção accessReviewStage Obtenha uma lista dos objetos accessReviewStage e respetivas propriedades.
Get accessReviewStage Leia as propriedades e relações de um objeto accessReviewStage .
Atualizar accessReviewStage Atualize as propriedades de um objeto accessReviewStage .
Stop Nenhum Parar manualmente um accessReviewStage.
Filtrar por utilizador atual coleção accessReviewStage Devolve todas as fases num determinado accessReviewInstance para o qual o utilizador que chama é revisor.
Listar decisões de uma fase de uma instância accessReviewInstanceDecisionItem collection (coleção accessReviewInstanceDecisionItem ) Obtenha as decisões tomadas num accessReviewStage.

Propriedades

Propriedade Tipo Descrição
endDateTime DateTimeOffset DateTime quando a fase 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. Esta propriedade é o total cumulativo da duraçãoInDays para todas as fases. 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.
id Cadeia de caracteres Identificador exclusivo da fase. 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. Para obter exemplos de opções para atribuir revisores, consulte Atribuir revisores à definição de revisão de acesso com o microsoft API do Graph.
startDateTime DateTimeOffset DateTime quando a fase 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. Somente leitura.
status Cadeia de caracteres Especifica a status de um accessReviewStage. Valores possíveis: Initializing, NotStarted, , StartingInProgress, Completing, , Completed, AutoReviewinge AutoReviewed. $orderbySuporta , e $filter (eq apenas). Somente leitura.

Relações

Relação Tipo Descrição
decisões accessReviewInstanceDecisionItem collection (coleção accessReviewInstanceDecisionItem ) Cada utilizador revisto num accessReviewStage 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.accessReviewStage",
  "id": "String (identifier)",
  "startDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "status": "String",
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ]
}