批量重置云主机密码
功能介绍
批量重置云主机管理账号(root用户或Administrator用户)的密码。
接口约束
- 使用此API,需预先安装重置密码插件。
如果私有镜像的镜像源来自其他云平台的服务器或从第三放下载,此类私有镜像可能因为未安装一键式密码重置插件而无法重置密码。请根据安装一键式密码重置插件(遗忘私有镜像初始密码)或安装一键式密码重置插件(已知私有镜像初始密码)安装插件。
- 云主机的重置密码请求下发后,脚本执行失败,该API不会报错。
- 云主机开机或重启后,新密码生效。
- 该接口支持虚拟机状态为开机或者关机状态下执行。
调试
您可以在API Explorer中调试该接口。
请求消息
请求参数如表2 请求参数所示。
参数 |
参数类型 |
是否必选 |
描述 |
---|---|---|---|
new_password |
String |
是 |
新密码。 当dry_run字段为true时,该字段为非必填字段,否则为必填字段。
新密码的校验规则:
|
dry_run |
Boolean |
否 |
是否只预检此次请求。取值为true或false,默认值为false。
|
servers |
Array of objects |
是 |
待批量重置密码的云主机ID信息,详情参见表3 servers字段数据结构说明。 |
相关信息
本接口复用ECS相应接口,响应参数说明、接口使用示例、返回值等信息详见ECS文档批量重置弹性云服务器密码,该文档内容同样适用于L实例云主机。
![](https://support.huaweicloud.com/api-hecs/public_sys-resources/note_3.0-zh-cn.png)
ECS接口信息中,L实例中的云主机对应于弹性云服务器。