All Products
Search
Document Center

Resource Management:SetDefaultPolicyVersion

Last Updated:Aug 28, 2026

Sets the default version of a permission policy.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

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

VersionId

string

Yes

The ID of the policy version.

v2

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

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

Examples

Success response

JSON format

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

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.
400 InvalidParameter.VersionId.Format The specified version ID is invalid. The specified version ID is invalid.
404 EntityNotExist.Policy The policy does not exist. The policy does not exist.
404 EntityNotExist.Policy.Version The policy version does not exist. The policy version does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.