文档首页/ 弹性云服务器 ECS/ API参考/ API/ 密码管理/ 一键重置弹性云服务器密码
更新时间:2024-12-13 GMT+08:00

一键重置弹性云服务器密码

功能介绍

重置弹性云服务器管理账号(root用户或Administrator用户)的密码。

接口约束

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

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用户)的密码,建议将密码在配置文件或者环境变量中密文存放,使用时解密,确保安全。

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

{
	"reset-password": {
		"new_password": "$ADMIN_PASS",
	}
}

响应示例

返回值

请参考通用请求返回值

错误码

请参考错误码