調(diào)用CreatePolicy創(chuàng)建一個權(quán)限策略。

調(diào)試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 CreatePolicy

要執(zhí)行的操作。取值：CreatePolicy。
PolicyDocument String 是 { "Statement": [{ "Action": ["oss:*"], "Effect": "Allow", "Resource": ["acs:oss:*:*:*"]}], "Version": "1"}

權(quán)限策略內(nèi)容。

長度為1~2048個字符。
PolicyName String 是 OSS-Administrator

權(quán)限策略名稱。

長度為1~128個字符，可包含英文字母、數(shù)字和短劃線（-）。
Description String 否 OSS管理員權(quán)限

權(quán)限策略描述。

長度為1~1024個字符。

返回數(shù)據(jù)

名稱 類型 示例值 描述
Policy Struct

權(quán)限策略信息。
CreateDate String 2015-01-23T12:33:18Z

權(quán)限策略創(chuàng)建時間。
DefaultVersion String v1

權(quán)限策略版本號。默認值：v1。
Description String OSS管理員權(quán)限

權(quán)限策略描述。
PolicyName String OSS-Administrator

權(quán)限策略名稱。
PolicyType String Custom

權(quán)限策略類型。

  • Custom：自定義策略。
  • System：系統(tǒng)策略。
RequestId String 9B34724D-54B0-4A51-B34D-4512372FE1BE

請求ID。

示例

請求示例

https://resourcemanager.aliyuncs.com/?Action=CreatePolicy
&PolicyDocument={ "Statement": [{ "Action": ["oss:*"], "Effect": "Allow", "Resource": ["acs:oss:*:*:*"]}], "Version": "1"}
&PolicyName=OSS-Administrator
&<公共請求參數(shù)>

正常返回示例

XML 格式 

<CreatePolicyResponse>
	  <RequestId>9B34724D-54B0-4A51-B34D-4512372FE1BE</RequestId>
	  <Policy>
		    <PolicyName>OSS-Administrator</PolicyName>
		    <PolicyType>Custom</PolicyType>
		    <Description>OSS管理員權(quán)限</Description>
		    <DefaultVersion>v1</DefaultVersion>
		    <CreateDate>2015-01-23T12:33:18Z</CreateDate>
	  </Policy>
</CreatePolicyResponse>

JSON 格式 

{
    "RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE",
    "Policy": {
        "PolicyName": "OSS-Administrator",
        "PolicyType": "Custom",
        "Description": "OSS管理員權(quán)限",
        "DefaultVersion": "v1",
        "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 (-). 策略名稱包含非法字符。策略名稱僅可包含大小寫字母、數(shù)字以及中劃線（-）。
400 InvalidParameter.PolicyName.Length The length of the policy name is invalid. It must be 1 to 128 characters in length. 策略名稱長度不符合要求。策略名稱長度必須在1~128個字符之間。
400 InvalidParameter.PolicyDocument.Length The maximum length of the policy document is exceeded. It must not exceed 2048 characters. 權(quán)限策略內(nèi)容長度超限。權(quán)限策略長度不得長于2048個字符。
400 InvalidParameter.Description.Length The maximum length of the description is exceeded. It must not exceed 1024 characters. 描述長度超限。最大不得超過1024個字符。
409 MalformedPolicyDocument The policy format is invalid. 策略格式錯誤。
409 EntityAlreadyExists.Policy The policy already exists. 權(quán)限策略已存在。
409 LimitExceeded.Policy The maximum number of policies is exceeded. 權(quán)限策略數(shù)超出限制。

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