Поделиться через


тип ресурса accessReviewScheduleDefinition

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Примечание.

Это рекомендуемый API для проверок доступа. Предыдущая версия API проверки доступа устарела.

Представляет планирование проверки доступа к Microsoft Entra.

AccessReviewScheduleDefinition содержит список объектов accessReviewInstance . При каждом повторении определения расписания создается экземпляр . Экземпляры также представляют каждый уникальный проверяемый ресурс. Если определение расписания проверяет несколько ресурсов (включая несколько групп), каждый ресурс имеет уникальный экземпляр для каждого повторения. В случае одноразовой проверки для каждого ресурса создается только один экземпляр.

Методы

Метод Возвращаемый тип Описание
Список коллекция accessReviewScheduleDefinition Списки каждый accessReviewScheduleDefinition. Не включает связанные объекты accessReviewInstance в результаты.
Получение accessReviewScheduleDefinition Получите accessReviewScheduleDefinition с указанным идентификатором. Не включает связанные объекты accessReviewInstance в результаты.
Создание accessReviewScheduleDefinition Create новый accessReviewScheduleDefinition.
удаление; Нет. Удалите accessReviewScheduleDefinition с указанным идентификатором.
Обновление Нет. Обновите свойства accessReviewScheduleDefinition с помощью указанного идентификатора.
Фильтрация по текущему пользователю коллекция accessReviewScheduleDefinition Извлекает все определения, для которых вызывающий пользователь является рецензентом в одном или нескольких экземплярах.

Свойства

Свойство Тип Описание
additionalNotificationRecipients коллекция accessReviewNotificationRecipientItem Определяет список дополнительных пользователей или членов группы, которые будут уведомлены о ходе проверки доступа.
createdBy userIdentity Пользователь, создавший эту проверку. Только для чтения.
createdDateTime DateTimeOffset Метка времени создания ряда проверки доступа. Поддерживает $select. Только для чтения.
descriptionForAdmins String Описание, предоставляемое создателями проверки, чтобы предоставить администратору дополнительный контекст проверки. Поддерживает $select.
descriptionForReviewers String Описание, предоставляемое создателями проверки для предоставления дополнительных контекстов проверки рецензентам. Рецензенты видят это описание в сообщении электронной почты, отправленном им с запросом на проверку. уведомления Email поддерживают до 256 символов. Поддерживает $select.
displayName String Имя серии проверки доступа. Поддерживает $select и $orderby. Требуется при создании.
fallbackReviewers коллекция accessReviewReviewerScope Эта коллекция областей рецензентов используется для определения списка резервных рецензентов. Эти резервные рецензенты будут уведомлены о принятии мер, если пользователи не найдены из указанного списка рецензентов. Это может произойти, если владелец группы указан в качестве рецензента, но владелец группы не существует, или руководитель указан в качестве рецензента, но руководитель пользователя не существует. См . раздел accessReviewReviewerScope. Заменяет backupReviewers. Поддерживает $select.

ПРИМЕЧАНИЕ: Значение этого свойства будет игнорироваться, если резервные рецензенты назначаются с помощью свойства stageSettings .
id String Уникальный идентификатор проверки доступа, назначаемый функцией. Поддерживает $select. Только для чтения.
instanceEnumerationScope accessReviewScope Это свойство требуется при определении области доступа гостевых пользователей во всех группах Microsoft 365 и определяет, какие группы Microsoft 365 проверяются. Каждая группа становится уникальным accessReviewInstance серии проверки доступа. Сведения о поддерживаемых областях см. в разделе accessReviewScope. Поддерживает $select. Примеры параметров настройки instanceEnumerationScope см. в статье Настройка область определения проверки доступа с помощью API Graph Майкрософт.
instances коллекция accessReviewInstance Набор экземпляров проверок доступа для этой серии проверок доступа. Проверки доступа, которые не повторяются, будут иметь только один экземпляр; В противном случае для каждого повторения есть экземпляр.
lastModifiedDateTime DateTimeOffset Метка времени последнего изменения ряда проверки доступа. Поддерживает $select. Только для чтения.
Авторам коллекция accessReviewReviewerScope Эта коллекция областей проверки доступа используется для определения того, кто является рецензентами. Свойство рецензентов обновляется только в том случае, если в качестве рецензентов назначены отдельные пользователи. Требуется при создании. Поддерживает $select. Примеры вариантов назначения рецензентов см. в статье Назначение рецензентов определению проверки доступа с помощью API Graph Майкрософт.

ПРИМЕЧАНИЕ: Значение этого свойства будет игнорироваться, если рецензенты назначаются с помощью свойства stageSettings .
область accessReviewScope Определяет сущности, доступ к которым проверяется. Сведения о поддерживаемых областях см. в разделе accessReviewScope. Требуется при создании. Поддерживает $select и $filter (contains только). Примеры параметров настройки область см. в статье Настройка область определения проверки доступа с помощью API Graph Майкрософт.
stageSettings коллекция accessReviewStageSettings Требуется только для многоэтапной проверки доступа для определения этапов и их параметров. Каждый экземпляр проверки можно разбить на три последовательных этапа, где каждый этап может иметь разный набор рецензентов, резервных рецензентов и параметров. Этапы создаются последовательно на основе свойства dependsOn . Необязательный параметр.

При определении этого свойства его параметры используются вместо соответствующих параметров в объекте accessReviewScheduleDefinition и его параметрах, рецензентах и резервных свойствахReviewers .
settings accessReviewScheduleSettings Параметры для ряда проверок доступа см. ниже в определении типа. Поддерживает $select. Требуется при создании.
status String Это поле только для чтения указывает состояние проверки доступа. К типичным состояниям относятся Initializing, NotStarted, Starting, InProgress, Completing, CompletedAutoReviewingи AutoReviewed.
Поддерживает $select, $orderbyи $filter (eq только). Только для чтения.
backupReviewers (не рекомендуется) коллекция accessReviewReviewerScope Эта коллекция областей рецензентов используется для определения списка резервных рецензентов. Эти резервные рецензенты получают уведомление о необходимости принять меры, если пользователи не найдены в указанном списке рецензентов. Это может произойти, если владелец группы указан в качестве рецензента, но владелец группы не существует, или руководитель указан в качестве рецензента, но руководитель пользователя не существует. Поддерживает $select.
Примечание: Это свойство было заменено резервнымиreviewers. Однако при указании backupReviewers или fallbackReviewers те же значения автоматически заполняются другим свойством.

Связи

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

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

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

{
  "@odata.type": "#microsoft.graph.accessReviewScheduleDefinition",
  "id": "String (identifier)",
  "displayName": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "status": "String",
  "descriptionForAdmins": "String",
  "descriptionForReviewers": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.userIdentity"
  },
  "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "backupReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "instanceEnumerationScope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "stageSettings": [
    {
      "@odata.type": "microsoft.graph.accessReviewStageSettings"
    }
  ],
  "settings": {
    "@odata.type": "microsoft.graph.accessReviewScheduleSettings"
  },
  "additionalNotificationRecipients": [
    {
        "@odata.type": "microsoft.graph.accessReviewNotificationRecipientItem"
    }
  ]
}