調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1.1/{project_id}/cloudservers/{server_id}/resize
請求消息
|
名稱 |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
resize |
是 |
Object |
|
|
dry_run |
否 |
Boolean |
是否只預檢此次請求。 true：發(fā)送檢查請求，不會變更云服務器規(guī)格。檢查項包括是否填寫了必需參數(shù)、請求格式等。
false：發(fā)送正常請求，通過檢查后并且執(zhí)行變更云服務器規(guī)格請求。 |
|
名稱 |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
flavorRef |
是 |
String |
變更后的云服務器規(guī)格ID。 可以通過 查詢云服務器規(guī)格變更支持列表 接口查詢允許變更的規(guī)格列表。 說明：
|
|
dedicated_host_id |
否 |
String |
新 專屬主機 ID。 僅對于部署在專屬主機上的彈性云服務器，該參數(shù)必選。 |
|
extendparam |
否 |
Object |
|
|
mode |
否 |
String |
取值為withStopServer ，支持開機狀態(tài)下變更規(guī)格。 mode取值為withStopServer時，對開機狀態(tài)的云服務器執(zhí)行變更規(guī)格操作，系統(tǒng)自動對云服務器先執(zhí)行關(guān)機，再變更規(guī)格，變更成功后再執(zhí)行開機。 |
響應消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
job_id |
否 |
String |
任務ID，變更按需的彈性云服務器規(guī)格時返回該參數(shù)。 查詢job狀態(tài)請參見查詢?nèi)蝿盏膱?zhí)行狀態(tài) |
|
order_id |
否 |
String |
訂單號，變更包年包月的彈性云服務器規(guī)格時返回該參數(shù)。 |
請求示例
變更專屬主機上的云服務器的規(guī)格為“s3.large.2”，自動支付且支持開機狀態(tài)下變更規(guī)格。
POST https://{endpoint}/v1.1/{project_id}/cloudservers/{server_id}/resize
{
"resize": {
"flavorRef": "s3.large.2",
"dedicated_host_id": "459a2b9d-804a-4745-ab19-a113bb1b4ddc",
"extendparam":{
"isAutoPay": "true"
},
"mode": "withStopServer"
}
}
響應示例
{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
或
{
"order_id": "CS1711152257C60TL",
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
或
{
"error": {
"message": "XXXX",
"code": "XXX"
}
}
返回值
請參考通用請求返回值。
錯誤碼
請參考錯誤碼。
