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

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

Representa uma recorrência da revisão de acesso do Microsoft Entra. 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 programação. Se uma definição de agendamento examinar vários grupos, cada grupo terá uma instância exclusiva para cada recorrência.

Cada accessReviewInstance contém uma lista de decisões sobre as quais os revisores podem agir. Há uma decisão por identidade sendo examinada.

Métodos

Método Tipo de retorno Descrição
List coleção accessReviewInstance Obtenha uma lista dos objetos accessReviewInstance e suas propriedades.
Get accessReviewInstance Leia as propriedades e relacionamentos de um objeto accessReviewInstance .
Atualizar accessReviewInstance Atualize os revisores de um objeto accessReviewInstance .
Aplicar decisões de recursos fornecidas por dados personalizados Nenhum Defina em applyResult todas as decisões para um recurso específico de dados personalizados fornecidos em uma chamada.
Filtrar por usuário atual coleção accessReviewInstance Retorna todas as instâncias em um determinado accessReviewScheduleDefinition para o qual o usuário que está chamando é o revisor de uma ou mais decisões.
Lista dos revisores contatados coleção accessReviewReviewer Obtenha os revisores que receberam notificações para uma instância de revisão de acesso.
Enviar lembrete Nenhuma. Envie um lembrete para os revisores de um accessReviewInstance.
Stop Nenhuma. Pare manualmente um accessReviewInstance.
Aceitar recomendações Nenhuma. Permite que o usuário que está chamando aceite a recomendação de decisão para cada accessReviewInstanceDecisionItem não revisado em que ele é o revisor para um accessReviewInstance específico.
Aplicar decisões Nenhuma. Aplique manualmente decisões em um accessReviewInstance.
Parar de aplicar decisões Nenhuma. Permite que o usuário que está chamando pare a ação de decisão de aplicação em um accessReviewInstance específico.
Decisões de registro em lote Nenhum Examine lotes de entidades ou recursos em uma chamada.
Redefinir decisões Nenhum Redefine todos os itens de decisão em uma instância para notReviewed.
Listar estágios 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 instâncias de revisão de acesso pendentes (obsoletas) accessReviewInstance . Obtenha todos os recursos 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
delegatedBy Coleção UserIdentity As identidades dos usuários que delegaram essa instância de revisão ao revisor atual. Null se a instância não tiver sido delegada. Retornado apenas por meio de filterByCurrentUser quando solicitado explicitamente por meio de $select. Somente leitura.
endDateTime DateTimeOffset Data e hora em que a instância de revisão está programada 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 Coleta de erros no ciclo de vida de uma instância de revisão de acesso. Somente leitura.
fallbackReviewers accessReviewReviewerScope collection Essa coleção de escopos de revisor é usada para definir a lista de revisores de fallback. Esses revisores de fallback são notificados para tomar medidas se nenhum usuário for encontrado na lista de revisores especificada. Isso pode ocorrer quando o proprietário do grupo é especificado como revisor, mas o proprietário do grupo não existe, ou o gerente é especificado como revisor, 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.
scope accessReviewScope Criado com base no escopo e instanceEnumerationScope no nível accessReviewScheduleDefinition. Define o escopo dos usuários revisados em um grupo. Suporta $select e $filter (contains apenas). Somente leitura.
startDateTime DateTimeOffset Data e hora em que 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, InProgressCompleting, Completed, , AutoReviewing, e AutoReviewed. Dá suporte $selecta , $orderbye $filter (eq apenas). Somente leitura.
revisores accessReviewReviewerScope collection 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 a 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 revisores 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. É a programação 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 revisão 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 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)",
  "startDateTime": "string (timestamp)",
  "endDateTime": "string (timestamp)",
  "status": "string",
  "delegatedBy": [
    {
      "@odata.type": "microsoft.graph.userIdentity"
    }
  ],
  "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "contactedReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewer"
    }
  ]
}
  • Last updated on