功能介紹
批量重置彈性 云服務(wù)器 管理帳號(hào)(root用戶或Administrator用戶)的密碼。
接口約束
- 使用此API,需預(yù)先安裝重置密碼插件。一鍵式重置密碼插件的下載與安裝,請參見《彈性云服務(wù)器用戶指南》的“安裝一鍵式重置密碼插件”章節(jié)。
- 彈性云服務(wù)器的重置密碼請求下發(fā)后,腳本執(zhí)行失敗,該API不會(huì)報(bào)錯(cuò)。
- 彈性云服務(wù)器開機(jī)或重啟后,新密碼生效。
- 該接口支持虛擬機(jī)狀態(tài)為開機(jī)或者關(guān)機(jī)狀態(tài)下執(zhí)行。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
PUT /v1/{project_id}/cloudservers/os-reset-passwords
請求消息
參數(shù) |
參數(shù)類型 |
是否必選 |
描述 |
---|---|---|---|
new_password |
String |
是 |
新密碼。 當(dāng)dry_run字段為true時(shí),該字段為非必填字段,否則為必填字段。 新密碼的校驗(yàn)規(guī)則:
|
dry_run |
Boolean |
否 |
是否只預(yù)檢此次請求。
默認(rèn)值:false |
servers |
Array of objects |
是 |
響應(yīng)消息
響應(yīng)參數(shù)請參見 響應(yīng)(批量操作類) 所示。
請求示例
批量重置ID為“1bd0eb17-4466-4c15-a9ce-87727ad311b5”和“fd6b6e9d-64a1-40fa-b7dc-f491be42fdd2”的云服務(wù)器的密碼為“YNbUwp!dUc9MClnv”(此密碼僅為示例,請勿復(fù)制使用該示例密碼)。
PUT https://{endpoint}/v1/{project_id}/cloudservers/os-reset-passwords { "new_password": "YNbUwp!dUc9MClnv", "dry_run": true, "servers": [ { "id":"1bd0eb17-4466-4c15-a9ce-87727ad311b5" }, { "id":"fd6b6e9d-64a1-40fa-b7dc-f491be42fdd2" } ] }
響應(yīng)示例
響應(yīng)示例請參見響應(yīng)(批量操作類)所示。
{ "response": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "516fb98f-46ca-475e-917e-2563e5a8cd12" } ] }
返回值
請參考通用請求返回值。
錯(cuò)誤碼
請參考錯(cuò)誤碼。