调用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

角色信息。

Arn String acs:ram::123456789012****:role/ECSAdmin

角色的资源描述符。

CreateDate String 2015-01-23T12:33:18Z

创建时间。

Description String ECS管理角色

角色的备注。

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>
                  <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>
                  <CreateDate>2015-01-23T12:33:18Z</CreateDate>
                  <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
            </Role>
      </Roles>
</ListRolesResponse>

JSON 格式

{
	"IsTruncated":true,
	"RequestId":"7B8A4E7D-6CFF-471D-84DF-195A7A241ECB",
	"Roles":{
		"Role":[
			{
				"RoleName":"ECSAdmin",
				"Description":"ECS管理角色",
				"UpdateDate":"2015-01-23T12:33:18Z",
				"Arn":"acs:ram::123456789012****:role/ECSAdmin",
				"CreateDate":"2015-01-23T12:33:18Z",
				"RoleId":"901234567890****"
			},
			{
				"RoleName":"OSSReadonlyAccess",
				"Description":"OSS只读访问角色",
				"UpdateDate":"2015-01-23T12:33:18Z",
				"Arn":"acs:ram::123456789012****:role/OSSReadonlyAccess",
				"CreateDate":"2015-01-23T12:33:18Z",
				"RoleId":"901234567890****"
			}
		]
	},
	"Marker":"EXAMPLE"
}

错误码

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