接口說明
更換 云服務器 的計費模式
約束說明
- 僅支持更換按需計費模式為包周期計費模式。
- 最大支持批量更換10個彈性云服務器計費模式。
- 更換計費模式的云服務器綁定的 彈性公網(wǎng)IP 類型必須是“獨享”,“按帶寬計費”。
- 掛載了共享 云硬盤 、DSS硬盤以及DESS硬盤的的服務器不支持更改計費模式。
- 若想使用優(yōu)惠券,請將prepaid_options中的字段is_auto_pay設置為false,參考華為官網(wǎng)“支付包周期產(chǎn)品訂單”進行支付,或者在華為云控制臺使用優(yōu)惠券進行支付。
- 不支持 專屬主機 、專屬云以及 邊緣云 下的云服務器更換計費模式
- 不支持競價實例更換計費模式
URL
POST https://ecs.cn-north-1.myhuaweicloud.com/v1/{project_id}/cloudservers/actions/change-charge-mode
請求參數(shù)
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用戶Token。 通過調(diào)用 IAM 服務獲取用戶Token接口獲取(響應消息頭中X-Subject-Token的值)。 |
|
project_id
|
string | path | 是 |
項目ID。 |
Body參數(shù)
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
server_ids
|
Array of strings | 是 |
云服務器ID列表 |
|
charge_mode
|
string | 是 |
更換后的計費模式:prePaid包周期計費模式 |
|
prepaid_options
|
ChangeServerChargeModePrepaidOption object | 否 |
包周期選項 |
|
dry_run
|
boolean | 否 |
是否預先校驗此次請求。 true: 發(fā)送檢查請求,不觸發(fā)真正的計費轉(zhuǎn)換操作 false: 發(fā)送正常請求,觸發(fā)計費轉(zhuǎn)換操作。 默認值為false |
參數(shù)：
prepaid_options
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
include_data_disks
|
boolean | 否 |
是否連同支持的按需數(shù)據(jù)盤一起轉(zhuǎn)為包周期。 當參數(shù)為true,包括按需非共享的數(shù)據(jù)盤,不包括共享云硬盤,DSS和DESS硬盤 默認值為false |
|
include_publicips
|
boolean | 否 |
是否連同彈性 公網(wǎng)IP 一起轉(zhuǎn)為包周期 只有“獨享”、“按帶寬計費”的彈性公網(wǎng)IP才可以轉(zhuǎn)換為包周期計費模式 默認值為false |
|
period_type
|
string | 是 |
訂購周期類型,取值范圍: month-月 year-年 |
|
period_num
|
string | 是 |
訂購周期的周期數(shù)。 取值范圍: period_type=month時,取值范圍為[1,9]。 period_type=year時,取值范圍為[1,3]。 |
|
auto_pay
|
boolean | 否 |
是否自動支付。 true:自動支付,需要確保賬戶余額充足,如果余額不足則會生成異常訂單,只能作廢此訂單 false:只生成訂單不扣費 默認值為false |
|
auto_renew
|
boolean | 否 |
是否自動續(xù)費。默認值:false |
返回參數(shù)
返回碼: 200
OK
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
order_id
|
string | 是 |
按需轉(zhuǎn)包提交后返回的訂單ID,用戶可以使用該ID對訂單結(jié)果進行查詢。 |
請求示例
示例 1
"POST https://{endpoint}/v1/{project_id}/cloudservers/actions/change-charge-mode"
{ "server_ids": [ "6acbe5aa-2e41-4d41-9d1e-59957e1b79f3" ], "charge_mode": "prePaid", "prepaid_options": { "include_publicips": "false", "include_data_disks": "false", "period_type": "month", "period_num": "1", "auto_pay": "true", "auto_renew": "false" }, "dry_run": "false" }
返回示例
返回碼：200
OK
示例 1
{
"order_id": "CS2209141549862WI"
}
"order_id": "CS2209141549862WI"
}
SDK
點擊 彈性云服務器 (ECS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認證方式等在SDK文檔中對應語言類型的【使用】目錄下。
錯誤碼
請參考 錯誤碼說明。
