调用GetPolicy获取指定的权限策略信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetPolicy |
要执行的操作。取值:GetPolicy。 |
PolicyName | String | 是 | OSS-Administrator |
权限策略名称。 长度为1~128个字符,可包含英文字母、数字和短横线(-)。 |
PolicyType | String | 是 | Custom |
权限策略类型。
|
Language | String | 否 | zh-CN |
语言类型。系统权限策略的描述将以此语言返回。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Policy | Struct |
权限策略信息。 |
|
AttachmentCount | Integer | 0 |
引用次数。 |
CreateDate | String | 2015-01-23T12:33:18Z |
权限策略创建时间。 |
DefaultVersion | String | v1 |
权限策略默认版本。 |
Description | String | OSS管理员权限 |
权限策略描述。 |
PolicyDocument | String | { "Statement": [{ "Action": ["oss:*"], "Effect": "Allow", "Resource": ["acs:oss:*:*:*"]}], "Version": "1"} |
权限策略内容。 |
PolicyName | String | OSS-Administrator |
权限策略名称。 |
PolicyType | String | Custom |
权限策略类型。
|
UpdateDate | String | 2016-01-23T12:33:18Z |
权限策略更新时间。 |
RequestId | String | 697852FB-50D7-44D9-9774-530C31EAC572 |
请求ID。 |
示例
请求示例
https://resourcemanager.aliyuncs.com/?Action=GetPolicy
&PolicyName=OSS-Administrator
&PolicyType=Custom
&<公共请求参数>
正常返回示例
XML
格式
<GetPolicyResponse>
<RequestId>697852FB-50D7-44D9-9774-530C31EAC572</RequestId>
<Policy>
<PolicyName>OSS-Administrator</PolicyName>
<PolicyType>Custom</PolicyType>
<Description>OSS管理员权限</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管理员权限",
"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. | 无效的权限策略类型。 |
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. | 权限策略不存在。 |
访问错误中心查看更多错误码。