调用ListRoles接口获取角色列表-资源管理-阿里云

调用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	array<object>	角色信息。
Role	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	long	角色最大会话时间。	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
}

错误码

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史