文档首页 > > API参考> API(推荐)> 批量操作> 批量重置弹性云服务器密码

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

分享
更新时间: 2019/08/12 20:37

功能介绍

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

接口约束

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

URI

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

参数说明请参见表1

表1 参数说明

参数

是否必选

描述

project_id

项目ID。

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

请求消息

请求参数如表2所示。

表2 请求参数

参数

参数类型

是否必选

描述

new_password

String

新密码。

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

新密码的校验规则:

  • 允许输入的字符包括:!@%-_=+[]:./?
  • 禁止输入的字符包括:汉字及【】:;“”‘’、,。《》?¥…()—— ·!~`#&^,{}*();"'<>|\ $
  • 复杂度上必须包含大写字母(A-Z)、小写字母(a-z)、数字(0-9)、以及允许的特殊字符中的3种以上搭配
  • 不能包含用户名 "Administrator" 和“root”及逆序字符
  • 不能包含用户名 "Administrator" 中连续3个字符

dry_run

Boolean

是否只预检此次请求。

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

默认值:false

servers

列表数据结构

待批量重置密码的弹性云服务器ID信息。

表3 servers字段数据结构说明

参数

参数类型

是否必选

描述

id

String

弹性云服务器ID。

响应消息

响应参数请参见 7.5.1 响应 所示。

请求示例

PUT  /v1/66c860cb130b465fbafcdee43fb09c64/cloudservers/os-reset-passwords 
{
    "new_password": "Test@123",
    "dry_run": true,
    "servers": [
                {
                  "id":"1bd0eb17-4466-4c15-a9ce-87727ad311b5"  
                },
                {
                  "id":"fd6b6e9d-64a1-40fa-b7dc-f491be42fdd2" 
                }
               ]
}

响应示例

响应示例请参见 7.5.1 响应所示。

返回值

请参考通用请求返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区