tipo de recurso accessReviewInstance

  • Artigo

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

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

Representa uma recorrência de revisão de acesso Microsoft Entra. Se o acesso paiReviewScheduleDefinition 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 agendar 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 quais os revisores podem agir. Há uma decisão por identidade sendo revisada.

Métodos

Método Tipo de retorno Descrição
Acesso de listaReviewInstances 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 Nenhuma. Envie um lembrete para os revisores de um accessReviewInstance.
stop Nenhuma. Parar manualmente um accessReviewInstance.
acceptRecommendations Nenhuma. Permite que o usuário chamado aceite a recomendação de decisão para cada acesso NotReviewInstanceDecisionItem em que ele é o revisor para um acesso específicoReviewInstance.
applyDecisions Nenhuma. Aplicar manualmente decisões em um accessReviewInstance.
stopApplyDecisions Nenhuma. Permite que o usuário chamado pare a ação de decisão de aplicação em um acesso específicoReviewInstance.
batchRecordDecisions Nenhum Examine lotes de entidades ou recursos em uma única chamada.
resetDecisions Nenhum Redefine todos os itens de decisão em uma instância para notReviewed.
Estágios de 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 . Obter todos os recursos de accessReviewInstance pendentes atribuídos ao usuário chamador. Esse método está sendo preterido e substituído pelo 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 em tempo 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 revisor é usada para definir a lista de revisores de fallback. Esses revisores de fallback serão notificados a agir se nenhum usuário for encontrado na lista de revisores especificados. Isso pode ocorrer quando o proprietário do grupo é especificado como o revisor, mas o proprietário do grupo não existe ou o gerenciador é especificado como revisor, mas o gerenciador 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.
scope accessReviewScope Criado com base no escopo e na instânciaEnumerationScope no nível accessReviewScheduleDefinition. Define o escopo dos usuários revisados em um grupo. $select Dá suporte e $filter (contains somente). Somente leitura.
startDateTime DateTimeOffset DateTime quando a instância de revisão está agendada para começar. Pode estar 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, InProgressStarting, , Completing, Completed, , AutoReviewinge AutoReviewed. $selectDá suporte a , $orderbye $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 à 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 de revisores e fallbackReviewers do accessReviewScheduleDefinition possam especificar proprietários de grupo ou gerentes 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. É a agenda 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 revisar 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 criadas com base no accessReviewStageSettings no access paiReviewScheduleDefinition.
Decisões coleção accessReviewInstanceDecisionItem Cada usuário revisado em um accessReviewInstance tem um item de decisão que representa se foi aprovado, negado ou ainda não revisado.

Representação JSON

A representação JSON a seguir mostra o tipo de 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"
    }
  ]
}