# 一键重置云服务器密码（废弃）
#### 功能介绍
重置弹性云服务器管理账号（root用户或Administrator用户）的密码。
当前API已废弃，请使用[一键重置弹性云服务器密码 - ResetServerPassword](https://support.huaweicloud.com/api-ecs/ecs_02_1103.html)。
#### 接口约束
- 无符合安全要求的密码复杂度检查，非安全密码输入后，无错误提示。
- 使用此API，需预先安装重置密码插件。一键式重置密码插件的下载与安装，请参见[《弹性云服务器用户指南》](https://support.huaweicloud.com/ecs/index.html)的"安装一键式重置密码插件"章节。
- 不能判断弹性云服务器是否支持重置密码。
- 弹性云服务器的密码重置失败后，该API不会报错。
- 弹性云服务器开机或重启后，新密码生效。
- 该接口支持虚拟机状态为开机或者关机状态下执行。
 
#### URI
PUT /v2.1/{project_id}/servers/{server_id}/os-reset-password
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                           |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 |
| server_id  | 是    | 云服务器ID。                                                                                                      |
   
#### 请求消息
请求参数如[表2]所示。
 表2请求参数 
| 参数             | 参数类型   | 是否必选 | 描述                                                               |
|:---|:---|:---|:---|
| reset-password | Object | 是    | reset-password信息详情，参考[表3]。 |
   
 表3reset-password字段结构说明 
| 参数           | 参数类型   | 是否必选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| new_password | String | 是    | 弹性云服务器新密码。 该接口不做密码安全性校验，设置的密码复杂度请遵循密码规则。 密码规则： - 密码长度范围为8到26位。  - 密码至少包含以下4种字符中的3种： - 大写字母  - 小写字母  - 数字  - 特殊字符，包括!@$%\^-_=+\[{}\]:,./?    - 密码不能包含用户名或用户名的逆序。  - Windows系统的弹性云服务器，不能包含用户名中超过两个连续字符的部分。   |
   
#### 响应消息
无
#### 请求示例
![](https://support.huaweicloud.com/api-ecs/public_sys-resources/note_3.0-zh-cn.png)
建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。
```
PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-reset-password
```
```
{
"reset-password": {
"new_password": "$ADMIN_PASS",
}
}
```
#### 响应示例
无
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-ecs/ecs_07_0002.html)。