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