doc-exports/docs/eip/api-ref/eip_apifloatip_0003.html
Qin Ying, Fan 65b77b76d4 EIP API 20230106 version
Reviewed-by: Hajba, László Antal <laszlo-antal.hajba@t-systems.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
2023-08-01 06:58:15 +00:00

240 lines
23 KiB
HTML

<a name="eip_apifloatip_0003"></a><a name="eip_apifloatip_0003"></a>
<h1 class="topictitle1">Assigning a Floating IP Address</h1>
<div id="body8662426"><div class="section" id="eip_apifloatip_0003__en-us_topic_0201534148_section11888132742417"><h4 class="sectiontitle">Function</h4><p id="eip_apifloatip_0003__en-us_topic_0201534148_p154142351935">This API is used to assign a floating IP address and associates it with an internal port.</p>
<p id="eip_apifloatip_0003__en-us_topic_0201534148_p14817411070">Restrictions</p>
<p id="eip_apifloatip_0003__en-us_topic_0201534148_p44662345152533">You can use <strong id="eip_apifloatip_0003__en-us_topic_0201534148_b842352706193317">GET /v2.0/networks?router:external=True</strong> or run the <strong id="eip_apifloatip_0003__en-us_topic_0201534148_b842352706193322">neutron net-external-list</strong> command to obtain the UUID of the external network required for assigning a floating IP address. </p>
<p id="eip_apifloatip_0003__en-us_topic_0201534148_p590132813247">The <strong id="eip_apifloatip_0003__en-us_topic_0201534148_b84235270610597">port_id</strong> parameter value must be the ECS port ID, which can be obtained from the <strong id="eip_apifloatip_0003__en-us_topic_0201534148_b8423527061105">NIC ID</strong> parameter in the ECS NIC details. </p>
</div>
<div class="section" id="eip_apifloatip_0003__en-us_topic_0201534148_section18889102752414"><h4 class="sectiontitle">URI</h4><p id="eip_apifloatip_0003__en-us_topic_0201534148_p18754151319317">POST /v2.0/eip/floatingips_v6</p>
</div>
<div class="section" id="eip_apifloatip_0003__en-us_topic_0201534148_section12897127182417"><h4 class="sectiontitle">Request Message</h4><ul id="eip_apifloatip_0003__en-us_topic_0201534148_ul171911955442"><li id="eip_apifloatip_0003__en-us_topic_0201534148_li191916551541">Request parameter</li></ul>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="eip_apifloatip_0003__en-us_topic_0201534148_table9897182792411" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameter</caption><thead align="left"><tr id="eip_apifloatip_0003__en-us_topic_0201534148_row4901928152411"><th align="left" class="cellrowborder" valign="top" width="20.332033203320332%" id="mcps1.3.3.3.2.5.1.1"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p17909286242">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.341434143414341%" id="mcps1.3.3.3.2.5.1.2"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p990528122415">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.871887188718873%" id="mcps1.3.3.3.2.5.1.3"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1790172842414">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.45464546454646%" id="mcps1.3.3.3.2.5.1.4"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p20908289240">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="eip_apifloatip_0003__en-us_topic_0201534148_row390528202420"><td class="cellrowborder" valign="top" width="20.332033203320332%" headers="mcps1.3.3.3.2.5.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p18901928152418">floatingip</p>
</td>
<td class="cellrowborder" valign="top" width="14.341434143414341%" headers="mcps1.3.3.3.2.5.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p59052812419"><a href="#eip_apifloatip_0003__en-us_topic_0201534148_table1831319135111">floatingip</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="18.871887188718873%" headers="mcps1.3.3.3.2.5.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p10901328162413">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="46.45464546454646%" headers="mcps1.3.3.3.2.5.1.4 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1290152892416">Specifies the floating IP address list. For details, see <a href="#eip_apifloatip_0003__en-us_topic_0201534148_table1831319135111">Table 2</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="eip_apifloatip_0003__en-us_topic_0201534148_table1831319135111"></a><a name="en-us_topic_0201534148_table1831319135111"></a><table cellpadding="4" cellspacing="0" summary="" id="eip_apifloatip_0003__en-us_topic_0201534148_table1831319135111" frame="border" border="1" rules="all"><caption><b>Table 2 </b><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b112262316402">floatingip</strong> objects</caption><thead align="left"><tr id="eip_apifloatip_0003__en-us_topic_0201534148_row19314513319"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.3.4.2.5.1.1"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p0685313416"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b135273324019">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.52%" id="mcps1.3.3.4.2.5.1.2"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p768561134110"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b4456163419400">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.4.2.5.1.3"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p368681134120"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b187798356407">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="43.480000000000004%" id="mcps1.3.3.4.2.5.1.4"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p668612124119"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b88879361404">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="eip_apifloatip_0003__en-us_topic_0201534148_row163140131813"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p176864111411">id</p>
</td>
<td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.3.3.4.2.5.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p136865110419">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p16861211413">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.480000000000004%" headers="mcps1.3.3.4.2.5.1.4 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1068611114119">Specifies the floating IP address ID.</p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row16314131310111"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p868615164111">floating_ip_address</p>
</td>
<td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.3.3.4.2.5.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1468611134120">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1668716114415">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.480000000000004%" headers="mcps1.3.3.4.2.5.1.4 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p76878124112">Specifies the floating IPv6 address.</p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row2314413713"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1668781104117">floating_network_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.3.3.4.2.5.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1668731204116">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1687610411">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.480000000000004%" headers="mcps1.3.3.4.2.5.1.4 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p14687611411">Specifies the external network ID.</p>
<p id="eip_apifloatip_0003__en-us_topic_0201534148_p4687818419">You can only use fixed external network. </p>
<p id="eip_apifloatip_0003__en-us_topic_0201534148_p9687151144115">You can use <strong id="eip_apifloatip_0003__en-us_topic_0201534148_b859712515444">GET /v2.0/networks?router:external=True</strong> or</p>
<p id="eip_apifloatip_0003__en-us_topic_0201534148_p1568711118416"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b250712598233">GET /v2.0/networks?name={floating_network}</strong> or run the <strong id="eip_apifloatip_0003__en-us_topic_0201534148_b4508059182316">neutron net-external-list</strong> command to obtain information about the external network. </p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row11315913213"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p106871419413">router_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.3.3.4.2.5.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1268712115416">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p6687015419">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.480000000000004%" headers="mcps1.3.3.4.2.5.1.4 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p668714111415">Specifies the ID of the belonged router. </p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row1331541317114"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1868717104113">port_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.3.3.4.2.5.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p26871119419">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p66889116414">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.480000000000004%" headers="mcps1.3.3.4.2.5.1.4 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p14688213413">Specifies the port ID. </p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row23153134114"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p868818134116">fixed_ip_address</p>
</td>
<td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.3.3.4.2.5.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p568817111417">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p96881617413">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.480000000000004%" headers="mcps1.3.3.4.2.5.1.4 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1668816118413">Specifies the private IP address of the associated port.</p>
<p id="eip_apifloatip_0003__en-us_topic_0201534148_p26881415412">This value can only be dynamically assigned by the system.</p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row10316113617"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.3.4.2.5.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p968813113416">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.52%" headers="mcps1.3.3.4.2.5.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p468815111414">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.4.2.5.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p12688141154119">String</p>
</td>
<td class="cellrowborder" valign="top" width="43.480000000000004%" headers="mcps1.3.3.4.2.5.1.4 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p10487112">Specifies the project ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="eip_apifloatip_0003__en-us_topic_0201534148_ul17259720457"><li id="eip_apifloatip_0003__en-us_topic_0201534148_li1625982017518">Example request</li></ul>
<pre class="screen" id="eip_apifloatip_0003__en-us_topic_0201534148_screen58682756151934">POST https://{Endpoint}/v2.0/eip/floatingips_v6
{
"floatingip": {
"floating_network_id": "5ce655fa-c911-4d2c-99f7-445bc1162ef8",
"port_id": "552389f5-8f4c-4bb7-9991-07233c315d60"
}
}</pre>
</div>
<div class="section" id="eip_apifloatip_0003__en-us_topic_0201534148_section139091627162419"><h4 class="sectiontitle">Response Message</h4><ul id="eip_apifloatip_0003__en-us_topic_0201534148_ul18258151114611"><li id="eip_apifloatip_0003__en-us_topic_0201534148_li102589111464">Response parameter
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="eip_apifloatip_0003__en-us_topic_0201534148_table191022715241" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response parameter</caption><thead align="left"><tr id="eip_apifloatip_0003__en-us_topic_0201534148_row199117287241"><th align="left" class="cellrowborder" valign="top" width="21.11%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1691162832419">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.89%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p891928172418">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p129117281246">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="eip_apifloatip_0003__en-us_topic_0201534148_row19118289247"><td class="cellrowborder" valign="top" width="21.11%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p149182852411">floatingip</p>
</td>
<td class="cellrowborder" valign="top" width="18.89%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p16918288244"><a href="#eip_apifloatip_0003__en-us_topic_0201534148_table71601678316">floatingip</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p092102892415">Specifies the floating IP address list. For details, see <a href="#eip_apifloatip_0003__en-us_topic_0201534148_table71601678316">Table 4</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="eip_apifloatip_0003__en-us_topic_0201534148_table71601678316"></a><a name="en-us_topic_0201534148_table71601678316"></a><table cellpadding="4" cellspacing="0" summary="" id="eip_apifloatip_0003__en-us_topic_0201534148_table71601678316" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b3514183718483">floatingip</strong> objects</caption><thead align="left"><tr id="eip_apifloatip_0003__en-us_topic_0201534148_row17155271333"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p9993174855413"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b339913394486">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.39193919391939%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p16993194812541"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b17558440144816">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="47.27472747274727%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="eip_apifloatip_0003__en-us_topic_0201534148_p99938485541"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b1959374114815">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="eip_apifloatip_0003__en-us_topic_0201534148_row1715517135"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p109931248105412">status</p>
</td>
<td class="cellrowborder" valign="top" width="19.39193919391939%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p209935484543">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.27472747274727%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1099384811549">Specifies the floating IP address status. The value can be <strong id="eip_apifloatip_0003__en-us_topic_0201534148_b613454355810">ACTIVE</strong>, <strong id="eip_apifloatip_0003__en-us_topic_0201534148_b121361643165817">DOWN</strong>, or <strong id="eip_apifloatip_0003__en-us_topic_0201534148_b9138134310585">ERROR</strong>.</p>
<ul id="eip_apifloatip_0003__en-us_topic_0201534148_ul10994124825413"><li id="eip_apifloatip_0003__en-us_topic_0201534148_li109931648125410"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b116140273491">ACTIVE</strong> indicates that the floating IP address has been bound.</li><li id="eip_apifloatip_0003__en-us_topic_0201534148_li11994154813544"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b196830292497">ERROR</strong> indicates that the floating IP address is abnormal.</li><li id="eip_apifloatip_0003__en-us_topic_0201534148_li109940482541"><strong id="eip_apifloatip_0003__en-us_topic_0201534148_b18992123054911">DOWN</strong> indicates that the floating IP address has not been bound.</li></ul>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row8155177311"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p6994144818541">id</p>
</td>
<td class="cellrowborder" valign="top" width="19.39193919391939%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1399416486549">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.27472747274727%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1899418480541">Specifies the floating IP address ID.</p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row1415647130"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p29942484542">floating_ip_address</p>
</td>
<td class="cellrowborder" valign="top" width="19.39193919391939%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p9994348155412">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.27472747274727%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p8994174818549">Specifies the floating IPv6 address.</p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row1015857132"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p119948483548">floating_network_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.39193919391939%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p89942482546">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.27472747274727%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p59942486544">Specifies the external network ID.</p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row11158171133"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p99954487543">router_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.39193919391939%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1999574817544">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.27472747274727%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1199594812543">Specifies the ID of the belonged router.</p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row12158071318"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p399515488546">port_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.39193919391939%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p499534814543">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.27472747274727%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p16995248135411">Specifies the port ID.</p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row7160207935"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p2099514875417">fixed_ip_address</p>
</td>
<td class="cellrowborder" valign="top" width="19.39193919391939%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p1599514484541">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.27472747274727%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p6995134819542">Specifies the private IP address of the associated port.</p>
</td>
</tr>
<tr id="eip_apifloatip_0003__en-us_topic_0201534148_row141601171432"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p139951748155418">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.39193919391939%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p209957480545">String</p>
</td>
<td class="cellrowborder" valign="top" width="47.27472747274727%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_apifloatip_0003__en-us_topic_0201534148_p13201132212420">Specifies the project ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="eip_apifloatip_0003__en-us_topic_0201534148_ul1284931318611"><li id="eip_apifloatip_0003__en-us_topic_0201534148_li19849141313611">Example response<pre class="screen" id="eip_apifloatip_0003__en-us_topic_0201534148_screen8803122151952">{
"floatingip": {
"router_id": "76c052d6-6a92-444c-b67d-147ee166a480",
"status": "DOWN",
"tenant_id": "6fd9b5fdb997425f97bc5ba1f0846084",
"floating_network_id": "5ce655fa-c911-4d2c-99f7-445bc1162ef8",
"fixed_ip_address": "12.xx.xx.5",
"floating_ip_address": "cdcd:910a:2222:5498:8475:1111:c013:8096",
"port_id": "552389f5-8f4c-4bb7-9991-07233c315d60",
"id": "2567f393-5c76-42db-a397-477723ce41f7"
}
}</pre>
</li></ul>
</div>
<div class="section" id="eip_apifloatip_0003__en-us_topic_0201534148_section31981619"><h4 class="sectiontitle">Status Code</h4><p id="eip_apifloatip_0003__en-us_topic_0201534148_p18112112662914">See <a href="eip_api05_0001.html#eip_api05_0001">Status Codes</a>.</p>
</div>
<div class="section" id="eip_apifloatip_0003__en-us_topic_0201534148_section85821649202813"><h4 class="sectiontitle">Error Code</h4><p id="eip_apifloatip_0003__en-us_topic_0201534148_p7233105282813">See <a href="ErrorCode.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="eip_apifloatip_0000.html">Floating IP Address (IPv6)</a></div>
</div>
</div>