调用ListUsers查询所有RAM用户的详细信息-访问控制-阿里云

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

接口说明

使用说明

您可以通过以下两个 API 查询所有 RAM 用户的信息，区别如下：

ListUsers：查询 RAM 用户的详细信息。
ListUserBasicInfos：查询 RAM 用户的基本信息，仅包括 RAM 用户登录名称UserPrincipalName、RAM 用户显示名称DisplayName和 RAM 用户 IDUserId。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ram:ListUsers

list

*User

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

无

请求参数

名称	类型	必填	描述	示例值
Marker	string	否	当请求的返回结果被截断时，可以使用`Marker`获取从当前截断位置之后的内容。	EXAMPLE
MaxItems	integer	否	返回结果的条数。当返回结果达到`MaxItems`限制被截断时，返回参数`IsTruncated`将等于 true。取值范围：1~1000。默认值：1000。	1000
Tag	array<object>	否	标签列表，最多包含 20 个子项。
	object	否	标签列表，最多包含 20 个子项。
Key	string	否	标签键。 N 的取值范围：1~20，N 必须连续。	operator
Value	string	否	标签值。 N 的取值范围：1~20，N 必须连续。	alice
Status	string	否	指定查询的用户状态，支持 active，freeze 状态。指定全部状态时使用逗号拼接，如：active,freeze。未指定状态时默认指定 active 状态。当使用 Tag 标签时，默认查询全部状态的用户。	active

返回参数

名称	类型	描述	示例值
	object	返回参数。
RequestId	string	请求 ID。	4B450CA1-36E8-4AA2-8461-86B42BF4CC4E
IsTruncated	boolean	请求返回结果是否被截断。取值： true false	true
Marker	string	此参数在`IsTruncated`为`true`时生效，用于获取截断后的内容。	EXAMPLE
Users	object
User	array<object>	RAM 用户信息。
	array<object>	RAM 用户信息。
DisplayName	string	RAM 用户的显示名称。	test
UserPrincipalName	string	RAM 用户的登录名称。	test@example.onaliyun.com
Email	string	RAM 用户的电子邮箱。说明该参数仅适用于中国站。	alice@example.com
UpdateDate	string	RAM 用户的更新时间（UTC 时间）。	2023-08-21T06:12:47Z
MobilePhone	string	RAM 用户的手机号码。说明该参数仅适用于中国站。	86-1868888****
UserId	string	RAM 用户 ID。	20732900249392****
Comments	string	备注。	This is a cloud computing engineer.
LastLoginDate	string	RAM 用户最近一次登录控制台的时间（时间戳）。	1692598367586
CreateDate	string	RAM 用户的创建时间（UTC 时间）。	2020-08-25T09:23:57Z
ProvisionType	string	同步类型。取值： Manual：在 RAM 中手动创建的 RAM 用户。 SCIM：通过 SCIM 协议同步创建的 RAM 用户。 CloudSSO：通过云 SSO 同步创建的用户。	Manual
Status	string	RAM 用户的用户状态。	active
Tags	object
Tag	array<object>	标签列表。
	object	标签列表。
TagKey	string	标签键。	oparator
TagValue	string	标签值。	alice

示例

正常返回示例

JSON格式

{
  "RequestId": "4B450CA1-36E8-4AA2-8461-86B42BF4CC4E",
  "IsTruncated": true,
  "Marker": "EXAMPLE",
  "Users": {
    "User": [
      {
        "DisplayName": "test",
        "UserPrincipalName": "test@example.onaliyun.com",
        "Email": "alice@example.com",
        "UpdateDate": "2023-08-21T06:12:47Z",
        "MobilePhone": "86-1868888****",
        "UserId": "20732900249392****",
        "Comments": "This is a cloud computing engineer.",
        "LastLoginDate": "1692598367586",
        "CreateDate": "2020-08-25T09:23:57Z",
        "ProvisionType": "Manual",
        "Status": "active",
        "Tags": {
          "Tag": [
            {
              "TagKey": "oparator",
              "TagValue": "alice"
            }
          ]
        }
      }
    ]
  }
}

错误码

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

变更历史

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