Compartilhar via


accessReviewHistoryDefinition resource type (Tipo de recurso accessReviewHistoryDefinition)

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.

Representa uma coleção de dados históricos de revisão de acesso e os âmbitos utilizados para recolher esses dados.

Um accessReviewHistoryDefinition contém uma lista de objetos accessReviewHistoryInstance . Cada periodicidade da definição do histórico cria uma instância. No caso de uma definição de histórico única, só é criada uma instância.

Métodos

Método Tipo de retorno Descrição
List accessReviewHistoryDefinition collection Obtenha uma lista dos objetos accessReviewHistoryDefinition e as respetivas propriedades.
Create accessReviewHistoryDefinition Create um novo objeto accessReviewHistoryDefinition.
Get accessReviewHistoryDefinition Leia as propriedades e relações de um objeto accessReviewHistoryDefinition .

Propriedades

Propriedade Tipo Descrição
createdBy userIdentity Utilizador que criou esta definição do histórico de revisões.
createdDateTime DateTimeOffset Carimbo de data/hora quando a definição de revisão de acesso foi criada.
decisões Coleção String Determina as decisões de revisão que serão incluídas nos dados do histórico de revisões obtidos, se especificado. Opcional na criação. Todas as decisões são incluídas por predefinição se não forem fornecidas decisões durante a criação. Os valores possíveis são: approve, , denydontKnow, , notReviewede notNotified.
displayName Cadeia de caracteres Nome para a recolha de dados do histórico de revisão de acesso. Obrigatório.
id Cadeia de caracteres O identificador exclusivo atribuído de uma definição do histórico de revisão de acesso.
reviewHistoryPeriodEndDateTime DateTimeOffset Um carimbo de data/hora. As revisões que terminem em ou antes desta data serão incluídas nos dados do histórico obtidos. Só é necessário se scheduleSettings não estiver definido.
reviewHistoryPeriodStartDateTime DateTimeOffset Um carimbo de data/hora. As revisões a partir de ou antes desta data serão incluídas nos dados do histórico obtidos. Só é necessário se scheduleSettings não estiver definido.
scheduleSettings accessReviewHistoryScheduleSettings As definições de uma série de definições do histórico de revisão de acesso periódico. Só é necessário se reviewHistoryPeriodStartDateTime ou reviewHistoryPeriodEndDateTime não estiverem definidos. Ainda não é suportado.
escopos coleção accessReviewScope Utilizado para definir o âmbito das revisões incluídas nos dados do histórico obtido. Obtém as revisões cujo âmbito corresponde a este âmbito fornecido. Obrigatório.
status accessReviewHistoryStatus Representa o status da recolha de dados do histórico de revisões. Os valores possíveis são: done, inProgress, error, requested, unknownFutureValue.

Relações

Relação Tipo Descrição
instances accessReviewHistoryInstance collection (coleção accessReviewHistoryInstance) Se accessReviewHistoryDefinition for uma definição periódica, as instâncias representam cada periodicidade. Uma definição que não se repita terá exatamente uma instância.

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.accessReviewHistoryDefinition",
  "id": "String (identifier)",
  "displayName": "String",
  "reviewHistoryPeriodStartDateTime": "String (timestamp)",
  "reviewHistoryPeriodEndDateTime": "String (timestamp)",
  "status": "String",
  "decisions": [
    "String"
  ],
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.userIdentity"
  },
  "scopes": [
    {
      "@odata.type": "microsoft.graph.accessReviewScope"
    }
  ],
  "scheduleSettings": {
    "@odata.type": "microsoft.graph.accessReviewHistoryScheduleSettings"
  }
}