创建用户
更新时间：2026-07-14
创建用户
- 在用户池中创建本地用户。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/agent-identity/user-pool/user/create HTTP/1.1
2Host: identity.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| userPoolId | String | 是 | RequestBody参数 | 用户池 ID |
| username | String | 是 | RequestBody参数 | 用户名（1-64字符，仅允许字母、数字、_.@-） |
| displayName | String | 否 | RequestBody参数 | 显示名称（最多64字符） |
| description | String | 否 | RequestBody参数 | 用户描述（最多128字符） |
| password | String | 否 | RequestBody参数 | 用户密码（8-32字符）；不传则用户无密码，仅能通过 IdP 登录 |
| forceResetPassword | Boolean | 否 | RequestBody参数 | 是否强制用户首次登录时重置密码，默认 false |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 用户 ID |
| username | String | 用户名 |
| displayName | String | 显示名称 |
| description | String | 描述 |
| source | String | 来源：MANUAL / AUTO |
| hasPassword | Boolean | 是否已设置密码 |
| createdAt | DateTime | 创建时间 |
请求示例
Plain Text
1{
2 "userPoolId": "01961a2b3c4d5e6f7890abcdef123456",
3 "username": "zhangsan",
4 "displayName": "张三",
5 "description": "测试用户",
6 "password": "MyP@ssw0rd"
7}返回示例
Plain Text
1{
2 "id": "01961b2c3d4e5f6a7890bcdef1234567",
3 "username": "zhangsan",
4 "displayName": "张三",
5 "description": "测试用户",
6 "source": "MANUAL",
7 "hasPassword": true,
8 "createdAt": "2025-06-01T00:00:00Z"
9}评价此篇文章