弹性公网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
请求参数
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
publicip |
是 |
publicip object |
弹性公网IP对象,请参见表3。 |
bandwidth |
是 |
bandwidth object |
带宽对象,请参见表4。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
name |
是 |
String |
|
size |
是 |
Integer |
|
share_type |
是 |
String |
|
charge_mode |
否 |
String |
|
请求示例
请求样例(IPv4 EIP独享带宽)
POST https://{Endpoint}/v1/{project_id}/publicips { "publicip": { "type": "5_bgp", "ip_version": 4 }, "bandwidth": { "name": "bandwidth123", "size": 10, "share_type": "PER" } }
响应消息
- 响应参数
表6 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:异常失败
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)
格式:yyyy-MM-dd HH:mm:ss
bandwidth_size
Integer
带宽大小,单位为Mbit/s。
alias
String
弹性公网IP名称
public_border_group
String
功能说明:表示中心站点资源或者边缘站点资源。
取值范围:
- center
- 边缘站点名称
约束限制:只能绑定与该字段相同的publicip资源
响应示例
响应样例(IPv4 EIP独享带宽)
{ "publicip": { "id": "f588ccfa-8750-4d7c-bf5d-2ede24414706", "alias": "tom", "public_border_group": "center", "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