功能介绍
在 裸金属服务器 支持一键重置密码功能的前提下,重置裸金属服务器管理帐号(root用户或Administrator用户)的密码。
可以通过查询是否支持一键重置密码API查询是否支持一键重置密码。
约束
- 无符合安全要求的密码复杂度检查,非安全密码输入后,无错误提示。
- 使用此API,需预先安装重置密码插件。一键式重置密码插件的下载与安装,请参见《裸金属服务器用户指南》的“安装一键式重置密码插件”章节。
- 裸金属服务器的密码重置失败后,该API不会报错。
- 裸金属服务器开机或重启后,新密码生效。
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1/{project_id}/baremetalservers/{server_id}/os-reset-password
参数 |
是否必选 |
描述 |
---|---|---|
project_id |
是 |
项目ID。 获取方式请参见获取项目ID。 |
server_id |
是 |
裸金属服务器ID。 可以从裸金属服务器控制台查询,或者通过调用查询裸金属服务器列表(OpenStack原生)API获取。 |
请求参数
请求示例
{ "reset-password": { "new_password": "Fusion@123" } } |
响应消息
不涉及。
错误码
请参考错误码。