文档首页/ 弹性云服务器 ECS/ API参考/ API/ 批量操作/ 批量重置弹性云服务器密码 - BatchResetServersPassword
更新时间：2025-12-10 GMT+08:00
查看PDF
分享

批量重置弹性云服务器密码 - BatchResetServersPassword

功能介绍

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

接口约束

  • 使用此API，需预先安装重置密码插件。一键式重置密码插件的下载与安装，请参见《弹性云服务器用户指南》的“安装一键式重置密码插件”章节。
  • 弹性云服务器的重置密码请求下发后，脚本执行失败，该API不会报错。
  • 弹性云服务器开机或重启后，新密码生效。
  • 该接口支持虚拟机状态为开机或者关机状态下执行。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

ecs:cloudServers:resetServerPwd

write

instance *
  • g:ResourceTag/<tag-key>
  • g:EnterpriseProjectId

-

-

URI

PUT /v1/{project_id}/cloudservers/os-reset-passwords

参数说明请参见表1。

表1 参数说明

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。

请求消息

请求参数如表2所示。

表2 请求参数

参数

参数类型

是否必选

描述

new_password

String

是

新密码。

当dry_run字段为true时，该字段为非必填字段，否则为必填字段。

新密码的校验规则：
  • 长度为8-26位。
  • 密码至少必须包含大写字母（A-Z）、小写字母（a-z）、数字（0-9）和特殊字符（!@%-_=+[]:./?）中的三种。
  • 密码不能包含用户名或用户名的逆序。
  • Windows系统密码不能包含用户名或用户名的逆序，不能包含用户名中超过两个连续字符的部分。

dry_run

Boolean

否

是否只预检此次请求。

  • true：发送检查请求，不会重置密码。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回响应结果。
  • false：发送正常请求，通过检查后并且进行重置密码请求。

默认值：false

servers

Array of objects

是

待批量重置密码的弹性云服务器ID信息，详情参见 表3。
表3 servers字段数据结构说明

参数

参数类型

是否必选

描述

id

String

是

弹性云服务器ID。

响应消息

响应参数如表4所示。

表4 响应参数

参数

参数类型

描述

response

Array of objects

提交请求成功后返回的响应列表，详情请参见response数据结构说明。
表5 response数据结构说明

名称

参数类型

描述

id

String

操作成功的弹性云服务器ID。

请求示例

批量重置ID为“1bd0eb17-4466-4c15-a9ce-87727ad311b5”和“fd6b6e9d-64a1-40fa-b7dc-f491be42fdd2”的云服务器的密码，建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。

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

{
    "new_password": "$ADMIN_PASS",
    "dry_run": true,
    "servers": [
                {
                  "id":"1bd0eb17-4466-4c15-a9ce-87727ad311b5"  
                },
                {
                  "id":"fd6b6e9d-64a1-40fa-b7dc-f491be42fdd2" 
                }
               ]
}

响应示例

响应示例请参见响应（批量操作类）所示。

{      
    "response": [                   
                  {                     
                    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19"                      
                   },                   
                  {                     
                    "id": "516fb98f-46ca-475e-917e-2563e5a8cd12"                      
                   }                
                 ] 
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 批量操作

相关文档