使用ListUsers查询RAM用户列表-访问控制-阿里云

查询所有RAM用户的详细信息。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ram:ListUsers

get

*User

acs:ram:*:{#accountId}:user/*

无

请求参数

名称	类型	必填	描述	示例值
Marker	string	否	当请求的返回结果被截断时，可以使用`Marker`获取从当前截断位置之后的内容。	EXAMPLE
MaxItems	integer	否	返回结果的条数，当返回结果达到 MaxItems 限制被截断时，返回参数`IsTruncated`将等于`true`。取值范围：1~1000。默认值：100。	100

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	4B450CA1-36E8-4AA2-8461-86B42BF4CC4E
IsTruncated	boolean	请求返回结果是否被截断。	true
Marker	string	当`IsTruncated`为`true`时才有此字段，当返回`true`时，需要继续调用此接口，并且使用`Marker`获取截断后的内容。	EXAMPLE
Users	object
User	array<object>	RAM 用户列表。
	object	RAM 用户信息。
DisplayName	string	RAM 用户的显示名称。	张*
Email	string	RAM 用户邮箱。说明暂不提供该参数。	zhangq****@example.com
UpdateDate	string	RAM 用户的更新时间（UTC 时间）。	2015-01-23T12:33:18Z
MobilePhone	string	RAM 用户手机号码。说明暂不提供该参数。	86-1860000****
UserId	string	RAM 用户 ID。	20732900249392****
Comments	string	备注。	这是一位云计算工程师
CreateDate	string	RAM 用户的创建时间（UTC 时间）。	2015-01-23T12:33:18Z
UserName	string	RAM 用户的登录名称。	zhangq****

示例

正常返回示例

JSON格式

{
  "RequestId": "4B450CA1-36E8-4AA2-8461-86B42BF4CC4E",
  "IsTruncated": true,
  "Marker": "EXAMPLE",
  "Users": {
    "User": [
      {
        "DisplayName": "张*",
        "Email": "zhangq****@example.com",
        "UpdateDate": "2015-01-23T12:33:18Z",
        "MobilePhone": "86-1860000****",
        "UserId": "20732900249392****",
        "Comments": "这是一位云计算工程师",
        "CreateDate": "2015-01-23T12:33:18Z",
        "UserName": "zhangq****"
      }
    ]
  }
}

异常返回示例

JSON格式

{
  "RequestId" : "4B450CA1-36E8-4AA2-8461-86B42BF4CC4E",
  "IsTruncated": true,
  "Marker": "EXAMPLE",
  "Users" : {
    "User" : [
      {
        "UserId" : "1227489245380721",
        "UserName" : "zhangqiang",
        "DisplayName": "张强",
        "MobilePhone": "86-18600008888",
        "Email": "zhangqiang@example.com",
        "Comments": "这是一位云计算工程师",
        "CreateDate" : "2015-01-23T12:33:18Z",
        "UpdateDate" : "2015-01-23T12:33:18Z"
      },
      {
        "UserId" : "1406498224724456",
        "UserName" : "lili",
        "DisplayName": "李丽",
        "MobilePhone": "86-18600009999",
        "Email": "lili@example.com",
        "Comments": "权限管理员",
        "CreateDate" : "2015-02-18T17:22:08Z",
        "UpdateDate" : "2015-02-18T17:22:08Z"
      }
    ]
  }
}

错误码

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

变更历史

更多信息，参考变更详情。