功能介绍

在裸金属服务器支持一键重置密码功能的前提下，重置裸金属服务器管理帐号（root用户或Administrator用户）的密码。

可以通过查询是否支持一键重置密码API查询是否支持一键重置密码。

约束

• 无符合安全要求的密码复杂度检查，非安全密码输入后，无错误提示。
• 使用此API，需预先安装重置密码插件。一键式重置密码插件的下载与安装，请参见《裸金属服务器用户指南》的“安装一键式重置密码插件”章节。
• 裸金属服务器的密码重置失败后，该API不会报错。
• 裸金属服务器开机或重启后，新密码生效。

调试

您可以在API Explorer中调试该接口。

URI

PUT /v1/{project_id}/baremetalservers/{server_id}/os-reset-password

参数说明请参见表1。

请求消息

• 请求参数

  参数	是否必选	参数类型	描述
  reset-password	是	Object	reset-password信息详情。请参见表2。

  表2 reset-password字段结构说明

  参数名称	是否必选	参数类型	说明
  new_password	是	String	裸金属服务器新密码。 该接口不做密码安全性校验，设置的密码复杂度请遵循密码规则。 密码规则： 密码长度范围为8到26位。 密码至少包含以下4种字符中的3种： 大写字母 小写字母 数字 特殊字符 Windows：!@$%-_=+[]:./? Linux：!@%^-_=+[]{}:,./? 密码不能包含用户名或用户名的逆序。 Windows系统的裸金属服务器，不能包含用户名中超过两个连续字符的部分。

• 请求样例

  1	PUT https://{BMS Endpoint}/v1/2e62dec99940499d93717c2789759015/baremetalservers/77616c78-0bc4-4156-b24b-4286586ac350/os-reset-password

  1 2 3 4 5

  { "reset-password": { "new_password": "Fusion@123" } }

响应消息

不涉及。

返回值

其他返回值请参考状态码。

错误码

请参考错误码。