更新时间:2024-03-25 GMT+08:00
分享

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

功能介绍

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

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

约束

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

调试

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

URI

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

参数说明请参见表1

表1 参数说明

参数

是否必选

描述

project_id

项目ID。

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

server_id

裸金属服务器ID。

可以从裸金属服务器控制台查询,或者通过调用查询裸金属服务器列表(OpenStack原生)获取。

请求参数

参数

是否必选

参数类型

描述

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的裸金属服务器的密码,新密码为Fusion@123。
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": "Fusion@123"
    }
}

响应消息

不涉及。

返回值

正常返回值:

返回值

说明

204

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

其他返回值请参考状态码

错误码

请参考错误码

分享:

    相关文档

    相关产品