Creates a version for a policy.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreatePolicyVersion

The operation that you want to perform. Set the value to CreatePolicyVersion.

PolicyName String Yes OSS-Administrator

The name of the policy.

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

The document of the policy. The document can be up to 6,144 bytes in length.

SetAsDefault Boolean No false

Specifies whether to set this policy as the default policy. Default value: false.

RotateStrategy String No None

The rotation strategy of the policy. The rotation strategy can be used to delete an early policy version.

Valid values:

  • None: disables the rotation strategy.
  • DeleteOldestNonDefaultVersionWhenLimitExceeded: deletes the earliest non-active version if the number of versions exceeds the limit.

Default value: None.

Response parameters

Parameter Type Example Description
PolicyVersion Object

The information about the policy version.

IsDefaultVersion Boolean false

Indicates whether the policy version is the default version.

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

The document of the policy.

VersionId String v3

The ID of the policy version.

CreateDate String 2015-01-23T12:33:18Z

The time when the policy version was created.

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

The ID of the request.


Sample requests
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK

        <PolicyDocument>{ "Statement": [{ "Action": ["oss:*"], "Effect": "Allow", "Resource": ["acs:oss:*:*:*"]}], "Version": "1"}</PolicyDocument>

JSON format

HTTP/1.1 200 OK

  "RequestId" : "9B34724D-54B0-4A51-B34D-4512372FE1BE",
  "PolicyVersion" : {
    "VersionId" : "v3",
    "IsDefaultVersion" : false,
    "CreateDate" : "2015-01-23T12:33:18Z",
    "PolicyDocument" : "{ \"Statement\": [{ \"Action\": [\"oss:*\"], \"Effect\": \"Allow\", \"Resource\": [\"acs:oss:*:*:*\"]}], \"Version\": \"1\"}"

Error codes

For a list of error codes, visit the API Error Center.