调用ListRoles接口列出角色。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListRoles

系统规定参数。取值:ListRoles。

Marker String EXAMPLE

当请求的返回结果被截断时,可以使用Marker获取从当前截断位置之后的内容。

MaxItems Integer 100

返回结果的条数。当返回结果达到MaxItems限制被截断时,返回参数IsTruncated将等于true

取值范围:1 ~ 1000。默认值:100。

返回数据

名称 类型 示例值 描述
IsTruncated Boolean true

请求返回结果是否被截断。

Marker String EXAMPLE

IsTruncatedtrue时才有此字段。当返回true时,需要继续调用此接口,并且使用Marker获取截断后的内容。

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"
            }
        ]
    }
}

错误码

访问错误中心查看更多错误码。