調用GetPolicyVersion獲取某個權限策略的版本。

調試

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

請求參數

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

要執行的操作。取值：GetPolicyVersion。
PolicyName String 是 OSS-Administrator

權限策略名稱。

長度為1~128個字符，可包含英文字母、數字和短橫線（-）。
PolicyType String 是 Custom

權限策略類型。

  • Custom：自定義策略。
  • System：系統策略。
VersionId String 是 v3

權限策略版本標識。

返回數據

名稱 類型 示例值 描述
PolicyVersion Struct

權限策略版本信息。
CreateDate String 2015-01-23T12:33:18Z

權限策略版本創建時間。
IsDefaultVersion Boolean false

是否為權限策略默認版本。
PolicyDocument String { \"Statement\": [{ \"Action\": [\"oss:*\"], \"Effect\": \"Allow\", \"Resource\": [\"acs:oss:*:*:*\"]}], \"Version\": \"1\"}

權限策略內容。
VersionId String v3

權限策略版本標識。
RequestId String 9B34724D-54B0-4A51-B34D-4512372FE1BE

請求ID。

示例

請求示例

https://resourcemanager.aliyuncs.com/?Action=GetPolicyVersion
&PolicyName=OSS-Administrator
&PolicyType=Custom
&VersionId=v3
&<公共請求參數>

正常返回示例

XML 格式 

<GetPolicyVersionResponse>
	  <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>
</GetPolicyVersionResponse>

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

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InvalidParameter.PolicyType The specified policy type is invalid. 無效的權限策略類型。
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個字符之間。
400 InvalidParameter.VersionId.Format The specified version ID is invalid. 權限策略版本ID格式錯誤。
404 EntityNotExist.Policy The policy does not exist. 權限策略不存在。
404 EntityNotExist.Policy.Version The policy version does not exist. 權限策略版本不存在。

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