driveProtectionRule 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示与OneDrive for Business保护策略关联的保护规则。
继承自 protectionRuleBase。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | driveProtectionRule 集合 | 获取 driveProtectionRule 对象及其属性的列表。 |
| 创建 | driveProtectionRule | 创建新的 driveProtectionRule。 |
| Get | driveProtectionRule | 读取 driveProtectionRule 的属性和关系。 |
| 删除 | 无 | 删除 driveProtectionRule。 |
| Run | protectionRuleBase | 激活驱动器保护规则。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 与策略关联的保护规则的唯一标识符。 |
| createdBy | identitySet entitySet | 创建规则的人员的标识。 |
| createdDateTime | DateTimeOffset | 创建规则的日期和时间。 |
| driveExpression | String | 包含驱动器表达式。 有关示例，请参阅 driveExpression 示例。 |
| error | publicError | 如果操作失败，此属性包含错误的详细信息。 |
| isAutoApplyEnabled | 布尔值 |
true 指示保护规则是动态的; false 它是静态的。 静态规则运行一次;动态规则侦听系统中的所有更改并更新保护单元列表。 目前，仅支持静态规则。 |
| lastModifiedBy | identitySet | 上次修改此规则的人员的身份。 |
| lastModifiedDateTime | DateTimeOffset | 此规则上次修改的时间戳。 |
| status | protectionRuleStatus | 保护规则的状态。 下面是可能的值：draft、、active、completedcompletedWithErrors、unknownFutureValue。 |
driveExpression 示例
下表显示了驱动器表达式的可能格式。
| 属性 | 运算符 | 示例 |
|---|---|---|
memberOf |
-any |
(memberOf -any (group.id -in ['d7f5150a-0c6f-4894-a6a1-6df77b26f375'])) |
group.id |
-in |
(memberOf -any (group.id -in ['d7f5150a-0c6f-4894-a6a1-6df77b26f375', '363cdbd0-f091-4644-93e4-64c1020c94d8'])) |
protectionRuleStatus 值
| 成员 | 说明 |
|---|---|
| 草案 | 创建时保护规则的初始状态为草稿。 |
| 积极 | 使用 /run API 时保护规则的状态。 |
| 完成 | 保护规则成功应用于相应策略后的状态。 |
| completedWithErrors | 保护规则应用于相应策略并发生任何失败后的状态。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.driveProtectionRule",
"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",
"driveExpression": "String"
}