華為云計(jì)算 云知識(shí) 變更云服務(wù)器規(guī)格ResizeServer
變更云服務(wù)器規(guī)格ResizeServer
時(shí)間: 2023-07-24 11:08:38
猜你想看：
實(shí)時(shí)語(yǔ)音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

功能介紹

變更 云服務(wù)器 規(guī)格。

V1.1版本變更云服務(wù)器規(guī)格的接口兼容了V1版本變更云服務(wù)器規(guī)格（按需）的功能，同時(shí)合入新功能，支持包年/包月的彈性云服務(wù)器。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

POST /v1.1/{project_id}/cloudservers/{server_id}/resize

表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

是

項(xiàng)目ID。

獲取方法請(qǐng)參見獲取項(xiàng)目ID。

server_id

是

云服務(wù)器ID。

云服務(wù)器的ID可以從控制臺(tái)或者參考“查詢?cè)品?wù)器列表”的章節(jié)獲取。

請(qǐng)求消息

表2 參數(shù)說明

名稱

是否必選

參數(shù)類型

描述

resize

是

Object

標(biāo)記為云服務(wù)器變更規(guī)格操作，詳情參見 表3。

dry_run

否

Boolean

是否只預(yù)檢此次請(qǐng)求。

true：發(fā)送檢查請(qǐng)求，不會(huì)變更云服務(wù)器規(guī)格。檢查項(xiàng)包括是否填寫了必需參數(shù)、請(qǐng)求格式等。

  • 如果檢查不通過，則返回對(duì)應(yīng)錯(cuò)誤。
  • 如果檢查通過，則返回202狀態(tài)碼。

false：發(fā)送正常請(qǐng)求，通過檢查后并且執(zhí)行變更云服務(wù)器規(guī)格請(qǐng)求。
表3 resize數(shù)據(jù)結(jié)構(gòu)說明

名稱

是否必選

參數(shù)類型

描述

flavorRef

是

String

變更后的云服務(wù)器規(guī)格ID。

可以通過 查詢?cè)品?wù)器規(guī)格變更支持列表 接口查詢?cè)试S變更的規(guī)格列表。

說明：
  • 不支持變更至同一規(guī)格。

dedicated_host_id

否

String

新 專屬主機(jī) ID。

僅對(duì)于部署在專屬主機(jī)上的彈性云服務(wù)器，該參數(shù)必選。

extendparam

否

Object

變更云服務(wù)器擴(kuò)展信息，詳情參見 表4。

mode

否

String

取值為withStopServer ，支持開機(jī)狀態(tài)下變更規(guī)格。

mode取值為withStopServer時(shí)，對(duì)開機(jī)狀態(tài)的云服務(wù)器執(zhí)行變更規(guī)格操作，系統(tǒng)自動(dòng)對(duì)云服務(wù)器先執(zhí)行關(guān)機(jī)，再變更規(guī)格，變更成功后再執(zhí)行開機(jī)。
表4 extendparam數(shù)據(jù)結(jié)構(gòu)說明

名稱

是否必選

參數(shù)類型

描述

isAutoPay

否

String

下單訂購(gòu)后，是否自動(dòng)從客戶的賬戶中支付，而不需要客戶手動(dòng)去進(jìn)行支付。

  • “true”：是（自動(dòng)支付）
  • “false”：否（需要客戶手動(dòng)支付）
說明：

當(dāng)彈性云服務(wù)器是按包年包月計(jì)費(fèi)時(shí)生效，該值為空時(shí)默認(rèn)為客戶手動(dòng)支付。

響應(yīng)消息

表5 參數(shù)說明

參數(shù)

是否必選

參數(shù)類型

描述

job_id

否

String

任務(wù)ID，變更按需的彈性云服務(wù)器規(guī)格時(shí)返回該參數(shù)。

查詢job狀態(tài)請(qǐng)參見查詢?nèi)蝿?wù)的執(zhí)行狀態(tài)

order_id

否

String

訂單號(hào)，變更包年包月的彈性云服務(wù)器規(guī)格時(shí)返回該參數(shù)。

請(qǐng)求示例

變更專屬主機(jī)上的云服務(wù)器的規(guī)格為“s3.large.2”，自動(dòng)支付且支持開機(jī)狀態(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"
    }
}

響應(yīng)示例

{
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}

或

{
    "order_id": "CS1711152257C60TL",
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}

或

{
    "error": {
        "message": "XXXX", 
        "code": "XXX"
    }
}

返回值

請(qǐng)參考通用請(qǐng)求返回值。

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼。

 

變更云服務(wù)器規(guī)格ResizeServer

意見反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失??！請(qǐng)稍后重試！