Creates a version for a policy.


Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

Parameter Type Required? Example value Description
Action String Yes CreatePolicyVersion

The name of this action.

Value: CreatePolicyVersion

PolicyDocument String Yes {"Statement":[{"Action":["oss:*"],"Effect":"Allow","Resource":["acs:oss:*:*:*"]}],"Version":"1"} The policy content. It can be up to 2048 bytes.
PolicyName String Yes OSS-Administrator The policy name.
RotateStrategy String No None

The rotation stategy of a policy. You can set this parameter to delete an existing policy.

Vaild values:

  • None: indicates no rotation strategy is set
  • DeleteOldestNonDefaultVersionWhenLimitExceeded: indicates the earliest and non-active version can be deleted when the number of versions exceeds the limit

Default value: None

SetAsDefault Boolean No false

Indicates whether to set the version as the default version of the policy.

Default value: false

Response parameters

Parameter Type Example value Description
PolicyVersion N/A N/A The information about the policy version.
CreateDate String 2015-01-23T12:33:18Z The date and time when the policy version was created.
IsDefaultVersion Boolean false Indicates whether the version is the default version of the policy.
PolicyDocument String { "Statement": [{ "Action": ["oss:*"], "Effect": "Allow", "Resource": ["acs:oss:*:*:*"]}], "Version": "1"} The policy content.
VersionId String v3 The ID of the policy version.
RequestId String 9B34724D-54B0-4A51-B34D-4512372FE1BE The request ID.


Request example
&<Common parameters>

Response example

XML format

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

JSON format

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


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