功能介紹
根據指定的 云服務器 ID列表，刪除云服務器。
本接口為異步接口，當前刪除云服務器請求下發(fā)成功后會返回job_id，此時刪除云服務器并沒有立即完成，需要通過調用查詢任務的執(zhí)行狀態(tài)查詢job狀態(tài)，當Job狀態(tài)為 SUC CES S 時代表云服務器刪除成功。
系統(tǒng)支持刪除單臺云服務器和批量刪除多臺云服務器操作，批量刪除云服務器時，一次最多可以刪除1000臺。
僅支持刪除按需計費的云服務器。
調試
您可以在API Explorer中調試該接口。
請求消息
請求參數如表2所示。
|
參數 |
是否必選 |
參數類型 |
描述 |
|---|---|---|---|
|
servers |
是 |
Array of objects |
|
|
delete_publicip |
否 |
Boolean |
配置刪除云服務器是否刪除云服務器綁定的 彈性公網IP 。如果選擇不刪除，則系統(tǒng)僅做解綁定操作，保留彈性 公網IP 資源。 取值為true或false。
說明：
若未設置delete_publicip參數，彈性公網IP是否隨實例釋放依賴于該彈性公網IP的delete_on_termination字段。
|
|
delete_volume |
否 |
Boolean |
配置刪除云服務器是否刪除云服務器對應的數據盤，如果選擇不刪除，則系統(tǒng)僅做卸載操作，保留 云硬盤 資源。默認為false。
|
響應消息
請參考響應（任務類）。
請求示例
刪除ID為“616fb98f-46ca-475e-917e-2563e5a8cd19”的云服務器，并解綁彈性公網IP、卸載數據盤。
POST https://{endpoint}/v1/{project_id}/cloudservers/delete
{
"servers": [
{
"id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
}
],
"delete_publicip": false,
"delete_volume": false
}
響應示例
{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
或
{
"error": {
"message": "request body is illegal.",
"code": "Ecs.0005"
}
}
返回值
請參考通用請求返回值。
錯誤碼
請參考錯誤碼。
