全部产品
Search
文档中心

资源管理:ListRoles - 查看角色列表

更新时间:Aug 27, 2026

调用ListRoles查看角色列表。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

PageNumber

integer

页码。

起始值:1。默认值:1。

1

PageSize

integer

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

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

10

Language

string

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

  • en:英文。

  • zh-CN:中文。

  • ja:日文。

zh-CN

返回参数

名称

类型

描述

示例值

object

PageNumber

integer

页码。

1

PageSize

integer

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

10

RequestId

string

请求 ID。

7B8A4E7D-6CFF-471D-84DF-195A7A241ECB

Roles

object

Role

array<object>

角色信息。

array<object>

角色信息。

Arn

string

角色的资源描述符。

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

CreateDate

string

角色创建时间。

2015-01-23T12:33:18Z

Description

string

角色描述。

ECS管理角色

IsServiceLinkedRole

boolean

是否服务关联角色。

true

LatestDeletionTask

object

最近一次删除任务信息。

CreateDate

string

删除任务创建时间。

2018-10-23T12:33:18Z

DeletionTaskId

string

删除任务 ID。

ECSAdmin/cc61514b-26eb-4453-ab53-b142eb70****

MaxSessionDuration

integer

角色最大会话时间。

3600

RoleId

string

角色 ID。

90123456789****

RoleName

string

角色名称。

ECSAdmin

RolePrincipalName

string

被授权角色名称。

ECSAdmin@role.123456.onaliyunservice.com

UpdateDate

string

角色更新时间。

2016-01-23T12:33:18Z

TotalCount

integer

角色总个数。

2

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息,参考变更详情