華為云計(jì)算 云知識(shí) 更換云服務(wù)器計(jì)費(fèi)模式ChangeServerChargeMode
更換云服務(wù)器計(jì)費(fèi)模式ChangeServerChargeMode

 

接口說(shuō)明

更換 云服務(wù)器 的計(jì)費(fèi)模式

約束說(shuō)明
  • 僅支持更換按需計(jì)費(fèi)模式為包周期計(jì)費(fèi)模式。
  • 最大支持批量更換10個(gè)彈性云服務(wù)器計(jì)費(fèi)模式。
  • 更換計(jì)費(fèi)模式的云服務(wù)器綁定的 彈性公網(wǎng)IP 類型必須是“獨(dú)享”,“按帶寬計(jì)費(fèi)”。
  • 掛載了共享 云硬盤 、DSS硬盤以及DESS硬盤的的服務(wù)器不支持更改計(jì)費(fèi)模式。
  • 若想使用優(yōu)惠券,請(qǐng)將prepaid_options中的字段is_auto_pay設(shè)置為false,參考華為官網(wǎng)“支付包周期產(chǎn)品訂單”進(jìn)行支付,或者在華為云控制臺(tái)使用優(yōu)惠券進(jìn)行支付。
  • 不支持 專屬主機(jī) 、專屬云以及 邊緣云 下的云服務(wù)器更換計(jì)費(fèi)模式
  • 不支持競(jìng)價(jià)實(shí)例更換計(jì)費(fèi)模式
URL
POST  https://ecs.cn-north-1.myhuaweicloud.com/v1/{project_id}/cloudservers/actions/change-charge-mode 
請(qǐng)求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

用戶Token。

通過(guò)調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。

project_id
 
string path

項(xiàng)目ID。

Body參數(shù)
名稱 類型 必選 描述
server_ids
 
Array of strings

云服務(wù)器ID列表

charge_mode
 
string

更換后的計(jì)費(fèi)模式:prePaid包周期計(jì)費(fèi)模式

prepaid_options
 
ChangeServerChargeModePrepaidOption object

包周期選項(xiàng)

dry_run
 
boolean

是否預(yù)先校驗(yàn)此次請(qǐng)求。 true: 發(fā)送檢查請(qǐng)求,不觸發(fā)真正的計(jì)費(fèi)轉(zhuǎn)換操作 false: 發(fā)送正常請(qǐng)求,觸發(fā)計(jì)費(fèi)轉(zhuǎn)換操作。 默認(rèn)值為false

參數(shù):
prepaid_options
名稱 類型 必選 描述
include_data_disks
 
boolean

是否連同支持的按需數(shù)據(jù)盤一起轉(zhuǎn)為包周期。 當(dāng)參數(shù)為true,包括按需非共享的數(shù)據(jù)盤,不包括共享云硬盤,DSS和DESS硬盤 默認(rèn)值為false

include_publicips
 
boolean

是否連同彈性 公網(wǎng)IP 一起轉(zhuǎn)為包周期 只有“獨(dú)享”、“按帶寬計(jì)費(fèi)”的彈性公網(wǎng)IP才可以轉(zhuǎn)換為包周期計(jì)費(fèi)模式 默認(rèn)值為false

period_type
 
string

訂購(gòu)周期類型,取值范圍: month-月 year-年

period_num
 
string

訂購(gòu)周期的周期數(shù)。 取值范圍: period_type=month時(shí),取值范圍為[1,9]。 period_type=year時(shí),取值范圍為[1,3]。

auto_pay
 
boolean

是否自動(dòng)支付。 true:自動(dòng)支付,需要確保賬戶余額充足,如果余額不足則會(huì)生成異常訂單,只能作廢此訂單 false:只生成訂單不扣費(fèi) 默認(rèn)值為false

auto_renew
 
boolean

是否自動(dòng)續(xù)費(fèi)。默認(rèn)值:false

返回參數(shù)
返回碼: 200

OK

名稱 類型 必選 描述
order_id
 
string

按需轉(zhuǎn)包提交后返回的訂單ID,用戶可以使用該ID對(duì)訂單結(jié)果進(jìn)行查詢。

請(qǐng)求示例
示例 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"
}
SDK
點(diǎn)擊 彈性云服務(wù)器 (ECS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對(duì)應(yīng)語(yǔ)言類型的【使用】目錄下。
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說(shuō)明。