project_id

是

String

项目ID

publicip_id

是

String

EIP唯一标识

最大长度：36

publicip

是

UpdatePublicipOption object

EIP对象

port_id

否

String

• 功能说明：端口id

• 约束：

  • 必须是存在的端口id，如果不带该参数或者值为空时为解除绑定EIP，如果该端口不存在或端口已绑定EIP则会提示出错。

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

  • 如果alias和port_id都携带，只有alias生效。

最大长度：36

ip_version

否

Integer

• 功能说明：IP版本信息

• 取值范围：4和6，IPv6为开启NAT64能力

  • 4：IPv4

  • 6：IPv6

• 约束：

  • 必须是系统支持的IP版本类型

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

枚举值：

• 4

• 6

alias

否

String

• 功能说明： 弹性公网IP 名称

• 取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）

• 约束：如果alias和port_id都携带，只有alias生效。

最大长度：64

publicip

PublicipUpdateResp object

更新弹性 公网IP 的返回对象

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

• 企业项目ID。最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。

• 创建弹性公网IP时，给弹性公网IP绑定企业项目ID。

• 不指定该参数时，默认值是 0

关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。

最大长度：36

id

String

• 功能说明：EIP唯一标识

最大长度：36

port_id

String

• 功能说明：端口id。

• 约束：只有绑定了的EIP查询才会返回该参数

最大长度：36

private_ip_address

String

• 功能说明：绑定EIP的私有IP地址

• 约束：只有绑定了的EIP查询才会返回该参数

profile

ProfileResp object

• 功能说明：额外参数，包括订单id、产品id等信息

• 约束：如果profile不为空，说明是包周期的EIP

public_ip_address

String

• 功能说明：IPv4时是申请到的EIP地址，IPv6时是IPv6地址对应的IPv4地址

最大长度：15

status

String

• 功能说明：EIP的状态

• 取值范围：

  • FREEZED：冻结

  • BIND_ERROR：绑定失败

  • BINDING：绑定中

  • PENDING_DELETE：释放中

  • PENDING_CREATE：创建中

  • NOTIFYING：创建中

  • 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（全动态BGP），5_sbgp（静态BGP），5_youxuanbgp（优选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

  • 非洲-约翰内斯堡：5_bgp

  • 西南-贵阳一：5_sbgp

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

  • 拉美-圣地亚哥：5_bgp

  • 拉美-圣保罗一：5_bgp

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

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

  • 拉美-利马一：5_bgp

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

• 约束：

  • 必须是系统具体支持的类型。

  • 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

• 功能说明：弹性公网IP名称

• 取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）

最大长度：64

order_id

String

订单的id

最大长度：36

product_id

String

产品的id

最大长度：36

region_id

String

region的id

最大长度：36

user_id

String

用户的id

最大长度：36

200

GET和PUT操作正常返回