更新时间:2024-04-18 GMT+08:00
申请弹性公网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