# 批量重置云主机密码 - BatchResetServersPassword
#### 功能介绍
批量重置云主机管理账号（root用户或Administrator用户）的密码，所用接口为ECS的"批量重置弹性云服务器密码"接口。本节列举了接口使用过程中的关键信息，接口更多信息详见[批量重置弹性云服务器密码](https://support.huaweicloud.com/api-ecs/ecs_02_0306.html)。
![](https://support.huaweicloud.com/api-flexusl/public_sys-resources/note_3.0-zh-cn.png)
Flexus L实例中**云主机** 所使用的该API接口与**ECS**相同，响应参数说明、接口使用示例、返回值等信息同样适用于Flexus L实例云主机。
#### 接口约束
- 使用此API，需预先安装重置密码插件。 Flexus L实例提供的系统镜像、应用镜像默认已安装重置密码插件。
  如果私有镜像的镜像源来自其他云平台的服务器或从第三方下载，此类私有镜像可能因为未安装一键式密码重置插件而无法重置密码。请根据[重置Linux云服务器云主机密码（未安装重置密码插件）](https://support.huaweicloud.com/flexusl_faq/faq_passwd_0002.html)安装插件。
  
- 云主机的重置密码请求下发后，脚本执行失败，该API不会报错。
- 云主机开机或重启后，新密码生效。
- 该接口支持虚拟机状态为开机或者关机状态下执行。
 
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ECS/doc?api=BatchResetServersPassword)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ecs/ecs_06_0000.html)。
#### URI
PUT /v1/{project_id}/cloudservers/os-reset-passwords
#### 请求消息
请求参数详见[批量重置弹性云服务器密码](https://support.huaweicloud.com/api-ecs/ecs_02_0306.html)，其中servers字段中的id为云主机ID，请根据[查询已创建的Flexus L实例 - ListAllResources](https://support.huaweicloud.com/api-flexusl/renewal_instance_0001.html)获取云主机ID。
#### 请求示例
将云主机ID为72a270de-665a-4f46-8d64-24ad6edccdd1、72a270de-665a-4f46-8d64-24ad6edccdd2的Flexus L实例密码重置为password@123。
```
PUT https://{endpoint}/v1/{project_id}/cloudservers/os-reset-passwords
{
 "new_password": "password@123",
 "servers": [
  {
   "id": "72a270de-665a-4f46-8d64-24ad6edccdd1"
  },
  {
   "id": "72a270de-665a-4f46-8d64-24ad6edccdd2"
  }
 ]
}
```
#### 响应示例
```
{
 "response": [
  {
   "id": "72a270de-665a-4f46-8d64-24ad6edccdd1"
  }
  {
   "id": "72a270de-665a-4f46-8d64-24ad6edccdd2"
  }
 ]
}
```