修改用户密码
更新时间:2025-04-18
POST
http://{host}/v{version}/user?changePassword
修改指定用户的密码。密码修改规则如下:
- 每个用户可以修改自身的密码,需要验证旧密码,旧密码可以从Authrization头获得。
- 若root用户具备PASSWORD权限,那么root用户可以直接修改其它非root用户的密码,无需验证指定用户的旧密码(相当于直接重置非root用户的密码)。 故,在请求体中,始终无需指定目标用户的旧密码。
权限说明
鉴权认证机制的详细内容请参见鉴权认证
请求参数
Headers 参数
除公共头域外,无其它特殊头域
URL 参数
version
string
API版本号,当前取1。
必选
host
string
"{实例IP}:{实例Port}"
必选
Query 参数
changePassword
string
修改用户密码操作
可选
Body 参数
username
string
用户名称。
必选
newPassword
string
用户的新密码。
必选
请求结构
POST /v{version}/user?changePassword HTTP/1.1
HOST: {Endpoint}
Authorization: {Authorization}
{
"username": "alice",
"newPassword": "********"
}
示例代码
请求示例
curl --location 'http://vdb.nXWNyPCOSLci.vdb.bj.baidubce.com/v1/user?changePassword' \
--header 'Authorization: Bearer account=root&api_key=eC4bLRy2va******************************' \
--header 'Content-Type: application/json' \
--data '{
"username": "alice",
"newPassword": "********"
}'
返回响应
Headers 参数
除公共头域外,无其它特殊头域
返回参数
msg
string
返回信息
可选
code
integer
返回码
可选
响应示例
{
"code": 0,
"msg": "Success"
}