更改密码 API
更改本机 realm 中的用户和内置用户的密码。
- 你可以使用创建或更新用户 API 更新用户除了
username和password之外的所有信息。此 API 用于更改用户的密码。 - 有关本机 realm 的更多信息，请参阅 Realm 和本机用户身份验证。
POST /_security/user/_password
POST /_security/user/<username>/_password
前置条件
- 每个用户都可以更改自己的密码。
- 具有
manage_security权限的用户可以更改其他用户的密码。
路径参数
<username>
（可选，字符串）要更改其密码的用户。如果省略，则更改当前用户的密码。
请求体
password
（字符串）新的密码值。密码必须至少 6 个字符长。
password_hash
（字符串）新密码的哈希值。必须使用为密码存储配置的相同哈希算法生成（请参阅用户缓存和密码哈希算法中的 xpack.security.authc.password_hashing.algorithm 设置）。允许客户端出于性能和/或保密性原因预哈希密码。
注意
password 和 password_hash 必须二选一（其中一个为必需），但不能在同一请求中同时使用两者。
示例
更新用户 jacknich 的密码：
POST /_security/user/jacknich/_password
{
"password": "new-test-password"
}
成功调用返回一个空的 JSON 结构：
{}