调用GetPolicyVersion获取某个权限策略的版本。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| PolicyType |
string |
是 |
权限策略类型。取值:
|
Custom |
| PolicyName |
string |
是 |
权限策略名称。 长度为 1~128 个字符,可包含英文字母、数字和短横线(-)。 |
OSS-Administrator |
| VersionId |
string |
是 |
权限策略版本标识。 |
v3 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| PolicyVersion |
object |
权限策略版本信息。 |
|
| 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 |
请求 ID。 |
9B34724D-54B0-4A51-B34D-4512372FE1BE |
示例
正常返回示例
JSON格式
{
"PolicyVersion": {
"CreateDate": "2015-01-23T12:33:18Z",
"IsDefaultVersion": false,
"PolicyDocument": "{ \\\"Statement\\\": [{ \\\"Action\\\": [\\\"oss:*\\\"], \\\"Effect\\\": \\\"Allow\\\", \\\"Resource\\\": [\\\"acs:oss:*:*:*\\\"]}], \\\"Version\\\": \\\"1\\\"}",
"VersionId": "v3"
},
"RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 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 128 characters in length. | 策略名称长度不符合要求。策略名称长度必须在1~128个字符之间。 |
| 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. | 权限策略版本不存在。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。