调用ListRoles接口列出角色。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListRoles |
系统规定参数。取值:ListRoles。 |
Marker | String | 否 | EXAMPLE |
当请求的返回结果被截断时,可以使用 |
MaxItems | Integer | 否 | 100 |
返回结果的条数。当返回结果达到 取值范围:1 ~ 1000。默认值:100。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
IsTruncated | Boolean | true |
请求返回结果是否被截断。 |
Marker | String | EXAMPLE |
当 |
RequestId | String | 7B8A4E7D-6CFF-471D-84DF-195A7A241ECB |
请求ID。 |
Roles | Array |
角色信息。 |
|
Role | |||
Arn | String | acs:ram::123456789012****:role/ECSAdmin |
角色的资源描述符。 |
CreateDate | String | 2015-01-23T12:33:18Z |
创建时间。 |
Description | String | ECS管理角色 |
角色描述。 |
MaxSessionDuration | Long | 3600 |
角色最大会话时间。 |
RoleId | String | 901234567890**** |
角色ID。 |
RoleName | String | ECSAdmin |
角色名称。 |
UpdateDate | String | 2015-01-23T12:33:18Z |
更新时间。 |
示例
请求示例
https://ram.aliyuncs.com/?Action=ListRoles
&<公共请求参数>
正常返回示例
XML
格式
<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管理角色</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/OSSReadonlyAccess</Arn>
<Description>OSS只读访问角色</Description>
<MaxSessionDuration>3600</MaxSessionDuration>
<CreateDate>2015-01-23T12:33:18Z</CreateDate>
<UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
</Role>
</Roles>
</ListRolesResponse>
JSON
格式
{
"RequestId": "7B8A4E7D-6CFF-471D-84DF-195A7A241ECB",
"IsTruncated": true,
"Marker": "EXAMPLE",
"Roles": {
"Role": [
{
"RoleId": "901234567890****",
"RoleName": "ECSAdmin",
"Arn": "acs:ram::123456789012****:role/ECSAdmin",
"Description": "ECS管理角色",
"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只读访问角色",
"MaxSessionDuration": 3600,
"CreateDate": "2015-01-23T12:33:18Z",
"UpdateDate": "2015-01-23T12:33:18Z"
}
]
}
}
错误码
访问错误中心查看更多错误码。