protectionRuleBase 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示客户端指定的保护规则，作为应用于组织中Microsoft 365 数据的保护计划的一部分。 目前，只能定义包含规则，这些规则是指示保护策略应与指定条件匹配的规则。

目前，保护规则本质上是静态的，这意味着仅在执行规则时应用策略更改，没有自动/动态更新。

此抽象类型是 siteProtectionRule、 mailboxProtectionRule 和 driveProtectionRule 的基类型。

以下限制适用于此资源：

• 用于在备份策略创建工作流中通过站点名称或 URL 批量添加网站的保护规则 API 一次最多可以容纳 10 个关键字。 每个关键字 (keyword) 可以包含至少 3 个字符，最多 255 个字符。
• 用于通过安全组或通讯组列表批量添加用户帐户的保护规则 API 一次最多可以容纳三个组。
• 规则是静态的，仅应用一次。 也就是说，安全组或通讯组列表在添加到备份配置策略时会平展它们。 例如，如果在原始安全组中添加或删除用户，则不会在系统中动态更新组或列表。

属性

属性	类型	说明
id	String	与策略关联的保护规则的唯一标识符。
createdBy	identitySet	创建规则的人员的标识。
createdDateTime	DateTimeOffset	创建规则的时间。
error	publicError	包含对规则的操作失败时的错误详细信息。
isAutoApplyEnabled	布尔值	true 指示保护规则是动态的; false 它是静态的。 目前，仅支持静态规则。
lastModifiedBy	identitySet	上次修改规则的人员的身份。
lastModifiedDateTime	DateTimeOffset	对规则进行的最后一次修改的时间戳。
status	protectionRuleStatus	保护规则的状态。 可能的值包括 draft、active、completed、completedWithErrors、unknownFutureValue。 成员 draft 当前不受支持。

protectionRuleStatus 值

成员	说明
草案	创建保护规则时的初始状态。 成员 draft 当前不受支持。
积极	保护规则在运行时的状态。
完成	保护规则成功应用于相应策略时的状态。
completedWithErrors	当规则运行但遇到错误时，保护规则的状态。
unknownFutureValue	可演变枚举 sentinel 值。 请勿使用。

关系

无。

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"
}