Queries the list of all RAM roles.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ListRoles |
The operation that you want to perform. Set the value to ListRoles. |
Marker | String | No | EXAMPLE |
The |
MaxItems | Integer | No | 100 |
The number of entries to return. If a response is truncated because it reaches the
value of Valid values: 1 to 1000. Default value: 100. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
IsTruncated | Boolean | true |
Indicates whether the response is truncated. |
Marker | String | EXAMPLE |
The marker. This parameter is returned only if the value of |
RequestId | String | 7B8A4E7D-6CFF-471D-84DF-195A7A241ECB |
The ID of the request. |
Roles | Array |
The information of RAM roles. |
|
Role | |||
Arn | String | acs:ram::123456789012****:role/ECSAdmin |
The Alibaba Cloud Resource Name (ARN) of the RAM role. |
CreateDate | String | 2015-01-23T12:33:18Z |
The time when the RAM role was created. |
Description | String | ECS administrator |
The description of the RAM role. |
MaxSessionDuration | Long | 3600 |
The maximum session duration of the RAM role. |
RoleId | String | 901234567890**** |
The ID of the RAM role. |
RoleName | String | ECSAdmin |
The name of the RAM role. |
UpdateDate | String | 2015-01-23T12:33:18Z |
The time when the RAM role was modified. |
Examples
Sample requests
https://ram.aliyuncs.com/?Action=ListRoles
&<Common request parameters>
Sample success responses
XML
format
<ListRolesResponse>
<RequestId>7B8A4E7D-6CFF-471D-84DF-195A7A241ECB</RequestId>
<IsTruncated>true</IsTruncated>
<Marker>EXAMPLE</Marker>
<Roles>
<Role>
<RoleId>901234567890****</RoleId>
<RoleName>ECSAdmin</RoleName>
<Arn>acs:ram::123456789012****:role/ECSAdmin</Arn>
<Description>ECS administrator</Description>
<MaxSessionDuration>3600</MaxSessionDuration>
<CreateDate>2015-01-23T12:33:18Z</CreateDate>
<UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
</Role>
<Role>
<RoleId>901234567890****</RoleId>
<RoleName>OSSReadonlyAccess</RoleName>
<Arn>acs:ram::123456789012****:role/ECSAdmin</Arn>
<Description>OSS read-only access</Description>
<MaxSessionDuration>3600</MaxSessionDuration>
<CreateDate>2015-01-23T12:33:18Z</CreateDate>
<UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
</Role>
</Roles>
</ListRolesResponse>
JSON
format
{
"RequestId": "7B8A4E7D-6CFF-471D-84DF-195A7A241ECB",
"IsTruncated": true,
"Marker": "EXAMPLE",
"Roles": {
"Role": [
{
"RoleId": "901234567890****",
"RoleName": "ECSAdmin",
"Arn": "acs:ram::123456789012****:role/ECSAdmin",
"Description": "ECS administrator",
"MaxSessionDuration": 3600,
"CreateDate": "2015-01-23T12:33:18Z",
"UpdateDate": "2015-01-23T12:33:18Z"
},
{
"RoleId": "901234567890****",
"RoleName": "OSSReadonlyAccess",
"Arn": "acs:ram::123456789012****:role/OSSReadonlyAccess",
"Description": "OSS read-only access",
"MaxSessionDuration": 3600,
"CreateDate": "2015-01-23T12:33:18Z",
"UpdateDate": "2015-01-23T12:33:18Z"
}
]
}
}
Error codes
For a list of error codes, visit the API Error Center.