创建浮动IP
功能介绍
创建浮动IP时需要浮动IP的外部网络ID“floating_network_id”。
创建浮动IP时的外部网络UUID，请使用GET /v2.0/networks?router:external=True或neutron net-external-list方式获取。
URI
POST /v2.0/floatingips
请求消息
|
参数名称 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
floatingip |
floatingip object |
是 |
floatingip对象列表，参见表2。 |
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
floating_ip_address |
否 |
String |
浮动IP地址。 |
|
floating_network_id |
是 |
String |
外部网络的id。 只能使用固定的外网，外部网络的信息请通过 GET /v2.0/networks?router:external=True或 GET /v2.0/networks?name={floating_network}或 neutron net-external-list方式查询。 |
|
port_id |
否 |
String |
端口id |
|
fixed_ip_address |
否 |
String |
关联端口的私有IP地址。 |
响应消息
|
参数名称 |
类型 |
说明 |
|---|---|---|
|
floatingip |
floatingip object |
floatingip对象列表，参见表4。 |
|
属性 |
类型 |
说明 |
|---|---|---|
|
status |
String |
网络状态，可以为ACTIVE， DOWN或ERROR。
|
|
id |
String |
浮动IP地址的id。 |
|
floating_ip_address |
String |
浮动IP地址。 |
|
floating_network_id |
String |
外部网络的id。 |
|
router_id |
String |
所属路由器id。 |
|
port_id |
String |
端口id |
|
fixed_ip_address |
String |
关联端口的私有IP地址。 |
|
tenant_id |
String |
项目ID 。 |
|
dns_name |
String |
DNS名称 该参数当前仅在“华南-广州”开放 |
|
dns_domain |
String |
DNS域地址 该参数当前仅在“华南-广州”开放 |
请求示例
创建网络为0a2228f2-7f8a-45f1-8e09-9039e1d09975的浮动IP。
POST https://{Endpoint}/v2.0/floatingips
{
"floatingip": {
"floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975"
}
}
响应示例
状态码： 201
POST操作正常返回
{
"floatingip": {
"id": "b997e0d4-3359-4c74-8f88-bc0af81cd5a2",
"status": "DOWN",
"router_id": null,
"tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
"fixed_ip_address": null,
"floating_ip_address": "88.88.215.205",
"port_id": null,
}
}
状态码
请参见状态码。
错误码
请参见错误码。
