申请弹性公网IP（按需计费）
功能介绍
申请弹性公网IP。
弹性公网IP（Elastic IP）提供独立的公网IP资源，包括公网IP地址与公网出口带宽服务。可以与弹性云服务器、裸金属服务器、虚拟IP、弹性负载均衡、NAT网关等资源灵活地绑定及解绑。拥有多种灵活的计费方式，可以满足各种业务场景。
URI
POST /v1/{project_id}/publicips
请求参数
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
publicip |
是 |
publicip object |
弹性公网IP对象，请参见表3。 |
|
bandwidth |
是 |
bandwidth object |
带宽对象，请参见表4。 |
|
enterprise_project_id |
否 |
String |
说明：
关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。 |
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
type |
是 |
String |
|
|
ip_version |
否 |
Integer |
|
|
ip_address |
否 |
String |
|
|
alias |
否 |
String |
|
|
port_id |
否 |
String |
|
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
name |
否 |
String |
|
|
size |
否 |
Integer |
|
|
id |
否 |
String |
|
|
share_type |
是 |
String |
|
|
charge_mode |
否 |
String |
|
请求示例
POST https://{Endpoint}/v1/{project_id}/publicips
{
"publicip": {
"type": "5_bgp",
"ip_version": 4
},
"bandwidth": {
"name": "bandwidth123",
"size": 10,
"share_type": "PER"
},
"enterprise_project_id":"b261ac1f-2489-4bc7-b31b-c33c3346a439"
}
响应消息
- 响应参数
表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（全动态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
tenant_id
String
项目ID
create_time
String
弹性公网IP申请时间（UTC）
格式：yyyy-MM-dd HH:mm:ss
bandwidth_size
Integer
带宽大小，单位为Mbit/s。
alias
String
弹性公网IP名称
enterprise_project_id
String
- 企业项目ID。最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。
- 创建弹性公网IP时，给弹性公网IP绑定企业项目ID。
- 不指定该参数时，默认值是“0”，0表示默认企业项目。
说明：关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。
public_border_group
String
功能说明：表示中心站点资源或者边缘站点资源。
取值范围：
- center
- 边缘站点名称
约束限制：只能绑定与该字段相同的publicip资源
响应示例
{
"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,
"enterprise_project_id": "b261ac1f-2489-4bc7-b31b-c33c3346a439"
}
}
状态码
请参见状态码。
错误码
请参考错误码。
