華為云計算 云知識 更新彈性公網(wǎng)IPUpdatePublicip
更新彈性公網(wǎng)IPUpdatePublicip
時間: 2023-10-12 15:31:43
猜你想看：
實時語音識別 云服務器配置 CDN是什么意思 視頻點播加速 什么是云桌面

 

功能介紹

更新EIP，將EIP跟一個網(wǎng)卡綁定或者解綁定，轉(zhuǎn)換IP地址版本類型。

調(diào)試

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

URI

PUT /v1/{project_id}/publicips/{publicip_id}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

是

String

項目ID

publicip_id

是

String

EIP唯一標識

最大長度：36

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

publicip

是

UpdatePublicipOption object

EIP對象
表3 UpdatePublicipOption

參數(shù)

是否必選

參數(shù)類型

描述

port_id

否

String

  • 功能說明：端口id

  • 約束：

    • 必須是存在的端口id，如果不帶該參數(shù)或者值為空時為解除綁定EIP，如果該端口不存在或端口已綁定EIP則會提示出錯。

    • 和ip_version字段互斥，不能同時更新。

    • 如果alias和port_id都攜帶，只有alias生效。

最大長度：36

ip_version

否

Integer

  • 功能說明：IP版本信息

  • 取值范圍：4和6，IPv6為開啟NAT64能力

    • 4：IPv4

    • 6：IPv6

  • 約束：

    • 必須是系統(tǒng)支持的IP版本類型

    • 和port_id互斥，不能同時更新。

枚舉值：

  • 4

  • 6

alias

否

String

  • 功能說明： 彈性公網(wǎng)IP 名稱

  • 取值范圍：1-64個字符，支持數(shù)字、字母、中文、_(下劃線)、-（中劃線）、.（點）

  • 約束：如果alias和port_id都攜帶，只有alias生效。

最大長度：64

響應參數(shù)

狀態(tài)碼： 200

表4 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

publicip

PublicipUpdateResp object

更新彈性 公網(wǎng)IP 的返回對象
表5 PublicipUpdateResp

參數(shù)

參數(shù)類型

描述

bandwidth_id

String

  • 功能說明：EIPIP對應帶寬ID

最大長度：36

bandwidth_name

String

  • 功能說明：帶寬名稱

最小長度：1

最大長度：64

bandwidth_share_type

String

  • 功能說明：EIP的帶寬類型

  • 取值范圍：PER，WHOLE。

    • WHOLE表示共享帶寬

    • PER表示獨享帶寬

  • 約束：其中IPv6暫不支持WHOLE類型帶寬。

枚舉值：

  • WHOLE

  • PER

bandwidth_size

Integer

  • 功能說明：帶寬大小，單位為Mbit/s。

最小值：0

create_time

String

  • 功能說明：EIP申請時間（UTC）

enterprise_project_id

String

  • 企業(yè)項目ID。最大長度36字節(jié)，帶“-”連字符的UUID格式，或者是字符串“0”。

  • 創(chuàng)建彈性公網(wǎng)IP時，給彈性公網(wǎng)IP綁定企業(yè)項目ID。

  • 不指定該參數(shù)時，默認值是 0

關(guān)于企業(yè)項目ID的獲取及企業(yè)項目特性的詳細信息，請參見《企業(yè)管理用戶指南》。

最大長度：36

id

String

  • 功能說明：EIP唯一標識

最大長度：36

port_id

String

  • 功能說明：端口id。

  • 約束：只有綁定了的EIP查詢才會返回該參數(shù)

最大長度：36

private_ip_address

String

  • 功能說明：綁定EIP的私有IP地址

  • 約束：只有綁定了的EIP查詢才會返回該參數(shù)

profile

ProfileResp object

  • 功能說明：額外參數(shù)，包括訂單id、產(chǎn)品id等信息

  • 約束：如果profile不為空，說明是包周期的EIP

public_ip_address

String

  • 功能說明：IPv4時是申請到的EIP地址，IPv6時是IPv6地址對應的IPv4地址

最大長度：15

status

String

  • 功能說明：EIP的狀態(tài)

  • 取值范圍：

    • FREEZED：凍結(jié)

    • BIND_ERROR：綁定失敗

    • BINDING：綁定中

    • PENDING_DELETE：釋放中

    • PENDING_CREATE：創(chuàng)建中

    • NOTIFYING：創(chuàng)建中

    • NOTIFY_DELETE：釋放中

    • PENDING_UPDATE：更新中

    • DOWN：未綁定

    • ACTIVE：綁定

    • ELB：綁定ELB

    • VPN：綁定VPN

    • ERROR：失敗

枚舉值：

  • FREEZED

  • BIND_ERROR

  • BINDING

  • PENDING_DELETE

  • PENDING_CREATE

  • NOTIFYING

  • NOTIFY_DELETE

  • PENDING_UPDATE

  • DOWN

  • ACTIVE

  • ELB

  • VPN

  • ERROR

tenant_id

String

  • 功能說明：項目ID

最大長度：36

type

String

  • 功能說明：EIP的類型

  • 取值范圍：5_bgp（全動態(tài)BGP），5_sbgp（靜態(tài)BGP），5_youxuanbgp（優(yōu)選BGP）

    • 華南-廣州：5_bgp、5_sbgp

    • 華東-上海一：5_bgp、5_sbgp

    • 華東-上海二：5_bgp、5_sbgp

    • 華北-北京一：5_bgp、5_sbgp

    • 中國-香港：5_bgp、5_youxuanbgp

    • 亞太-曼谷：5_bgp

    • 亞太-新加坡：5_bgp

    • 非洲-約翰內(nèi)斯堡：5_bgp

    • 西南-貴陽一：5_sbgp

    • 華北-北京四：5_bgp、5_sbgp

    • 拉美-圣地亞哥：5_bgp

    • 拉美-圣保羅一：5_bgp

    • 拉美-墨西哥城一：5_bgp

    • 拉美-布宜諾斯艾利一：5_bgp

    • 拉美-利馬一：5_bgp

    • 拉美-圣地亞哥二： 5_bgp

  • 約束：

    • 必須是系統(tǒng)具體支持的類型。

    • publicip_id為IPv4端口，所以"type"字段未給定時，默認為5_bgp。

最大長度：36

public_ipv6_address

String

  • 功能說明：IPv4時無此字段，IPv6時為申請到的EIP地址

最大長度：39

ip_version

Integer

  • 功能說明：IP版本信息

  • 取值范圍是4和6，IPV6為開啟NAT64能力

    • 4：IPv4

    • 6：IPv6

枚舉值：

  • 4

  • 6

alias

String

  • 功能說明：彈性公網(wǎng)IP名稱

  • 取值范圍：1-64個字符，支持數(shù)字、字母、中文、_(下劃線)、-（中劃線）、.（點）

最大長度：64
表6 ProfileResp

參數(shù)

參數(shù)類型

描述

order_id

String

訂單的id

最大長度：36

product_id

String

產(chǎn)品的id

最大長度：36

region_id

String

region的id

最大長度：36

user_id

String

用戶的id

最大長度：36

請求示例

  • 綁定id為f588ccfa-8750-4d7c-bf5d-2ede24414706的實例。

    {
  "publicip" : {
    "port_id" : "f588ccfa-8750-4d7c-bf5d-2ede24414706"
  }
}

  • 將EIP的ip_version更新為ipv6。

    {
  "publicip" : {
    "ip_version" : 6
  }
}

響應示例

狀態(tài)碼： 200

GET和PUT操作正常返回

{
  "publicip" : {
    "tenant_id" : "8b7e35ad379141fc9df3e178bd64f55c",
    "bandwidth_size" : 6,
    "public_ip_address" : "161.xx.xx.7",
    "create_time" : "2015-07-16 04:10:52",
    "ip_version" : 4,
    "port_id" : "f588ccfa-8750-4d7c-bf5d-2ede24414706",
    "id" : "f588ccfa-8750-4d7c-bf5d-2ede24414706",
    "type" : "5_bgp",
    "status" : "PENDING_UPDATE"
  }
}

狀態(tài)碼

狀態(tài)碼

描述

200

GET和PUT操作正常返回

錯誤碼

請參見錯誤碼。

 

更新彈性公網(wǎng)IPUpdatePublicip

意見反饋

0/200

提交 取消

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