功能介绍
重置弹性 云服务器 管理帐号(root用户或Administrator用户)的密码。
接口约束
- 默认无符合安全要求的密码复杂度检查,非安全密码输入后,无错误提示。
- 使用此API,需预先安装重置密码插件。一键式重置密码插件的下载与安装,请参见安装一键式重置密码插件(可选)。
- 不能判断弹性 云服务 器是否支持重置密码。
- 弹性云服务器的密码重置失败后,该API不会报错。
- 弹性云服务器开机或重启后,新密码生效。
调试
您可以在API Explorer中调试该接口。
请求消息
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
is_check_password |
否 |
Boolean |
是否检查密码的复杂度,默认值为false。 |
new_password |
是 |
String |
弹性云服务器新密码。 该接口默认不做密码安全性校验;如需校验,请指定字段“is_check_password”为true。 新密码的校验规则:
|
响应消息
无
请求示例
一键重置指定云服务器的管理员帐号(root用户或Administrator用户)的密码为“YNbUwp!dUc9MClnv”(该密码仅为示例,请勿复制使用该示例密码)。
PUT https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-reset-password { "reset-password": { "new_password": "YNbUwp!dUc9MClnv" } }
响应示例
无
返回值
请参考通用请求返回值。
错误码
请参考错误码。