Тип ресурса accessReviewInstance

Статья
03/15/2023

Пространство имен: microsoft.graph

Представляет повторение проверки доступа Microsoft Entra. Если родительский accessReviewScheduleDefinition является повторяющейся проверкой доступа, экземпляры представляют каждое повторение. Проверка, которая не повторяется, будет содержать ровно один экземпляр. Экземпляры также представляют каждую уникальную группу, проверяемую в определении расписания. Если определение расписания проверяет несколько групп, каждая группа будет иметь уникальный экземпляр для каждого повторения.

Каждый accessReviewInstance содержит список решений , по которым рецензенты могут принимать меры. Существует одно решение для каждого проверяемого удостоверения.

Наследует от сущности.

Методы

Метод	Возвращаемый тип	Описание
Список accessReviewInstances	коллекция accessReviewInstance	Получите список объектов accessReviewInstance и их свойств.
Получение accessReviewInstance	accessReviewInstance	Чтение свойств и связей объекта accessReviewInstance .
Обновление accessReviewInstance	accessReviewInstance	Обновление рецензентов объекта accessReviewInstance .
filterByCurrentUser	коллекция accessReviewInstance	Возвращает все экземпляры заданного accessReviewScheduleDefinition , для которых вызывающий пользователь является проверяющим для одного или нескольких решений.
Список контактных рецензентов	коллекция accessReviewReviewer	Получение рецензентов, которые получили уведомления для экземпляра проверки доступа.
sendReminder	Нет	Отправьте рецензентам напоминание о accessReviewInstance.
stop	Нет	Остановите accessReviewInstance вручную.
acceptRecommendations	Нет	Позволяет вызывающему пользователю принять рекомендацию по принятию решения для каждого accessReviewInstanceDecisionItem , помеченного как `NotReviewed` и для которого вызывающий объект является рецензентом связанного accessReviewInstance.
applyDecisions	Нет	Вручную примените решения для accessReviewInstance.
batchRecordDecisions	Нет	Просмотрите пакеты субъектов или ресурсов в одном вызове.
resetDecisions	Нет	Сбрасывает все элементы решения для экземпляра в `notReviewed`.
Перечисление этапов	коллекция accessReviewStage	Получите этапы в экземпляре многоэтапной проверки доступа.
Список решений	коллекция accessReviewInstanceDecisionItem	Получите ресурсы accessReviewInstanceDecisionItem из свойства навигации decisions.

Свойства

Свойство	Тип	Описание
endDateTime	DateTimeOffset	DateTime, когда проверка экземпляра запланирована к завершению. Тип DatetimeOffset представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`. Поддерживает `$select`. Только для чтения.
fallbackReviewers	коллекция accessReviewReviewerScope	Эта коллекция областей рецензентов используется для определения списка резервных рецензентов. Эти резервные рецензенты будут уведомлены о принятии мер, если пользователи не найдены из указанного списка рецензентов. Это может произойти, если владелец группы указан в качестве рецензента, но владелец группы не существует, или руководитель указан в качестве рецензента, но руководитель пользователя не существует. Поддерживает `$select`.
id	String	Уникальный идентификатор экземпляра. Поддерживает `$select`. Только для чтения.
Авторам	коллекция accessReviewReviewerScope	Эта коллекция областей проверки доступа используется для определения рецензентов. Поддерживает `$select`. Примеры вариантов назначения рецензентов см. в статье Назначение рецензентов определению проверки доступа с помощью API Graph Майкрософт.
область	accessReviewScope	Создано на основе область и instanceEnumerationScope на уровне accessReviewScheduleDefinition. Определяет область пользователей, проверенных в группе. Поддерживает `$select` и `$filter` (`contains` только). Только для чтения.
startDateTime	DateTimeOffset	Дата и время запуска экземпляра проверки. Может быть в будущем. Тип DateTimeOffset представляет сведения о дате и времени с использованием формата ISO 8601 и всегда указывает время в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`. Поддерживает `$select`. Только для чтения.
status	String	Указывает состояние accessReview. Возможные значения: `Initializing`, `NotStarted`, `Starting`, `InProgress`, `Completing`, `Completed`и `AutoReviewingAutoReviewed`. Поддерживает `$select`, `$orderby`и `$filter` (`eq` только). Только для чтения.

Связи

Связь	Тип	Описание
contactedReviewers	коллекция accessReviewReviewer	Возвращает коллекцию рецензентов, с которыми связались для завершения этой проверки. В то время как свойства рецензентов и резервных рецензентовaccessReviewScheduleDefinition могут указывать владельцев групп или руководителей в качестве рецензентов, контактированныеreviewers возвращают свои индивидуальные удостоверения. Поддерживает `$select`. Только для чтения.
Решения	коллекция accessReviewInstanceDecisionItem	У каждого пользователя, проверенного в accessReviewInstance , есть элемент решения, представляющий, были ли они утверждены, отклонены или еще не проверены.
stages	коллекция accessReviewStage	Если экземпляр состоит из нескольких этапов, возвращается коллекция этапов. Новый этап будет создан только по завершении предыдущего этапа. Существование, число и параметры этапов в экземпляре проверки создаются на основе accessReviewStageSettings в родительском accessReviewScheduleDefinition.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "contactedReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewer"
    }
  ],
 "displayName": "string",
 "endDateTime": "string (timestamp)",
 "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "id": "string (identifier)",
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "startDateTime": "string (timestamp)",
  "status": "string"
  
}