華為云計算 云知識 一鍵重置彈性云服務器密碼(企業(yè)項目)ResetServerPassword
一鍵重置彈性云服務器密碼(企業(yè)項目)ResetServerPassword

 

功能介紹

重置彈性 云服務器 管理帳號(root用戶或Administrator用戶)的密碼。

接口約束

  • 默認無符合安全要求的密碼復雜度檢查,非安全密碼輸入后,無錯誤提示。
  • 使用此API,需預先安裝重置密碼插件。一鍵式重置密碼插件的下載與安裝,請參見安裝一鍵式重置密碼插件(可選)
  • 不能判斷彈性云服務器是否支持重置密碼。
  • 彈性云服務器的密碼重置失敗后,該API不會報錯。
  • 彈性云服務器開機或重啟后,新密碼生效。

調試

您可以在API Explorer中調試該接口。

URI

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

參數說明請參見表1。
表1 參數說明

參數

是否必選

描述

project_id

項目ID。

獲取方法請參見獲取項目ID。

server_id

云服務器ID。

請求消息

請求參數如表2所示。

表2 請求參數

參數

是否必選

參數類型

描述

reset-password

Object

reset-password信息詳情,參考表3。

表3 reset-password字段結構說明

參數

是否必選

參數類型

描述

is_check_password

Boolean

是否檢查密碼的復雜度,默認值為false。

new_password

String

彈性云服務器新密碼。

該接口默認不做密碼安全性校驗;如需校驗,請指定字段“is_check_password”為true。

新密碼的校驗規(guī)則:
  • 長度為8-26位。
  • 密碼至少必須包含大寫字母、小寫字母、數字和特殊字符(!@$%^-_=+[{}]:,./?)中的三種。
  • 密碼不能包含用戶名或用戶名的逆序。
  • Windows系統(tǒng)密碼不能包含用戶名或用戶名的逆序,不能包含用戶名中超過兩個連續(xù)字符的部分。

響應消息

請求示例

一鍵重置指定云服務器的管理員帳號(root用戶或Administrator用戶)的密碼為“YNbUwp!dUc9MClnv”(該密碼僅為示例,請勿復制使用該示例密碼)。

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

{
	"reset-password": {
		"new_password": "YNbUwp!dUc9MClnv"
	}
}

響應示例

返回值

請參考通用請求返回值。

錯誤碼

請參考錯誤碼