调用ListRoles查看角色列表。

调试

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

请求参数

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

要执行的操作。取值：ListRoles。
PageNumber Integer 否 1

页码。

起始值：1。默认值：1。
PageSize Integer 否 10

分页时每页显示的数据行数。

取值范围：1~100。默认值：10。
Language String 否 zh-CN

语言类型。角色描述将以此语言返回。

  • en：英文。
  • zh-CN：中文。
  • ja：日文。

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

页码。
PageSize Integer 10

分页时每页显示的数据行数。
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管理角色

角色描述。
IsServiceLinkedRole Boolean true

是否服务关联角色。
LatestDeletionTask Struct

最近一次删除任务信息。
CreateDate String 2018-10-23T12:33:18Z

删除任务创建时间。
DeletionTaskId String ECSAdmin/cc61514b-26eb-4453-ab53-b142eb70****

删除任务ID。
MaxSessionDuration Long 3600

角色最大会话时间。
RoleId String 90123456789****

角色ID。
RoleName String ECSAdmin

角色名称。
RolePrincipalName String ECSAdmin@role.123456.onaliyunservice.com

被授权角色名称。
UpdateDate String 2016-01-23T12:33:18Z

角色更新时间。
TotalCount Integer 2

角色总个数。

示例

请求示例

https://resourcemanager.aliyuncs.com/?Action=ListRoles
&<公共请求参数>

正常返回示例

XML 格式 

<ListRolesResponse>
	  <RequestId>7B8A4E7D-6CFF-471D-84DF-195A7A241ECB</RequestId>
	  <PageNumber>1</PageNumber>
	  <PageSize>10</PageSize>
	  <TotalCount>2</TotalCount>
	  <Roles>
		    <Role>
			      <RoleId>90123456789****</RoleId>
			      <RoleName>ECSAdmin</RoleName>
			      <RolePrincipalName>ECSAdmin@role.123456.onaliyunservice.com</RolePrincipalName>
			      <Arn>acs:ram::123456789012****:role/ECSAdmin</Arn>
			      <IsServiceLinkedRole>true</IsServiceLinkedRole>
			      <LatestDeletionTask>
				        <CreateDate>2018-10-23T12:33:18Z</CreateDate>
				        <DeletionTaskId>ECSAdmin/cc61514b-26eb-4453-ab53-b142eb70****</DeletionTaskId>
			      </LatestDeletionTask>
			      <Description>ECS管理角色</Description>
                  <MaxSessionDuration>3600</MaxSessionDuration>
			      <CreateDate>2015-01-23T12:33:18Z</CreateDate>
			      <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
		    </Role>
		    <Role>
			      <RoleId>90123456789****</RoleId>
			      <RoleName>OSSReadonlyAccess</RoleName>
			      <RolePrincipalName>OSSReadonlyAccess@role.123456.onaliyunservice.com</RolePrincipalName>
			      <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",
	"PageNumber": 1,
	"PageSize": 10,
	"TotalCount": 2,
	"Roles": {
		"Role": [{
				"RoleId": "90123456789****",
				"RoleName": "ECSAdmin",
				"RolePrincipalName": "ECSAdmin@role.123456.onaliyunservice.com",
				"Arn": "acs:ram::123456789012****:role/ECSAdmin",
				"IsServiceLinkedRole": true,
				"LatestDeletionTask": {
					"CreateDate": "2018-10-23T12:33:18Z",
					"DeletionTaskId": "ECSAdmin/cc61514b-26eb-4453-ab53-b142eb70****"
				},
				"Description": "ECS管理角色",
                "MaxSessionDuration": 3600,
				"CreateDate": "2015-01-23T12:33:18Z",
				"UpdateDate": "2015-01-23T12:33:18Z"
			},
			{
				"RoleId": "90123456789****",
				"RoleName": "OSSReadonlyAccess",
				"RolePrincipalName": "OSSReadonlyAccess@role.123456.onaliyunservice.com",
				"Arn": "acs:ram::123456789012****:role/OSSReadonlyAccess",
				"Description": "OSS只读访问角色",
                "MaxSessionDuration": 3600,
				"CreateDate": "2015-01-23T12:33:18Z",
				"UpdateDate": "2015-01-23T12:33:18Z"
			}
		]
	}
}

错误码

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