更改密码 API
编辑更改密码 API编辑
更改本机领域中用户和内置用户的密码。
先决条件编辑
- 每个用户都可以更改自己的密码。 拥有
manage_security权限的用户可以更改其他用户的密码。
路径参数编辑
-
username - （可选，字符串）要更改其密码的用户。 如果您未指定此参数，则会更改当前用户的密码。
请求正文编辑
-
password -
（字符串）新的密码值。 密码长度必须至少为 6 个字符。
password或password_hash之一是必需的。 -
password_hash -
（字符串）新密码值的*哈希值*。 这必须使用与为密码存储配置的相同的哈希算法生成。 有关更多详细信息，请参阅 用户缓存和密码哈希算法 中对
xpack.security.authc.password_hashing.algorithm设置的说明。使用此参数允许客户端出于性能和/或机密性原因预先对密码进行哈希处理。
password参数和password_hash参数不能在同一个请求中使用。
示例编辑
以下示例更新了 jacknich 用户的密码
POST /_security/user/jacknich/_password
{
"password" : "new-test-password"
}
成功调用将返回一个空的 JSON 结构。
{}