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