siteProtectionRule 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示与 sharePointProtectionPolicy 关联的保护规则的属性。
继承自 protectionRuleBase。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | siteProtectionRule 集合 | 获取 siteProtectionRule 对象及其属性的列表。 |
| 创建 | siteProtectionRule | 创建新的 siteProtectionRule。 |
| Get | siteProtectionRule | 读取 siteProtectionRule 的属性和关系。 |
| 删除 | None | 删除 siteProtectionRule。 |
| Run | protectionRuleBase | 激活站点保护规则。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 与策略关联的保护规则的唯一标识符。 |
| createdBy | identitySet | 创建规则的人员的标识。 |
| createdDateTime | DateTimeOffset | 创建规则的日期和时间。 |
| error | publicError | 包含针对规则表达式的任何操作失败时的错误详细信息。 |
| isAutoApplyEnabled | 布尔值 |
true 指示保护规则是动态的; false 它是静态的。 静态规则运行一次，而动态规则将侦听系统中的所有更改并更新保护单元列表。 目前，仅支持静态规则。 |
| lastModifiedBy | identitySet | 上次修改规则的人员的身份。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改规则的时间戳。 |
| siteExpression | String | 包含网站表达式。 有关示例，请参阅 siteExpression 示例。 |
| status | protectionRuleStatus | 保护规则的状态。 可能的值包括 draft、active、completed、completedWithErrors、unknownFutureValue。 成员 draft 当前不受支持。 |
siteExpression 示例
下表显示了站点表达式的可能格式。
| 属性 | 运算符 | 示例 |
|---|---|---|
displayName |
-contains |
((displayName -contains 'Finance') -or (displayName -contains 'Legal')) |
lastModifiedDateTime |
-ge |
(((displayName -contains 'Finance') -or (webUrl -contains 'Legal')) -and (lastModifiedDateTime -ge '2024-02-26T11:36:20Z')) |
webUrl |
-contains |
((displayName -contains 'Finance') -or (webUrl -contains 'Legal')) |
protectionRuleStatus 值
| 成员 | 说明 |
|---|---|
| 草案 | 创建保护规则时的初始状态。 成员 draft 当前不受支持。 |
| 积极 | 使用 /run API 时保护规则的状态。 |
| 完成 | 保护规则成功应用于相应策略后的状态。 |
| completedWithErrors | 保护规则应用于相应策略并发生任何失败后的状态。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.siteProtectionRule",
"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",
"siteExpression": "String"
}