Тип ресурса protectionRuleBase

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

Важно!

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

Представляет правило защиты, указанное клиентом в рамках плана защиты, применяемого к данным Microsoft 365 в организации. В настоящее время можно определить только правила включения, которые указывают, что политика защиты должна соответствовать указанным критериям.

• Правила защиты могут быть статическими или динамическими. Если свойство isAutoApplyEnabled имеет значение true, правило защиты является динамическим; в противном случае — статическим.
• Статические изменения правил применяются один раз при создании без автоматического или динамического обновления.
• Динамическое правило оценивается повторно через регулярные интервалы для получения последней область правила, что приводит к добавлению или удалению артефактов на основе последней оценки правила.
• Это свойство можно задать только при создании объекта protectionRuleBase . Поэтому динамическое правило нельзя изменить на статическое или наоборот.

Этот абстрактный тип является базовым типом для siteProtectionRule, mailboxProtectionRule и driveProtectionRule.

К этому ресурсу применяются следующие ограничения:

• API правил защиты для добавления нескольких сайтов по именам сайтов или URL-адресам в рабочий процесс создания политики резервного копирования могут обрабатывать не более 10 ключевых слов за раз. Каждая ключевое слово может содержать не менее трех символов и не более 255 символов.
• API правил защиты для массового добавления учетных записей пользователей через группы безопасности или списки рассылки могут одновременно содержать не более трех групп.
• Статические правила применяются только один раз, в течение которого группы безопасности или списки рассылки становятся плоскими при добавлении в политику конфигурации резервного копирования. Например, группы или списки не обновляются динамически в системе, если пользователи добавляются или удаляются из исходной группы безопасности.
• Динамические правила обновляются через регулярные интервалы, автоматически добавляя и удаляя артефакты из политики конфигурации в зависимости от результата оценки правила.
• Политика защиты может содержать только одно активное динамическое правило.
• Динамические правила недоступны для политик защиты SharePoint.
• Динамическое выражение правила поддерживает не более 100 идентификаторов групп в выражении.
• В настоящее время с помощью динамического правила можно защитить не более 6000 пользователей.
• Выражение со вложенным списком рассылки или группой безопасности не поддерживается.
• Несколько регионов недоступны для динамических правил.

Свойства

Свойство	Тип	Описание
id	String	Уникальный идентификатор правила защиты, связанного с политикой.
createdBy	identitySet	Удостоверение пользователя, создавшего правило.
createdDateTime	DateTimeOffset	Время создания правила.
error	publicError	Содержит сведения об ошибке в случае сбоя операции с правилом.
isAutoApplyEnabled	Логический	true указывает, что правило защиты является динамическим; false что это статический.
lastModifiedBy	identitySet	Удостоверение пользователя, который в последний раз изменил правило.
lastModifiedDateTime	DateTimeOffset	Метка времени последнего изменения правила.
status	protectionRuleStatus	Состояние правила защиты. Возможные значения: draft, active, completed, completedWithErrors, unknownFutureValue, updateRequested, deleteRequested. Prefer: include-unknown-enum-members Используйте заголовок запроса, чтобы получить следующие значения в этой развиваемой перечислении: updateRequested , deleteRequested. Элемент draft в настоящее время не поддерживается.

Значения protectionRuleStatus

Member	Описание
черновик	Начальное состояние правила защиты при создании. Элемент draft в настоящее время не поддерживается.
активный	Состояние правила защиты при его выполнении.
завершённый	Состояние правила защиты при его успешном применении к соответствующей политике.
completedWithErrors	Состояние правила защиты при выполнении правила, но обнаружении ошибок.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.
updateRequested	Состояние правила защиты при запросе исправления. Это значение применяется только к динамическим правилам.
deleteRequested	Состояние правила защиты при выполнении действия deleteAndUnprotect . Это значение применяется только к динамическим правилам.

Связи

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

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

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

{
  "@odata.type": "#microsoft.graph.protectionRuleBase",
  "id": "String (identifier)",
  "status": "String",
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "error": {
    "@odata.type": "microsoft.graph.publicError"
  },
  "isAutoApplyEnabled": "Boolean"
}