功能介紹
重置彈性 云服務(wù)器 管理帳號(root用戶或Administrator用戶)的密碼。
接口約束
- 默認(rèn)無符合安全要求的密碼復(fù)雜度檢查,非安全密碼輸入后,無錯誤提示。
- 使用此API,需預(yù)先安裝重置密碼插件。一鍵式重置密碼插件的下載與安裝,請參見安裝一鍵式重置密碼插件(可選)。
- 不能判斷彈性云服務(wù)器是否支持重置密碼。
- 彈性云服務(wù)器的密碼重置失敗后,該API不會報(bào)錯。
- 彈性云服務(wù)器開機(jī)或重啟后,新密碼生效。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
PUT /v1/{project_id}/cloudservers/{server_id}/os-reset-password
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請參見獲取項(xiàng)目ID。 |
|
server_id |
是 |
云服務(wù)器ID。 |
請求消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
is_check_password |
否 |
Boolean |
是否檢查密碼的復(fù)雜度,默認(rèn)值為false。 |
|
new_password |
是 |
String |
彈性云服務(wù)器新密碼。 該接口默認(rèn)不做密碼安全性校驗(yàn);如需校驗(yàn),請指定字段“is_check_password”為true。 新密碼的校驗(yàn)規(guī)則:
|
響應(yīng)消息
無
請求示例
一鍵重置指定云服務(wù)器的管理員帳號(root用戶或Administrator用戶)的密碼為“YNbUwp!dUc9MClnv”(該密碼僅為示例,請勿復(fù)制使用該示例密碼)。
PUT https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-reset-password
{
"reset-password": {
"new_password": "YNbUwp!dUc9MClnv"
}
}
響應(yīng)示例
無
返回值
請參考通用請求返回值。
錯誤碼
請參考錯誤碼。
