更新时间:2024-04-16 GMT+08:00

一键重置云服务器密码

功能介绍

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

接口约束

  • 无符合安全要求的密码复杂度检查,非安全密码输入后,无错误提示。
  • 使用此API,需预先安装重置密码插件。一键式重置密码插件的下载与安装,请参见《弹性云服务器用户指南》的“安装一键式重置密码插件”章节。
  • 不能判断弹性云服务器是否支持重置密码。
  • 弹性云服务器的密码重置失败后,该API不会报错。
  • 弹性云服务器开机或重启后,新密码生效。
  • 该接口支持虚拟机状态为开机或者关机状态下执行。

URI

PUT /v2.1/{project_id}/servers/{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字段结构说明

参数

参数类型

是否必选

描述

new_password

String

弹性云服务器新密码。

该接口不做密码安全性校验,设置的密码复杂度请遵循密码规则。

密码规则:

  • 密码长度范围为8到26位。
  • 密码至少包含以下4种字符中的3种:
    • 大写字母
    • 小写字母
    • 数字
    • 特殊字符,包括!@$%^-_=+[{}]:,./?
  • 密码不能包含用户名或用户名的逆序。
  • Windows系统的弹性云服务器,不能包含用户名中超过两个连续字符的部分。

响应消息

请求示例

请求中的密码仅为示例,请勿复制使用该示例密码。

PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-reset-password

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

响应示例

返回值

请参考通用请求返回值

错误码

请参考错误码