功能介绍

重置弹性云服务器管理帐号（root用户或Administrator用户）的密码。

接口约束

默认无符合安全要求的密码复杂度检查，非安全密码输入后，无错误提示。
使用此API，需预先安装重置密码插件。一键式重置密码插件的下载与安装，请参见安装一键式重置密码插件（可选）。
不能判断弹性云服务器是否支持重置密码。
弹性云服务器的密码重置失败后，该API不会报错。
弹性云服务器开机或重启后，新密码生效。

调试

您可以在API Explorer中调试该接口。

URI

PUT /v1/{project_id}/cloudservers/{server_id}/os-reset-password

参数说明请参见表1。

表1 参数说明

参数	是否必选	描述
project_id	是	项目ID。 获取方法请参见获取项目ID。
server_id	是	云服务器ID。

请求消息

请求参数如表2所示。

表2 请求参数

参数	是否必选	参数类型	描述
reset-password	是	Object	reset-password信息详情，参考表3。

表3 reset-password字段结构说明

参数	是否必选	参数类型	描述
is_check_password	否	Boolean	是否检查密码的复杂度，默认值为false。
new_password	是	String	弹性云服务器新密码。 该接口默认不做密码安全性校验；如需校验，请指定字段“is_check_password”为true。 新密码的校验规则： 长度为8-26位 允许输入的字符包括：!@%-_=+[]:./? 禁止输入的字符包括：汉字及【】：；“”‘’、，。《》？￥…（）—— ·！~`#&^,{}*();”‘|\ $ 复杂度上必须包含大写字母（A-Z）、小写字母（a-z）、数字（0-9）、以及允许的特殊字符中的3种以上搭配 不能包含用户名 “Administrator” 和“root”及逆序字符 不能包含用户名 “Administrator” 中连续3个字符

响应消息

无

请求示例

一键重置指定云服务器的管理员帐号（root用户或Administrator用户）的密码为“YNbUwp!dUc9MClnv”（该密码仅为示例，请勿复制使用该示例密码）。

PUT https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-reset-password

{
	"reset-password": {
		"new_password": "YNbUwp!dUc9MClnv"
	}
}

响应示例

无

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 密码管理

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家