All Products
Search
Document Center

Resource Management:DeletePolicyVersion

Last Updated:Jun 05, 2024

Deletes a version of a permission policy.

Operation description

Note The default version of a permission policy cannot be deleted.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
PolicyNamestringYes

The name of the policy.

The name must be 1 to 128 characters in length and can contain letters, digits, and hyphens (-).

OSS-Administrator
VersionIdstringYes

The ID of the policy version.

You can call the ListPolicyVersions operation to query the ID.

v3

For more information about common request parameters, see Common parameters.

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

9B34724D-54B0-4A51-B34D-4512372FE1BE

Examples

Sample success responses

JSONformat

{
  "RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE"
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidParameter.PolicyName.InvalidCharsThe 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 (-).
400InvalidParameter.PolicyName.LengthThe 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.
400InvalidParameter.VersionId.FormatThe specified version ID is invalid.The specified version ID is invalid.
404EntityNotExist.PolicyThe policy does not exist.The policy does not exist.
404EntityNotExist.Policy.VersionThe policy version does not exist.The policy version does not exist.
409DeleteConflict.Policy.Version.DefaultYou cannot delete the default policy version.You cannot delete the default policy version.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history