批量获取用户
更新时间：2026-07-14
批量获取用户
- 根据用户 ID 列表批量获取用户信息。未找到的 ID 不会出现在结果中（不返回 null）。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/agent-identity/user-pool/user/batch HTTP/1.1
2Host: identity.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| userPoolId | String | 是 | RequestBody参数 | 用户池 ID |
| ids | List |
是 | RequestBody参数 | 用户 ID 列表，最多 100 个 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
List[UserPoolUserDTO](https://cloud.baidu.com/doc/AGENT_ID/s/Nmrk1e73g) 列表
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 用户 ID |
| username | String | 用户名 |
| displayName | String | 显示名称 |
| description | String | 描述 |
| source | String | 来源：MANUAL / AUTO |
| hasPassword | Boolean | 是否已设置密码 |
| createdAt | DateTime | 创建时间 |
请求示例
Plain Text
1{
2 "userPoolId": "01961a2b3c4d5e6f7890abcdef123456",
3 "ids": [
4 "01961b2c3d4e5f6a7890bcdef1234567",
5 "01961b2c3d4e5f6a7890bcdef1234568"
6 ]
7}返回示例
Plain Text
1[
2 {
3 "id": "01961b2c3d4e5f6a7890bcdef1234567",
4 "username": "zhangsan",
5 "displayName": "张三",
6 "description": "测试用户",
7 "source": "MANUAL",
8 "hasPassword": true,
9 "createdAt": "2025-06-01T00:00:00Z"
10 }
11]评价此篇文章