Detaches a control policy.
Operation description
After the control policy is detached, the originally associated folder or member immediately loses the governance of the control policy. Make sure that the result of the detach operation meets your expectations to avoid affecting your normal business operations.
Both system policies and custom control policies can be detached. However, the last control policy attached to a folder or member cannot be detached.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
resourcemanager:DetachControlPolicy |
update |
*Account
*ControlPolicy
*Folder
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| PolicyId |
string |
Yes |
The ID of the control policy. |
cp-jExXAqIYkwHN**** |
| TargetId |
string |
Yes |
The target node. Valid values:
|
fd-ZDNPiT**** |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response. |
||
| RequestId |
string |
The request ID. |
9EA4F962-1A2E-4AFE-BE0C-B14736FC46CC |
Examples
Success response
JSON format
{
"RequestId": "9EA4F962-1A2E-4AFE-BE0C-B14736FC46CC"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | NotSupport.DetachLastControlPolicy | It is not detach the last control policy on the target node. | It is not detach the last control policy on the target node. |
| 400 | NotSupport.DetachLastResourceControlPolicy | It is not supported to detach the last resource control policy. | |
| 400 | NotSupport.DetachSystemResourceControlPolicy | It is not supported to detach system resource control policy. | |
| 404 | EntityNotExists.Target | The specified target does not exist in the resource directory. | The specified object does not exist in the resource directory. |
| 404 | EntityNotExists.ResourceControlPolicy | The specified resource control policy does not exist. | |
| 404 | EntityNotExists.ResourceControlPolicyAttachment | The specified resource control policy attachment does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.