弹性公网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(Elastic IP)提供独立的公网IP资源,包括公网IP地址与公网出口带宽服务。可以与弹性云服务器、裸金属服务器、虚拟IP、弹性负载均衡、NAT网关等资源灵活地绑定及解绑。
URI
POST /v1/{project_id}/publicips
请求消息
- 请求参数
表4 bandwidth字段说明 名称
是否必选
参数类型
说明
name
是
String
- 功能说明:带宽名称
- 取值范围:1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)
- 如果share_type是PER,该参数必须带,如果share_type是WHOLE并且id有值,该参数会忽略。
size
是
Integer
- 功能说明:带宽大小
- 取值范围:默认1Mbit/s~300Mbit/s(具体范围以各区域配置为准,请参见控制台对应页面显示)。
- 约束:share_type是PER,该参数必须带,如果share_type是WHOLE并且id有值,该参数会忽略。
- 注意:调整带宽时的最小单位会根据带宽范围不同存在差异。
- 小于等于300Mbit/s:默认最小单位为1Mbit/s。
- 300Mbit/s~1000Mbit/s:默认最小单位为50Mbit/s。
- 大于1000Mbit/s:默认最小单位为500Mbit/s。
share_type
是
String
- 功能说明:带宽类型
- 取值为PER,表示独享带宽
charge_mode
否
String
- 取值为traffic,表示流量计费。
- 请求样例一(IPv4 EIP独享带宽)
POST https://{Endpoint}/v1/{project_id}/publicips { "publicip": { "type": "5_bgp", "ip_version": 4 }, "bandwidth": { "name": "bandwidth123", "size": 10, "share_type": "PER" } }
响应消息
- 响应参数
表5 响应参数 名称
参数类型
说明
publicip
Object
弹性公网IP对象,请参见表6。
表6 publicip字段说明 名称
参数类型
说明
id
String
弹性公网IP唯一标识
status
String
- 功能说明:弹性公网IP的状态
- 取值范围:
- FREEZED:冻结
- BIND_ERROR:绑定失败
- BINDING:绑定中
- PENDING_DELETE:释放中
- PENDING_CREATE:创建中
- PENDING_UPDATE:更新中
- DOWN:未绑定
- ACTIVE:绑定
- ELB:绑定ELB
- ERROR:异常失败
type
String
- 功能说明:弹性公网IP的类型
- 取值范围:5_bgp
- 约束:
- 必须是系统具体支持的类型
- publicip_id为IPv4端口,所以"publicip_type"字段未给定时,默认为5_bgp。
public_ip_address
String
IPv4时是申请到的弹性公网IP地址
tenant_id
String
项目ID
create_time
String
弹性公网IP申请时间(UTC)
bandwidth_size
Integer
带宽大小,单位为Mbit/s。
- 响应样例一(IPv4 EIP独享带宽)
{ "publicip": { "id": "f588ccfa-8750-4d7c-bf5d-2ede24414706", "status": "PENDING_CREATE", "type": "5_bgp", "public_ip_address": "161.xx.xx.7", "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c", "ip_version": 4, "create_time": "2015-07-16 04:10:52", "bandwidth_size": 0 } }
状态码
请参见状态码。
错误码
请参考错误码。
父主题: 弹性公网IP