華為云計算 云知識 共享帶寬移除彈性公網(wǎng)IPRemovePublicipsFromSharedBandwidth
共享帶寬移除彈性公網(wǎng)IPRemovePublicipsFromSharedBandwidth

 

功能介紹

共享帶寬移除EIP。

接口約束

在共享帶寬中批量移除EIP時,一次可批量操作100個EIP。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動認證鑒權(quán)。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/remove

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID,獲取項目ID請參見獲取項目ID

bandwidth_id

String

帶寬唯一標識

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

bandwidth

RemoveFromSharedBandwidthOption object

帶寬對象

表3 RemoveFromSharedBandwidthOption

參數(shù)

是否必選

參數(shù)類型

描述

charge_mode

String

  • 功能說明:EIP從共享帶寬移除后,會為此EIP創(chuàng)建獨占帶寬進行計費。 此參數(shù)表示EIP從共享帶寬移除后,使用的獨占帶寬的計費類型。(bandwidth/traffic)

枚舉值:

  • bandwidth

  • traffic

publicip_info

Array of RemovePublicipInfo objects

  • 功能說明:要從共享帶寬中移除的EIP信息

  • 約束:WHOLE類型的帶寬支持多個EIP,跟租戶的配額相關(guān),默認一個共享帶寬的配額為20

size

Integer

  • 功能說明:EIP從共享帶寬移除后,會為此EIP創(chuàng)建獨占帶寬進行計費。此參數(shù)表示EIP從共享帶寬移除后,使用的獨占帶寬的帶寬大小。(M)

  • 取值范圍:默認1Mbit/s~2000Mbit/s(具體范圍以各區(qū)域配置為準,請參見控制臺對應頁面顯示)。

表4 RemovePublicipInfo

參數(shù)

是否必選

參數(shù)類型

描述

publicip_type

String

  • 功能說明:若publicip_id為 彈性公網(wǎng)IP 的id,則該字段可自動忽略。若publicip_id為IPv6端口PORT的id,則該字段必填:5_dualStack(目前僅北京4局點支持)

最大長度:36

publicip_id

String

  • 功能說明:帶寬對應的彈性 公網(wǎng)IP 或IPv6端口PORT的唯一標識

最大長度:36

響應參數(shù)

請求示例

將id為d91b0028-6f6b-4478-808a-297b75b6812a、1d184b2c-4ec9-49b5-a3f9-27600a76ba3f的彈性公網(wǎng)IP移出按流量計費的共享帶寬,支持多個彈性公網(wǎng)IP移除共享帶寬。

{
  "bandwidth" : {
    "size" : 22,
    "publicip_info" : [ {
      "publicip_id" : "d91b0028-6f6b-4478-808a-297b75b6812a",
      "publicip_type" : "5_dualStack"
    }, {
      "publicip_id" : "1d184b2c-4ec9-49b5-a3f9-27600a76ba3f"
    } ],
    "charge_mode" : "traffic"
  }
}

響應示例

狀態(tài)碼

狀態(tài)碼

描述

204

POST操作正常返回

錯誤碼

請參見錯誤碼