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