華為云計(jì)算 云知識 批量創(chuàng)建彈性公網(wǎng)IPBatchCreatePublicips
批量創(chuàng)建彈性公網(wǎng)IPBatchCreatePublicips

 

功能介紹

批量創(chuàng)建 彈性公網(wǎng)IP

調(diào)試

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

URI

POST /v2/{project_id}/batchpublicips

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目id

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

bandwidth

BatchBandwidth object

帶寬信息

publicip

BatchPublicIp object

彈性 公網(wǎng)IP 信息

publicip_number

Integer

批量創(chuàng)建EIP的個數(shù)

enterprise_project_id

String

企業(yè)項(xiàng)目id

表3 BatchBandwidth

參數(shù)

是否必選

參數(shù)類型

描述

charge_mode

String

  • 功能說明:按流量計(jì)費(fèi)還是按帶寬計(jì)費(fèi)。其中IPv6國外默認(rèn)是bandwidth,國內(nèi)默認(rèn)是traffic。取值為traffic,表示流量計(jì)費(fèi)。

枚舉值:

  • bandwidth

  • traffic

name

String

  • 功能說明:帶寬名稱

  • 取值范圍:1-64個字符,支持?jǐn)?shù)字、字母、中文、_(下劃線)、-(中劃線)、.(點(diǎn))

  • 約束:如果share_type是PER,該參數(shù)必須帶,如果share_type是WHOLE并且id有值,該參數(shù)會忽略。

最小長度:1

最大長度:64

share_type

String

  • 功能說明:帶寬類型

  • 取值范圍:PER,WHOLE。其中IPv6暫不支持WHOLE類型帶寬。

枚舉值:

  • PER

  • WHOLE

size

Integer

  • 功能說明:帶寬大小

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

  • 約束:share_type是PER,該參數(shù)必須帶,如果share_type是WHOLE并且id有值,該參數(shù)會忽略。

  • 注意:調(diào)整帶寬時(shí)的最小單位會根據(jù)帶寬范圍不同存在差異。

    • 小于等于300Mbit/s:默認(rèn)最小單位為1Mbit/s。

    • 300Mbit/s~1000Mbit/s:默認(rèn)最小單位為50Mbit/s。

    • 大于1000Mbit/s:默認(rèn)最小單位為500Mbit/s。

id

String

  • 功能說明:帶寬ID,創(chuàng)建WHOLE類型帶寬的彈性公網(wǎng)IP時(shí)可以指定之前的共享帶寬創(chuàng)建

  • 取值范圍:WHOLE類型的帶寬ID

表4 BatchPublicIp

參數(shù)

是否必選

參數(shù)類型

描述

id

String

指定id創(chuàng)建EIP

type

String

公網(wǎng)ip類型

枚舉值:

  • 5_bgp

  • 5_union

  • 5_sbgp

ip_version

String

公網(wǎng)EIP的版本,例如ipv4,ipv6。ipv6為開啟NAT64能力,默認(rèn)為ipv4

enterprise_project_id

String

企業(yè)項(xiàng)目id

tags

Array of strings

公網(wǎng)EIP標(biāo)簽

profile

BatchProfile object

訂單信息

表5 BatchProfile

參數(shù)

是否必選

參數(shù)類型

描述

user_id

String

租戶id

product_id

String

產(chǎn)品id

region_id

String

局點(diǎn)id

order_id

String

訂單id

響應(yīng)參數(shù)

狀態(tài)碼: 200

表6 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

job_id

String

job_id,需要訪問調(diào)用netAPI組件訪問job執(zhí)行情況。netAPI:/v1/{project_id}/jobs/{job_id}

請求示例

批量創(chuàng)建2個彈性公網(wǎng)IP,帶寬為按寬帶計(jì)費(fèi)、5M大小的獨(dú)享帶寬。

POST /v2/{project_id}/batchpublicips

{
  "bandwidth" : {
    "name" : "",
    "size" : 5,
    "charge_mode" : "bandwidth",
    "share_type" : "PER"
  },
  "publicip" : {
    "type" : "5_bgp",
    "tags" : [ ]
  },
  "publicip_number" : 2,
  "enterprise_project_id" : 0
}

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "job_id" : "ff8080828436722c0184cdb88e9200a5"
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯誤碼

請參見錯誤碼。