重置密码
更新时间：2026-07-14
重置密码
- 管理员为指定用户重置密码，或用户自行修改密码。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/agent-identity/user-pool/user/resetPassword HTTP/1.1
2Host: identity.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| userPoolId | String | 是 | RequestBody参数 | 用户池 ID |
| userId | String | 是 | RequestBody参数 | 用户 ID |
| newPassword | String | 是 | RequestBody参数 | 新密码（8-32字符，须含大写、小写、数字） |
| password | String | 否 | RequestBody参数 | 当前密码；传入时校验当前密码，适用于用户自行修改场景；不传则为管理员重置，跳过校验 |
| forceResetPassword | Boolean | 否 | RequestBody参数 | 是否强制用户下次登录时重置密码，默认 true |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
无 body
请求示例
Plain Text
1{
2 "userPoolId": "01961a2b3c4d5e6f7890abcdef123456",
3 "userId": "01961b2c3d4e5f6a7890bcdef1234567",
4 "newPassword": "NewP@ssw0rd",
5 "forceResetPassword": true
6}返回示例
Plain Text
1HTTP/1.1 200 OK评价此篇文章