Тип ресурса accessReviewScheduleSettings

  • Статья

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

Важно!

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

Примечание.

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

AccessReviewScheduleSettings определяет параметры accessReviewScheduleDefinition.

Свойства

Свойство Тип Описание
mailNotificationsEnabled Логический Указывает, включены или отключены сообщения электронной почты. Значение по умолчанию — false.
reminderNotificationsEnabled Логический Указывает, включены или отключены напоминания. Значение по умолчанию — false.
justificationRequiredOnApproval Логический Указывает, требуются ли рецензенты для обоснования своего решения. Значение по умолчанию — false.
defaultDecisionEnabled Логический Указывает, включено или отключено решение по умолчанию, если рецензенты не отвечают. Значение по умолчанию — false.

ОСТОРОЖНОСТЬЮ: Если как autoApplyDecisionsEnabled , так и defaultDecisionEnabled являются true, все права доступа субъектов к ресурсу могут быть отозваны, если рецензенты не ответят.
defaultDecision String Решение, выбранное, если defaultDecisionEnabled включен. Может быть одним из Approve, Denyили Recommendation.
instanceDurationInDays Int32 Длительность каждого повторения проверки (accessReviewInstance) в количестве дней.
ПРИМЕЧАНИЕ: Если определен параметр stageSettings объекта accessReviewScheduleDefinition , вместо значения этого свойства будет использоваться его параметр durationInDays .
recurrence patternedRecurrence Подробные параметры повторения с помощью стандартного объекта outlook recurrence.

Примечание: Поддерживаются только свойства dayOfMonth, interval и type (weekly, absoluteMonthly). Используйте свойство startDate on recurrenceRange , чтобы определить день начала проверки.
autoApplyDecisionsEnabled Логический Указывает, применяются ли решения автоматически. Если задано значение false, администратор должен вручную применить решения после завершения проверки доступа рецензентом. Если задано значение true, решения применяются автоматически после окончания срока действия экземпляра проверки доступа, независимо от того, ответили ли рецензенты. Значение по умолчанию — false.

ОСТОРОЖНОСТЬЮ: Если как autoApplyDecisionsEnabled , так и defaultDecisionEnabled являются true, все права доступа субъектов к ресурсу могут быть отозваны, если рецензенты не ответят.
applyActions коллекция accessReviewApplyAction Необязательное поле. Описывает действия, которые необходимо выполнить после завершения проверки. В настоящее время поддерживаются два типа: removeAccessApplyAction (по умолчанию) и disableAndDeleteUserApplyAction. Поле необходимо указать только в случае disableAndDeleteUserApplyAction.
recommendationsEnabled Логический Указывает, включены или отключены рекомендации по принятию решений.
ПРИМЕЧАНИЕ: Если определен параметр stageSettings объекта accessReviewScheduleDefinition , вместо значения этого свойства будет использоваться его параметр recommendationsEnabled .
recommendationLookBackDuration Duration (Длительность) Необязательное поле. Указывает период бездействия (в отношении даты начала экземпляра проверки), с чего будут настроены рекомендации. Рекомендуется, если deny пользователь неактивен во время оглядки. Для проверок групп и Microsoft Entra ролей принимается любая длительность. Для проверки приложений максимальная продолжительность составляет 30 дней. Если не указано, длительность составляет 30 дней.

ПРИМЕЧАНИЕ: Если определен параметр stageSettings объекта accessReviewScheduleDefinition , вместо значения этого свойства будет использоваться его параметр recommendationLookBackDuration .
decisionHistoriesForReviewersEnabled Логический Указывает, доступны ли решения на предыдущих этапах проверки доступа для рецензентов в accessReviewInstance с несколькими последующими этапами. Если параметр не указан, значение по умолчанию отключено (false).
recommendationInsightSettings коллекция accessReviewRecommendationInsightSetting Необязательный параметр. Описывает типы аналитических сведений, помогающих рецензентам принимать решения о проверке доступа.

ПРИМЕЧАНИЕ: Если определен параметр stageSettings объекта accessReviewScheduleDefinition , вместо значения этого свойства будет использоваться его параметр recommendationInsightSettings .

Связи

Отсутствуют.

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

Ниже указано представление ресурса в формате JSON.

{
  "@odata.type": "#microsoft.graph.accessReviewScheduleSettings",
  "mailNotificationsEnabled": "Boolean",
  "reminderNotificationsEnabled": "Boolean",
  "justificationRequiredOnApproval": "Boolean",
  "defaultDecisionEnabled": "Boolean",
  "defaultDecision": "String",
  "instanceDurationInDays": "Integer",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "autoApplyDecisionsEnabled": "Boolean",
  "applyActions": [
    {
      "@odata.type": "microsoft.graph.removeAccessApplyAction"
    }
  ],
  "recommendationsEnabled": "Boolean",
  "recommendationLookBackDuration": "String (duration)",
  "decisionHistoriesForReviewersEnabled": "Boolean",
  "recommendationInsightSettings": [
    {
      "@odata.type": "microsoft.graph.accessReviewRecommendationInsightSetting"
    }
  ]
}