華為云計(jì)算 云知識(shí) 一鍵重置裸金屬服務(wù)器密碼ResetPwdOneClick
一鍵重置裸金屬服務(wù)器密碼ResetPwdOneClick

 

功能介紹

裸金屬服務(wù)器 支持一鍵重置密碼功能的前提下,重置裸金屬服務(wù)器管理帳號(hào)(root用戶或Administrator用戶)的密碼。

可以通過查詢是否支持一鍵重置密碼API查詢是否支持一鍵重置密碼。

約束

  • 無符合安全要求的密碼復(fù)雜度檢查,非安全密碼輸入后,無錯(cuò)誤提示。
  • 使用此API,需預(yù)先安裝重置密碼插件。一鍵式重置密碼插件的下載與安裝,請(qǐng)參見《裸金屬服務(wù)器用戶指南》的“安裝一鍵式重置密碼插件”章節(jié)。
  • 裸金屬服務(wù)器的密碼重置失敗后,該API不會(huì)報(bào)錯(cuò)。
  • 裸金屬服務(wù)器開機(jī)或重啟后,新密碼生效。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

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

參數(shù)說明請(qǐng)參見表1。

表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

項(xiàng)目ID。

獲取方式請(qǐng)參見獲取項(xiàng)目ID。

server_id

裸金屬服務(wù)器ID。

可以從裸金屬服務(wù)器控制臺(tái)查詢,或者通過調(diào)用查詢裸金屬服務(wù)器列表(OpenStack原生)API獲取。

請(qǐng)求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

reset-password

Object

reset-password信息詳情。請(qǐng)參見表2。

表2 reset-password字段結(jié)構(gòu)說明

參數(shù)名稱

是否必選

參數(shù)類型

說明

new_password

String

裸金屬服務(wù)器新密碼。

該接口不做密碼安全性校驗(yàn),設(shè)置的密碼復(fù)雜度請(qǐng)遵循密碼規(guī)則。

密碼規(guī)則:

  • 密碼長(zhǎng)度范圍為8到26位。
  • 密碼至少包含以下4種字符中的3種:
    • 大寫字母
    • 小寫字母
    • 數(shù)字
    • 特殊字符

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

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

  • 密碼不能包含用戶名或用戶名的逆序。
  • Windows系統(tǒng)的裸金屬服務(wù)器,不能包含用戶名中超過兩個(gè)連續(xù)字符的部分。

請(qǐng)求示例

一鍵重置ID為77616c78-0bc4-4156-b24b-4286586ac350的裸金屬服務(wù)器的密碼,新密碼為Fusion@123。
 
{
    "reset-password": {
        "new_password": "Fusion@123"
    }
}

響應(yīng)消息

不涉及。

返回值

正常返回值:

返回值

說明

204

服務(wù)器成功處理了請(qǐng)求,但沒有返回任何內(nèi)容

其他返回值請(qǐng)參考狀態(tài)碼。

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼