更新时间:2025-08-18 GMT+08:00
        
          
          
        
      
      
      
      
      
      
      
      
  
      
      
      
        
一键重置弹性云服务器密码
功能介绍
离线重置弹性云服务器管理账号(root用户或Administrator用户)的密码。
接口约束
- 默认无符合安全要求的密码复杂度检查,非安全密码输入后,无错误提示。
 - 使用此API,需预先安装一键式重置密码插件。一键式重置密码插件的下载与安装,请参见安装一键式重置密码插件(可选)。
 - 不能判断弹性云服务器是否支持离线重置密码。
 - 弹性云服务器的离线密码重置失败后,该API不会报错。
 - 弹性云服务器开机或重启后,新密码生效。
 
URI
PUT /v1/{project_id}/cloudservers/{server_id}/os-reset-password
请求消息
请求参数如表2所示。
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        reset-password  | 
      
        是  | 
      
        Object  | 
      
        参数解释: reset-password信息详情,参考表3。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及  | 
     
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        is_check_password  | 
      
        否  | 
      
        Boolean  | 
      
        参数解释: 是否检查密码的复杂度。 约束限制: 不涉及 取值范围: 
 默认取值: false  | 
     
| 
        new_password  | 
      
        是  | 
      
        String  | 
      
        参数解释: 弹性云服务器新密码。 约束限制: 该接口默认不做密码安全性校验;如需校验,请指定字段“is_check_password”为true。 
        取值范围:
         
       
 默认取值: 不涉及  | 
     
响应消息
无
请求示例
离线重置指定云服务器的管理员账号(root用户或Administrator用户)的密码,建议将密码在配置文件或者环境变量中密文存放,使用时解密,确保安全。
PUT https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-reset-password
{
	"reset-password": {
		"new_password": "$ADMIN_PASS"
	}
}
 响应示例
无
返回值
请参考通用请求返回值。
错误码
请参考错误码。
   父主题: 密码管理