All Products
Search
Document Center

Resource Management:ListPolicyVersions

Last Updated:Aug 31, 2026

Queries the versions of an access 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

PolicyType

string

Yes

The type of the access policy. Valid values:

  • Custom: custom policy.

  • System: system policy.

Custom

PolicyName

string

Yes

Policy Name of the access policy.

Policy 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

PolicyVersions

object

PolicyVersion

array<object>

The information about the access policy versions.

object

The information about the access policy versions.

CreateDate

string

The time when the access policy version was created. The time is in RFC 3339 UTC format, indicated by Z.

2015-01-23T12:33:18Z

IsDefaultVersion

boolean

Indicates whether the version is the default version of the access policy.

false

VersionId

string

The ID of the access policy version.

v3

RequestId

string

The request ID.

7B8A4E7D-6CFF-471D-84DF-195A7A241ECB

Examples

Success response

JSON format

{
  "PolicyVersions": {
    "PolicyVersion": [
      {
        "CreateDate": "2015-01-23T12:33:18Z",
        "IsDefaultVersion": false,
        "VersionId": "v3"
      }
    ]
  },
  "RequestId": "7B8A4E7D-6CFF-471D-84DF-195A7A241ECB"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter.PolicyType The specified policy type is invalid. The specified policy type is invalid.
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 64 characters in length.
404 EntityNotExist.Policy The policy does not exist. The policy does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.