protectionRuleBase:deleteAndUnprotect
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
删除和取消保护受动态规则保护的所有项目。 此作仅适用于动态规则。
删除动态规则并取消保护它保护的所有项目时,以下几点适用。
- 当对动态规则执行此作时,
deleteRequested
规则将变为状态。 - 取消保护项目和删除规则是异步作,它们可能不会立即完成。
- 此作将
dynamicRule
重置保护源。 如果项目还受到另一个保护源的保护,则之后仅受该源的保护。 - 规则处于
deleteRequested
状态后,不允许对动态规则执行任何作。
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | BackupRestore-Configuration.ReadWrite.All | 不可用。 |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | BackupRestore-Configuration.ReadWrite.All | 不可用。 |
HTTP 请求
POST /solutions/backupRestore/oneDriveForBusinessProtectionPolicies/{oneDriveForBusinessProtectionPolicyId}/driveInclusionRules/{driveProtectionRuleId}/deleteAndUnprotect
POST /solutions/backupRestore/exchangeProtectionPolicies/{exchangeProtectionPolicyId}/mailboxInclusionRules/{mailboxProtectionRuleId}/deleteAndUnprotect
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此作将在 202 Accepted
响应正文中返回响应代码和 protectionRuleBase 。
示例
示例 1:删除和取消保护与 onedriveForBusiness 保护策略关联的 driveInclusionRule
以下示例演示如何删除与 onedriveForBusinessProtectionPolicy 关联的 driveInclusionRule 并取消保护它所保护的单元。
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/beta/solutions/backupRestore/oneDriveForBusinessProtectionPolicies/71633878-8321-4950-bfaf-ed285bdd1461/driveInclusionRules/61633878-8321-4950-bfaf-ed285bdd1461/deleteAndUnprotect
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": {
"@odata.type": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.protectionRuleBase",
"id": "61633878-8321-4950-bfaf-ed285bdd1461",
"status": "deleteRequested",
"createdDateTime": "2025-01-15T15:07:44.3043505Z",
"lastModifiedDateTime": "2025-01-15T14:42:12.6779064Z",
"isAutoApplyEnabled": true,
"driveExpression": "(memberOf -any (group.id -in ['4e8e9b15-bfc8-40a2-aed0-3f65a22e2bd4']))",
"createdBy": {
"user": {
"identity": "8aaaaec3-5dcb-4b47-9ef9-0dda3e95b9f4"
}
},
"lastModifiedBy": {}
}
}
示例 2:删除和取消保护与 Exchange 保护策略关联的 mailboxInclusionRule
以下示例演示如何删除与 exchangeProtectionPolicy 关联的 mailboxInclusionRule。
请求
以下示例显示了一个请求。
POST https://graph.microsoft.com/beta/solutions/backupRestore/exchangeProtectionPolicies/6b0991b9-e7d4-4794-86fa-2a3f2a4e3177/mailboxInclusionRules/52147fb9-2682-47bc-a8f6-6c38c1ff498d/deleteAndUnprotect
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": {
"@odata.type": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.protectionRuleBase",
"id": "52147fb9-2682-47bc-a8f6-6c38c1ff498d",
"status": "deleteRequested",
"createdDateTime": "2025-01-15T15:07:44.3043505Z",
"lastModifiedDateTime": "2025-01-15T14:42:12.6779064Z",
"isAutoApplyEnabled": true,
"driveExpression": "(memberOf -any (group.id -in ['4e8e9b15-bfc8-40a2-aed0-3f65a22e2bd4']))",
"createdBy": {
"user": {
"identity": "8aaaaec3-5dcb-4b47-9ef9-0dda3e95b9f4"
}
},
"lastModifiedBy": {},
"error": {}
}
}