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

 

功能介紹

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

調試

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

URI

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

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

是

String

項目 ID

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

publicip_ids

是

Array

待按需轉包IP列表

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ù)類型

描述

publicip_ids

Array

轉包IP列表

order_id

String

訂單ID

request_id

String

請求ID

請求示例

將ID為fe2a11c7-c880-49f7-b1e0-e151df2cc836的按需 彈性公網(wǎng)IP 轉為包周期彈性 公網(wǎng)IP ，訂購周期為1個月，不自動續(xù)費。

{
  "publicip_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

請求成功

{
  "publicip_ids" : [ "2c3b404b-d595-4ab5-a333-69f3ff937dc2" ],
  "order_id" : "CS2212141730K2FGR",
  "request_id" : "9d5bc34c-810f-48f2-95c4-9c48d02f2a33"
}

狀態(tài)碼

狀態(tài)碼

描述

200

請求成功

錯誤碼

請參見錯誤碼。

 

按需轉包接口ChangePublicipToPeriod

意見反饋

0/200

提交 取消

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