调用CreatePolicyVersion接口为权限策略创建新的版本。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreatePolicyVersion

系统规定参数。取值：CreatePolicyVersion。

PolicyName String 是 OSS-Administrator

权限策略名称。
PolicyDocument String 是 {"Statement":[{"Action":["oss:*"],"Effect":"Allow","Resource":["acs:oss:*:*:*"]}],"Version":"1"}

权限策略内容，最大长度6144字节。
SetAsDefault Boolean 否 false

是否设置为默认权限策略，默认值为false。

RotateStrategy String 否 None

权限策略版本自动化轮转机制，可以删除历史权限策略版本。

目前包含：

  • None：关闭轮转机制。
  • DeleteOldestNonDefaultVersionWhenLimitExceeded：当权限策略版本数量超限时，删除最早且非活跃的版本。

默认值：None。

返回数据

名称 类型 示例值 描述
PolicyVersion Object

新建的权限策略版本的信息。
IsDefaultVersion Boolean false

是否默认版本。
PolicyDocument String { "Statement": [{ "Action": ["oss:*"], "Effect": "Allow", "Resource": ["acs:oss:*:*:*"]}], "Version": "1"}

权限策略内容。
VersionId String v3

权限策略标识。
CreateDate String 2015-01-23T12:33:18Z

创建时间。
RequestId String 9B34724D-54B0-4A51-B34D-4512372FE1BE

请求ID。

示例

请求示例

https://ram.aliyuncs.com/?Action=CreatePolicyVersion
&PolicyName=OSS-Administrator
&PolicyDocument={"Statement":[{"Action":["oss:*"],"Effect":"Allow","Resource":["acs:oss:*:*:*"]}],"Version":"1"}
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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\"}"
  }
}

错误码

访问错误中心查看更多错误码。