# 一键重置裸金属服务器密码 - ResetPwdOneClick
#### 功能介绍
在裸金属服务器支持一键重置密码功能的前提下，重置裸金属服务器管理账号（root用户或Administrator用户）的密码。
可以通过[查询是否支持一键重置密码 - ShowResetPwd](https://support.huaweicloud.com/api-bms/bms_api_0635.html)API查询是否支持一键重置密码。
#### 约束
- 无符合安全要求的密码复杂度检查，非安全密码输入后，无错误提示。
- 使用此API，需预先安装重置密码插件。一键式重置密码插件的下载与安装，请参见《裸金属服务器用户指南》的"[安装一键式重置密码插件](https://support.huaweicloud.com/usermanual-bms/bms_01_0020.html)"章节。
- 裸金属服务器的密码重置失败后，该API不会报错。
- 裸金属服务器开机或重启后，新密码生效。
 
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/doc?api=ResetPwdOneClick)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-bms/bms_api_0900.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                      | 访问级别 | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                                      | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | bms:servers:resetServerPwd | write   | instance\* | - g:EnterpriseProjectId   - g:ResourceTag/\<tag-key\>    | -   | -       |
     
  
 
#### URI
PUT /v1/{project_id}/baremetalservers/{server_id}/os-reset-password
参数说明请参见[表1]。
 表1参数说明 
| 参数             | 是否必选   | 描述                                                                                                                                                                  |
|:---|:---|:---|
| project_id    | 是      | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-bms/bms_api_appendix_03.html)。                                              |
| server_id | 是 | 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用[查询裸金属服务器详情列表 - ListBareMetalServers](https://support.huaweicloud.com/api-bms/bms_api_0609.html)获取。 |
   
#### 请求参数
| 参数           | 是否必选 | 参数类型    | 描述                                                              |
|:---|:---|:---|:---|
| reset-password | 是       | Object | reset-password信息详情。请参见[表2]。 |
   
 表2reset-password字段结构说明 
| 参数名称         | 是否必选 | 参数类型    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| new_password | 是 | String | 裸金属服务器新密码。 该接口不做密码安全性校验，设置的密码复杂度请遵循密码规则。 密码规则： - 密码长度范围为8到26位。  - 密码至少包含以下4种字符中的3种： - 大写字母  - 小写字母  - 数字  - 特殊字符 Windows：!@$%-_=+\[\]:./? Linux：!@%\^-_=+\[\]{}:,./?     - 密码不能包含用户名或用户名的逆序。  - Windows系统的裸金属服务器，不能包含用户名中超过两个连续字符的部分。   |
   
#### 请求示例
一键重置ID为77616c78-0bc4-4156-b24b-4286586ac350的裸金属服务器的密码，新密码为\*\*\*\*\*\*\*\*。
```
PUT https://{BMS Endpoint}/v1/2e62dec99940499d93717c2789759015/baremetalservers/77616c78-0bc4-4156-b24b-4286586ac350/os-reset-password
```
```
{
    "reset-password": {
        "new_password": "********"
    }
}
```
#### 响应消息
不涉及。
#### 返回值
正常返回值：
| 返回值 | 说明       |
|:---|:---|
| 204 | 服务器成功处理了请求，但没有返回任何内容 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。