功能介紹
當(dāng)您創(chuàng)建的彈性 云服務(wù)器 規(guī)格無法滿足業(yè)務(wù)需要時，可以變更云服務(wù)器規(guī)格，升級vCPU、內(nèi)存。具體接口的使用，請參見本節(jié)內(nèi)容。
本接口為異步接口，當(dāng)前變更彈性云服務(wù)器規(guī)格請求下發(fā)成功后會返回job_id，此時變更彈性云服務(wù)器規(guī)格并沒有立即完成，需要通過調(diào)用查詢?nèi)蝿?wù)的執(zhí)行狀態(tài)查詢job狀態(tài)，當(dāng)Job狀態(tài)為 SUC CES S 時代表云服務(wù)器規(guī)格變更成功。
變更規(guī)格時，部分規(guī)格的之間不能互相變更。您可以參見查詢云服務(wù)器規(guī)格變更支持列表查詢支持列表。
接口約束
- “XEN實例”變更為“KVM實例”時，需先手動配置彈性云服務(wù)器，安裝對應(yīng)的驅(qū)動，然后再變更規(guī)格，否則會變更失敗。安裝驅(qū)動的具體操作，請參見《彈性云服務(wù)器用戶指南》的“變更規(guī)格 > XEN實例變更為KVM實例（Windows）、XEN實例變更為KVM實例（Linux-自動配置）、XEN實例變更為KVM實例（Linux-手動配置）”章節(jié)。
- 該接口不支持對包年/包月云服務(wù)器的規(guī)格進行變更操作，包年/包月云服務(wù)器規(guī)格變更請參考 變更云服務(wù)器規(guī)格 。
- 競價實例不支持變更規(guī)格
調(diào)試
您可以在API Explorer中調(diào)試該接口。
請求消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
resize |
是 |
Object |
|
|
dry_run |
否 |
Boolean |
是否只預(yù)檢此次請求。 true：發(fā)送檢查請求，不會變更云服務(wù)器規(guī)格。檢查項包括是否填寫了必需參數(shù)、請求格式等。
false：發(fā)送正常請求，通過檢查后并且執(zhí)行變更云服務(wù)器規(guī)格請求。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
flavorRef |
是 |
String |
變更后的云服務(wù)器規(guī)格ID。 可能通過 查詢云服務(wù)器規(guī)格變更支持列表 接口查詢允許變更的規(guī)格列表。 |
|
mode |
否 |
String |
取值為withStopServer ，支持開機狀態(tài)下變更規(guī)格。 mode取值為withStopServer時，對開機狀態(tài)的云服務(wù)器執(zhí)行變更規(guī)格操作，系統(tǒng)自動對云服務(wù)器先執(zhí)行關(guān)機，再變更規(guī)格，變更成功后再執(zhí)行開機。 |
響應(yīng)消息
請求示例
變更云服務(wù)器的規(guī)格為“c3.15xlarge.2”。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/resize
{
"resize": {
"flavorRef": "c3.15xlarge.2"
}
}
響應(yīng)示例
{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
返回值
請參考通用請求返回值。
錯誤碼
請參考錯誤碼。
