Deletes a permission policy.
Operation description
-
Before you delete a permission policy, you must delete all non-default versions of the policy. To delete a policy version, see DeletePolicyVersion.
-
Before you delete a permission policy, make sure that the policy is not attached to any RAM user, RAM user group, or RAM role. To detach a policy, see DetachPolicy.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| PolicyName |
string |
Yes |
The name of the permission policy. The name must be 1 to 128 characters in length and can contain letters, digits, and hyphens (-). |
OSS-Administrator |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
898FAB24-7509-43EE-A287-086FE4C44394 |
Examples
Success response
JSON format
{
"RequestId": "898FAB24-7509-43EE-A287-086FE4C44394"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter.PolicyName.InvalidChars | The policy name contains invalid characters. It must only contain upper or lower case letters, numbers, and dash (-). | The policy name contains invalid characters. It must only contain upper or lower case letters, numbers, and dash (-). |
| 400 | InvalidParameter.PolicyName.Length | The length of the policy name is invalid. It must be 1 to 128 characters in length. | The maximum length of the policy name is exceeded. It must be 1 to 128 characters in length. |
| 404 | EntityNotExist.Policy | The policy does not exist. | The policy does not exist. |
| 409 | DeleteConflict.Policy.User | Before deleting the policy, it may not be attached to any user. | The policy must not be attached to any user when you delete it. |
| 409 | DeleteConflict.Policy.Group | The policy cannot be attached to any group when you delete it. | The policy cannot be attached to any group when you delete it. |
| 409 | DeleteConflict.Policy.Version | You must delete all non-default versions before you delete the policy. | You must delete all non-default versions before you delete the policy. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.