Queries the versions of an access policy.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| PolicyType |
string |
Yes |
The type of the access policy. Valid values:
|
Custom |
| PolicyName |
string |
Yes |
Policy Name of the access policy. Policy Name must be 1 to 128 characters in length and can contain letters, digits, and hyphens (-). |
OSS-Administrator |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| PolicyVersions |
object |
||
| PolicyVersion |
array<object> |
The information about the access policy versions. |
|
|
object |
The information about the access policy versions. |
||
| CreateDate |
string |
The time when the access policy version was created. The time is in RFC 3339 UTC format, indicated by Z. |
2015-01-23T12:33:18Z |
| IsDefaultVersion |
boolean |
Indicates whether the version is the default version of the access policy. |
false |
| VersionId |
string |
The ID of the access policy version. |
v3 |
| RequestId |
string |
The request ID. |
7B8A4E7D-6CFF-471D-84DF-195A7A241ECB |
Examples
Success response
JSON format
{
"PolicyVersions": {
"PolicyVersion": [
{
"CreateDate": "2015-01-23T12:33:18Z",
"IsDefaultVersion": false,
"VersionId": "v3"
}
]
},
"RequestId": "7B8A4E7D-6CFF-471D-84DF-195A7A241ECB"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter.PolicyType | The specified policy type is invalid. | 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 (-). | 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. | |
| 404 | EntityNotExist.Policy | The policy does not exist. | The policy does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.