文档首页/ 裸金属服务器 BMS/ API参考/ API/ 裸金属服务器密码管理/ 一键重置裸金属服务器密码 - ResetPwdOneClick
更新时间：2025-10-31 GMT+08:00
查看PDF
分享

一键重置裸金属服务器密码 - ResetPwdOneClick

功能介绍

在裸金属服务器支持一键重置密码功能的前提下，重置裸金属服务器管理账号（root用户或Administrator用户）的密码。

可以通过查询是否支持一键重置密码 - ShowResetPwdAPI查询是否支持一键重置密码。

约束

  • 无符合安全要求的密码复杂度检查，非安全密码输入后，无错误提示。
  • 使用此API，需预先安装重置密码插件。一键式重置密码插件的下载与安装，请参见《裸金属服务器用户指南》的“安装一键式重置密码插件”章节。
  • 裸金属服务器的密码重置失败后，该API不会报错。
  • 裸金属服务器开机或重启后，新密码生效。

URI

PUT /v1/{project_id}/baremetalservers/{server_id}/os-reset-password

参数说明请参见表1。

表1 参数说明

参数

是否必选

描述

project_id

是

项目ID。

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

server_id

是

裸金属服务器ID。

可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。

请求参数

参数

是否必选

参数类型

描述

reset-password

是

Object

reset-password信息详情。请参见表2。
表2 reset-password字段结构说明

参数名称

是否必选

参数类型

说明

new_password

是

String

裸金属服务器新密码。

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

密码规则：

  • 密码长度范围为8到26位。
  • 密码至少包含以下4种字符中的3种：
    • 大写字母
    • 小写字母
    • 数字
    • 特殊字符

      Windows：!@$%-_=+[]:./?

      Linux：!@%^-_=+[]{}:,./?

  • 密码不能包含用户名或用户名的逆序。
  • Windows系统的裸金属服务器，不能包含用户名中超过两个连续字符的部分。

请求示例

一键重置ID为77616c78-0bc4-4156-b24b-4286586ac350的裸金属服务器的密码，新密码为********。 
1
 
PUT https://{BMS Endpoint}/v1/2e62dec99940499d93717c2789759015/baremetalservers/77616c78-0bc4-4156-b24b-4286586ac350/os-reset-password

1
2
3
4
5
 
{
    "reset-password": {
        "new_password": "********"
    }
}

响应消息

不涉及。

返回值

正常返回值：

返回值

说明

204

服务器成功处理了请求，但没有返回任何内容

其他返回值请参考状态码。

错误码

请参考错误码。