華為云計算 云知識 按需轉包APIChangeBandwidthToPeriod
按需轉包APIChangeBandwidthToPeriod
時間: 2023-10-16 15:51:42
猜你想看：
實時語音識別 云服務器配置 CDN是什么意思 視頻點播加速 什么是云桌面

 

功能介紹

該接口用于將按需計費模式的帶寬轉為包年/包月計費模式的帶寬。

調試

您可以在API Explorer中調試該接口，支持自動認證鑒權。API Explorer可以自動生成SDK代碼示例，并提供SDK代碼示例調試功能。

URI

POST /v2.0/{project_id}/bandwidths/change-to-period

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

是

String

項目ID

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

bandwidth_ids

是

Array

待按需轉包帶寬列表

extendParam

是

CreatePrePaidPublicipExtendParamOption object

按需轉包周期參數(shù)
表3 CreatePrePaidPublicipExtendParamOption

參數(shù)

是否必選

參數(shù)類型

描述

charge_mode

否

String

  • 功能說明：付費方式（預付費、按需付費；預付費，即包周期付費）

  • 取值范圍：

    • prePaid -預付費，即包年包月；

    • postPaid-后付費，即按需付費；

  • 后付費的場景下，extendParam的其他字段都會被忽略。

缺省值：postPaid

枚舉值：

  • prePaid

  • postPaid

period_type

否

String

  • 功能說明：訂購資源的周期類型（包年、包月等）

  • 取值范圍：

    • month-月

    • year-年

  • 約束：如果用包周期共享帶寬創(chuàng)建時（即攜帶共享帶寬id創(chuàng)建EIP）此字段可不填。付費方式是預付費且不是使用共享帶寬創(chuàng)建IP時，該字段必選； 使用共享帶寬創(chuàng)建IP時，帶寬資源到期時間與IP的到期時間相同。

枚舉值：

  • month

  • year

period_num

否

Integer

  • 功能說明：訂購周期數(shù)

  • 取值范圍：(后續(xù)會隨運營策略變化)

    • period_type為month時，為[1,9]

    • period_type為year時，為[1,3]

  • 約束：同period_type約束。

最小值：1

最大值：9

is_auto_renew

否

Boolean

  • 功能說明：是否自動續(xù)訂

  • 取值范圍： false：不自動續(xù)訂 true：自動續(xù)訂

  • 約束：到期后，默認自動續(xù)訂1個月（自動續(xù)訂時間后續(xù)可能會變化），詳情可聯(lián)系客服咨詢。

缺省值：false

is_auto_pay

否

Boolean

  • 功能說明：下單訂購后，是否自動從客戶的賬戶中支付

  • 取值范圍：

    • true：自動支付，從賬戶余額自動扣費

    • false：只提交訂單不支付，需要客戶手動去支付

  • 約束：自動支付時，只能使用賬戶的現(xiàn)金支付；如果要使用代金券，請選擇不自動支付，然后在用戶費用中心，選擇代金券支付。

缺省值：false

響應參數(shù)

狀態(tài)碼： 200

表4 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

bandwidth_ids

Array

轉包帶寬列表

order_id

String

訂單ID

request_id

String

請求ID

請求示例

將ID為fe2a11c7-c880-49f7-b1e0-e151df2cc836的按需帶寬轉為包周期帶寬，訂購周期為1個月，不自動續(xù)費。

POST /v2.0/{project_id}/bandwidths/change-to-period

{
  "bandwidth_ids" : [ "fe2a11c7-c880-49f7-b1e0-e151df2cc836" ],
  "extendParam" : {
    "charge_mode" : "prePaid",
    "period_type" : "month",
    "period_num" : 1,
    "is_auto_renew" : false,
    "is_auto_pay" : true
  }
}

響應示例

狀態(tài)碼： 200

按需轉包正常返回

{
  "bandwidth_ids" : [ "fe2a11c7-c880-49f7-b1e0-e151df2cc836" ],
  "order_id" : "CS2212141741L0QZG",
  "request_id" : "8b cad b5d-1bf4-42e8-909f-1606ecf781ce"
}

狀態(tài)碼

狀態(tài)碼

描述

200

按需轉包正常返回

錯誤碼

請參見錯誤碼。

 

按需轉包APIChangeBandwidthToPeriod

意見反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會繼續(xù)努力做到更好 反饋提交失?。≌埳院笾卦?！