調用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. 權限策略版本數超出限制。

訪問錯誤中心查看更多錯誤碼。