调用CreatePolicyVersion创建权限策略版本。

调试

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

请求参数

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

要执行的操作。取值:CreatePolicyVersion。

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

权限策略内容。

长度为1~2048个字符。

PolicyName String OSS-Administrator

权限策略名称。

长度为1~128个字符,可包含英文字母、数字和短横线(-)。

SetAsDefault Boolean false

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

  • false:不设置为默认权限策略。
  • true:设置为默认权限策略。

返回数据

名称 类型 示例值 描述
PolicyVersion Struct

权限策略版本信息。

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

权限策略版本创建时间。

IsDefaultVersion Boolean false

是否为权限策略默认版本。

VersionId String v3

权限策略版本标识。

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

请求ID。

示例

请求示例

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

正常返回示例

XML 格式

<CreatePolicyVersionResponse>
	  <RequestId>9B34724D-54B0-4A51-B34D-4512372FE1BE</RequestId>
	  <PolicyVersion>
		    <VersionId>v3</VersionId>
		    <IsDefaultVersion>false</IsDefaultVersion>
		    <CreateDate>2015-01-23T12:33:18Z</CreateDate>
	  </PolicyVersion>
</CreatePolicyVersionResponse>

JSON 格式

{
    "RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE",
    "PolicyVersion": {
        "VersionId": "v3",
        "IsDefaultVersion": false,
        "CreateDate": "2015-01-23T12:33:18Z"
    }
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameter.PolicyName.InvalidChars 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. 策略名称长度不符合要求。策略名称长度必须在1~64个字符之间。
404 EntityNotExist.Policy The policy does not exist. 权限策略不存在。
409 LimitExceeded.Policy.Version The maximum number of policy versions is exceeded. 权限策略版本数超出限制。

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