弹性公网IP EIP
弹性公网IP EIP
- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
-
常见问题
-
产品咨询类
- 管理EIP配额
- 如何创建或找回指定的弹性公网IP?
- 为什么释放弹性公网IP后重新申请的与原有IP地址相同?
- 购买弹性公网IP时,是否可以指定IP地址?
- 弹性公网IP是否会变化?
- 在管理控制台找不到已购买EIP怎么办?
- 弹性公网IP的分配策略是什么?
- EIP是否支持跨账号使用或跨账号迁移?
- 如何查询EIP使用量?
- 共享流量包购买后需要设置吗?
- 弹性公网IP使用独享带宽进行限速过后能否变更为使用共享带宽进行限速?
- 一个EIP可以绑定至几个ECS使用?
- 弹性公网IP、私有IP和虚拟IP之间有何区别?
- 带宽加油包、共享流量包与共享带宽有什么区别?
- 优选BGP线路在什么场景下使用,以及有什么使用约束?
- EIP资源在什么情况下会被冻结,如何解除被冻结的EIP资源?
- 计费类
- 弹性公网IP绑定/解绑类
- 带宽类
- 连接类
-
产品咨询类
- 视频帮助
- 产品术语
-
更多文档
- 用户指南(阿布扎比区域)
- API参考(阿布扎比区域)
- 用户指南(吉隆坡区域)
- API参考(吉隆坡区域)
- 用户指南(安卡拉区域)
- API参考(安卡拉区域)
- 通用参考
链接复制成功!
更新弹性公网IP
功能介绍
更新弹性公网IP,将弹性公网IP跟一个网卡绑定或者解绑定,转换IP地址版本类型。
URI
PUT /v1/{project_id}/publicips/{publicip_id}
请求消息
- 请求参数
表3 publicip字段说明 名称
是否必选
参数类型
说明
port_id
否
String
- 功能说明:端口id。
- 约束:必须是存在的端口id,如果不带该参数或者值为空时为解除绑定弹性公网IP,如果该端口不存在或端口已绑定弹性公网IP则会提示出错
ip_version
否
Integer
- 功能说明:IP版本信息。
- 取值范围:4和6
- 4:IPv4
- 6:IPv6
- 约束:
- 必须是系统支持的IP版本类型
- 和port_id互斥:不能同时设置port_id和ip_version字段。
alias
否
String
- 功能说明:弹性公网IP名称
- 取值范围:1-64个字符,支持数字、字母、中文字符、_(下划线)、-(中划线)、.(点)
- 请求样例1(EIP绑定一张网卡)
PUT https://{Endpoint}/v1/{project_id}/publicips/{publicip_id} { "publicip": { "port_id": "f588ccfa-8750-4d7c-bf5d-2ede24414706" } }
响应消息
- 响应参数
表5 publicip字段说明 名称
参数类型
说明
id
String
弹性公网IP唯一标识
status
String
- 功能说明:弹性公网IP的状态
- 取值范围:
- FREEZED:冻结
- BIND_ERROR:绑定失败
- BINDING:绑定中
- PENDING_DELETE:释放中
- PENDING_CREATE:创建中
- PENDING_UPDATE:更新中
- NOTIFYING:创建中
- NOTIFY_DELETE:释放中
- DOWN:未绑定
- ACTIVE:绑定
- ELB:绑定ELB
- VPN:绑定VPN
- ERROR:异常失败
profile
profile object
功能说明:额外参数,包括订单id、产品id等信息,详情请参见表6。
type
String
- 功能说明:弹性公网IP的类型
- 取值范围:5_bgp(全动态BGP),5_sbgp(静态BGP)
- 华南-广州:5_bgp、5_sbgp
- 华东-上海一:5_bgp、5_sbgp
- 华东-上海二:5_bgp、5_sbgp
- 华北-北京一:5_bgp、5_sbgp
- 中国-香港:5_bgp
- 亚太-曼谷: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端口,所以"publicip_type"字段未给定时,默认为5_bgp。
public_ip_address
String
IPv4时是申请到的弹性公网IP地址。
public_ipv6_address
String
IPv4时无此字段,IPv6时为申请到的弹性公网IP地址
ip_version
Integer
IP版本信息,取值范围是4和6
- 4:表示IPv4
- 6:表示IPv6
private_ip_address
String
- 功能说明:绑定弹性公网IP的私有IP地址
- 约束:只有绑定了的弹性公网IP查询才会返回该参数
port_id
String
- 功能说明:端口id。
- 约束:只有绑定了的弹性公网IP查询才会返回该参数
tenant_id
String
项目ID
create_time
String
弹性公网IP申请时间(UTC)
格式:yyyy-MM-dd HH:mm:ss
bandwidth_id
String
弹性公网IP对应带宽ID
bandwidth_size
Integer
带宽大小,单位为Mbit/s。
bandwidth_share_type
String
- 功能说明:弹性公网IP的带宽类型
- 取值范围:PER,WHOLE。
- PER:独享带宽
- WHOLE:共享带宽
bandwidth_name
String
带宽名称。
alias
String
弹性公网IP名称
enterprise_project_id
String
- 企业项目ID。最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。
- 创建弹性公网IP时,给弹性公网IP绑定企业项目ID。
- 不指定该参数时,默认值是 0,0表示默认企业项目。
- 响应样例(EIP绑定一张网卡)
{ "publicip": { "id": "f6318bef-6508-4ea5-a48f-6152b6b1a8fb", "status": "ACTIVE", "alias": "tom", "profile": {}, "type": "5_bgp", "port_id": "a135e9b8-1630-40d2-a6c5-eb534a61efbe", "public_ip_address": "10.xx.xx.162", "private_ip_address": "192.168.1.131", "tenant_id": "26ae5181a416420998eb2093aaed84d9", "create_time": "2019-03-27 01:33:18", "bandwidth_size": 7, "ip_version": 4, "bandwidth_name": "bandwidth-2aef", "enterprise_project_id": "0", "bandwidth_share_type": "PER", "bandwidth_id": "7a258fff-10d8-44b8-8124-c59079eb8f4c" } }
状态码
请参见状态码。
错误码
请参考错误码。
父主题: 弹性公网IP