All Products
Search

This Product

    Resource Management:CreatePolicyVersion

    Document Center

    Resource Management:CreatePolicyVersion

    Last Updated:Sep 01, 2026

    Creates a version of an access policy by calling CreatePolicyVersion.

    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

    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
    PolicyDocument

    string

    Yes

    The content of the access policy.

    The content must be 1 to 6,144 characters in length.

    { "Statement": [{ "Action": ["oss:*"], "Effect": "Allow", "Resource": ["acs:oss:*:*:*"]}], "Version": "1"}
    SetAsDefault

    boolean

    No

    Specifies whether to set the version as the default access policy version.

    Valid values:

    • false (default): Does not set the version as the default access policy version.

    • true: Sets the version as the default access policy version.

    false

    Response elements

    Element

    Type

    Description

    Example

    object

    PolicyVersion

    object

    The access policy version information.

    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.

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

    Examples

    Success response

    JSON format

    {
  "PolicyVersion": {
    "CreateDate": "2015-01-23T12:33:18",
    "IsDefaultVersion": false,
    "VersionId": "v3"
  },
  "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.PolicyDocument.Length The maximum length of the policy document is exceeded. It must not exceed 6144 characters.
    404 EntityNotExist.Policy The policy does not exist. The policy does not exist.
    409 LimitExceeded.Policy.Version The maximum number of policy versions is exceeded. The maximum number of policy versions is exceeded.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.