調(diào)用GetPolicy獲取指定的權(quán)限策略信息。

調(diào)試

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

請求參數(shù)

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

要執(zhí)行的操作。取值：GetPolicy。
PolicyName String 是 OSS-Administrator

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

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

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

  • Custom：自定義策略。
  • System：系統(tǒng)策略。
Language String 否 zh-CN

語言類型。系統(tǒng)權(quán)限策略的描述將以此語言返回。

  • en：英文。
  • zh-CN：中文。
  • ja：日文。

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

名稱 類型 示例值 描述
Policy Struct

權(quán)限策略信息。
AttachmentCount Integer 0

引用次數(shù)。
CreateDate String 2015-01-23T12:33:18Z

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

權(quán)限策略默認(rèn)版本。
Description String OSS管理員權(quán)限

權(quán)限策略描述。
PolicyDocument String { "Statement": [{ "Action": ["oss:*"], "Effect": "Allow", "Resource": ["acs:oss:*:*:*"]}], "Version": "1"}

權(quán)限策略內(nèi)容。
PolicyName String OSS-Administrator

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

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

  • Custom：自定義策略。
  • System：系統(tǒng)策略。
UpdateDate String 2016-01-23T12:33:18Z

權(quán)限策略更新時間。
RequestId String 697852FB-50D7-44D9-9774-530C31EAC572

請求ID。

示例

請求示例

https://resourcemanager.aliyuncs.com/?Action=GetPolicy
&PolicyName=OSS-Administrator
&PolicyType=Custom
&<公共請求參數(shù)>

正常返回示例

XML 格式 

<GetPolicyResponse>
	  <RequestId>697852FB-50D7-44D9-9774-530C31EAC572</RequestId>
	  <Policy>
		    <PolicyName>OSS-Administrator</PolicyName>
		    <PolicyType>Custom</PolicyType>
		    <Description>OSS管理員權(quán)限</Description>
		    <DefaultVersion>v1</DefaultVersion>
		    <PolicyDocument>{ "Statement": [{ "Action": ["oss:*"], "Effect": "Allow", "Resource": ["acs:oss:*:*:*"]}], "Version": "1"}</PolicyDocument>
		    <CreateDate>2015-01-23T12:33:18Z</CreateDate>
		    <UpdateDate>2016-01-23T12:33:18Z</UpdateDate>
		    <AttachmentCount>0</AttachmentCount>
	  </Policy>
</GetPolicyResponse>

JSON 格式 

{
    "RequestId": "697852FB-50D7-44D9-9774-530C31EAC572",
    "Policy": {
        "PolicyName": "OSS-Administrator",
        "PolicyType": "Custom",
        "Description": "OSS管理員權(quán)限",
        "DefaultVersion": "v1",
        "PolicyDocument": "{ \"Statement\": [{ \"Action\": [\"oss:*\"], \"Effect\": \"Allow\", \"Resource\": [\"acs:oss:*:*:*\"]}], \"Version\": \"1\"}",
        "CreateDate": "2015-01-23T12:33:18Z",
        "UpdateDate": "2016-01-23T12:33:18Z",
        "AttachmentCount": 0
    }
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InvalidParameter.PolicyType The specified policy type is invalid. 無效的權(quán)限策略類型。
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 64 characters in length. 策略名稱長度不符合要求。策略名稱長度必須在1~64個字符之間。
404 EntityNotExist.Policy The policy does not exist. 權(quán)限策略不存在。

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