doc-exports/docs/vpc/api-ref/vpc_floatingiP_0004.html
Qin Ying, Fan 310d2d9eb1 VPC API 20230106 version
Reviewed-by: Sarda, Priya <prsarda@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
2024-02-06 08:38:37 +00:00

251 lines
22 KiB
HTML

<a name="vpc_floatingiP_0004"></a><a name="vpc_floatingiP_0004"></a>
<h1 class="topictitle1">Updating a Floating IP Address</h1>
<div id="body1495458211491"><div class="section" id="vpc_floatingiP_0004__section6285365021641"><h4 class="sectiontitle">Function</h4><p id="vpc_floatingiP_0004__p5798086721641">This API is used to update a floating IP address.</p>
<p id="vpc_floatingiP_0004__p18750182092719">During the update, the ID of the floating IP address must be provided in the URL.</p>
<p id="vpc_floatingiP_0004__p11359153817433">If <strong id="vpc_floatingiP_0004__b192191519172815">port_id</strong> is left blank, the floating IP address has been unbound from the port.</p>
<div class="note" id="vpc_floatingiP_0004__note94649525313"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><div class="p" id="vpc_floatingiP_0004__p1546417521313">This API has the following constraints:<ul id="vpc_floatingiP_0004__ul1989710153417"><li id="vpc_floatingiP_0004__li864643510415">If a floating IP address that you are binding is in the <strong id="vpc_floatingiP_0004__b1180313094619">error</strong> state, unbind the IP address first.</li><li id="vpc_floatingiP_0004__li38971515546">Do not associate a port that has a floating IP address associated to another floating IP address. You must first disassociate the port from the IP address and then associate it with another IP address.</li><li id="vpc_floatingiP_0004__li1237720482415">This API cannot be used to bind an EIP to or unbind an EIP from a dedicated load balancer.</li><li id="vpc_floatingiP_0004__li1812193815012">In <strong id="vpc_floatingiP_0004__en-us_topic_0118498850_b126181649151714">eu-de</strong>, EIPs of the Dedicated Load Balancer (<strong id="vpc_floatingiP_0004__en-us_topic_0118498850_b108739322183">5_gray</strong>) type cannot be assigned anymore. You can assign EIPs of the BGP (<strong id="vpc_floatingiP_0004__en-us_topic_0118498850_b1874731121812">5_bgp</strong>) type.</li><li id="vpc_floatingiP_0004__li0286642141814">Existing EIPs of the Dedicated Load Balancer (<strong id="vpc_floatingiP_0004__en-us_topic_0118498850_b113526330389">5_gray</strong>) type can be bound to dedicated or shared load balancers.<ul id="vpc_floatingiP_0004__en-us_topic_0118498850_ul2044703613155"><li id="vpc_floatingiP_0004__en-us_topic_0118498850_li1222113518159">The EIP console cannot be used to bind EIPs to or unbind them from dedicated load balancers.</li><li id="vpc_floatingiP_0004__en-us_topic_0118498850_li1688013347356">You can use APIs to bind EIPs to or unbind them from dedicated load balancers. For details, see <a href="https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/binding_an_eip.html" target="_blank" rel="noopener noreferrer">Binding an EIP</a> and <a href="https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/unbinding_an_eip.html" target="_blank" rel="noopener noreferrer">Unbinding an EIP</a>.</li><li id="vpc_floatingiP_0004__en-us_topic_0118498850_li15559236131711">EIPs of this type can be bound to or unbound from shared load balancers using the EIP console or APIs.</li><li id="vpc_floatingiP_0004__en-us_topic_0118498850_li1659819163617">You are advised to bind BGP EIPs to or unbind them from dedicated load balancers.</li></ul>
</li></ul>
</div>
<ul id="vpc_floatingiP_0004__ul3576654625"><li id="vpc_floatingiP_0004__li6204256227">Do not add EIPs of the dedicated load balancer type (<strong id="vpc_floatingiP_0004__en-us_topic_0118498850_b354915453512">5_gray</strong>) and other types to the same shared bandwidth. Otherwise, the bandwidth limit policy will not take effect.</li></ul>
</div></div>
</div>
<div class="section" id="vpc_floatingiP_0004__section5206576221641"><h4 class="sectiontitle">URI</h4><p id="vpc_floatingiP_0004__p59281032181410">PUT /v2.0/floatingips/{floatingip_id}</p>
<p id="vpc_floatingiP_0004__p17789155311512"><a href="#vpc_floatingiP_0004__table5388109319164">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="vpc_floatingiP_0004__table5388109319164"></a><a name="table5388109319164"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_floatingiP_0004__table5388109319164" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="vpc_floatingiP_0004__row6462628919164"><th align="left" class="cellrowborder" valign="top" width="23.169999999999998%" id="mcps1.3.2.4.2.5.1.1"><p id="vpc_floatingiP_0004__p23806019164"><strong id="vpc_floatingiP_0004__b78917553286">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.66%" id="mcps1.3.2.4.2.5.1.2"><p id="vpc_floatingiP_0004__p868823916540"><strong id="vpc_floatingiP_0004__b119011056102810">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.28%" id="mcps1.3.2.4.2.5.1.3"><p id="vpc_floatingiP_0004__p1928287519164"><strong id="vpc_floatingiP_0004__b180005719282">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.89%" id="mcps1.3.2.4.2.5.1.4"><p id="vpc_floatingiP_0004__p4943306019164"><strong id="vpc_floatingiP_0004__b585785862817">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_floatingiP_0004__row316619519164"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.2.4.2.5.1.1 "><p id="vpc_floatingiP_0004__p115515499553">floatingip_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.3.2.4.2.5.1.2 "><p id="vpc_floatingiP_0004__p0689103915411">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20.28%" headers="mcps1.3.2.4.2.5.1.3 "><p id="vpc_floatingiP_0004__p3677022419164">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.89%" headers="mcps1.3.2.4.2.5.1.4 "><p id="vpc_floatingiP_0004__p2690811319164">Specifies the floating IP address ID.</p>
<p id="vpc_floatingiP_0004__p6641157838">This parameter is not required when you assign a floating IP address. This parameter is mandatory when you query, update, or delete a floating IP address.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="vpc_floatingiP_0004__section2938074421641"><h4 class="sectiontitle">Request Message</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="vpc_floatingiP_0004__table3103003021641" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameter</caption><thead align="left"><tr id="vpc_floatingiP_0004__row5907300221641"><th align="left" class="cellrowborder" valign="top" width="19.59%" id="mcps1.3.3.2.2.5.1.1"><p id="vpc_floatingiP_0004__p2018384621641">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.03%" id="mcps1.3.3.2.2.5.1.2"><p id="vpc_floatingiP_0004__p2427879021641">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.4%" id="mcps1.3.3.2.2.5.1.3"><p id="vpc_floatingiP_0004__p2042494621641">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.98%" id="mcps1.3.3.2.2.5.1.4"><p id="vpc_floatingiP_0004__p4380795521641">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_floatingiP_0004__row5878350521641"><td class="cellrowborder" valign="top" width="19.59%" headers="mcps1.3.3.2.2.5.1.1 "><p id="vpc_floatingiP_0004__p6384347521641">floatingip</p>
</td>
<td class="cellrowborder" valign="top" width="16.03%" headers="mcps1.3.3.2.2.5.1.2 "><p id="vpc_floatingiP_0004__p393901021641"><a href="#vpc_floatingiP_0004__table547993685510">floatingip</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="18.4%" headers="mcps1.3.3.2.2.5.1.3 "><p id="vpc_floatingiP_0004__p5062438921641">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="45.98%" headers="mcps1.3.3.2.2.5.1.4 "><p id="vpc_floatingiP_0004__p557124874610">Specifies the floating IP address list. For details, see <a href="#vpc_floatingiP_0004__table547993685510">Table 3</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="vpc_floatingiP_0004__table547993685510"></a><a name="table547993685510"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_floatingiP_0004__table547993685510" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="vpc_floatingiP_0004__b1265149113414">floatingip</strong> objects</caption><thead align="left"><tr id="vpc_floatingiP_0004__row966719362553"><th align="left" class="cellrowborder" valign="top" width="19.878012198780123%" id="mcps1.3.3.3.2.5.1.1"><p id="vpc_floatingiP_0004__p0685313416"><strong id="vpc_floatingiP_0004__b14322115343414">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.938706129387059%" id="mcps1.3.3.3.2.5.1.2"><p id="vpc_floatingiP_0004__p768561134110"><strong id="vpc_floatingiP_0004__b3756754163410">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.84871512848715%" id="mcps1.3.3.3.2.5.1.3"><p id="vpc_floatingiP_0004__p368681134120"><strong id="vpc_floatingiP_0004__b85211556143419">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="54.334566543345666%" id="mcps1.3.3.3.2.5.1.4"><p id="vpc_floatingiP_0004__p668612124119"><strong id="vpc_floatingiP_0004__b12100759133410">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_floatingiP_0004__row1667163613554"><td class="cellrowborder" valign="top" width="19.878012198780123%" headers="mcps1.3.3.3.2.5.1.1 "><p id="vpc_floatingiP_0004__p1868717104113">port_id</p>
</td>
<td class="cellrowborder" valign="top" width="12.938706129387059%" headers="mcps1.3.3.3.2.5.1.2 "><p id="vpc_floatingiP_0004__p26871119419">No</p>
</td>
<td class="cellrowborder" valign="top" width="12.84871512848715%" headers="mcps1.3.3.3.2.5.1.3 "><p id="vpc_floatingiP_0004__p66889116414">String</p>
</td>
<td class="cellrowborder" valign="top" width="54.334566543345666%" headers="mcps1.3.3.3.2.5.1.4 "><p id="vpc_floatingiP_0004__p14688213413">Specifies the port ID. </p>
<p id="vpc_floatingiP_0004__p15391341153912">Leaving this parameter blank does not unbind the EIP from the dedicated load balancer.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="vpc_floatingiP_0004__section2485220121641"><h4 class="sectiontitle">Response Message</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="vpc_floatingiP_0004__table6687125821641" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response parameter</caption><thead align="left"><tr id="vpc_floatingiP_0004__row2678790321641"><th align="left" class="cellrowborder" valign="top" width="21.349999999999998%" id="mcps1.3.4.2.2.4.1.1"><p id="vpc_floatingiP_0004__p2233651921641">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.11%" id="mcps1.3.4.2.2.4.1.2"><p id="vpc_floatingiP_0004__p6442759121641">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.540000000000006%" id="mcps1.3.4.2.2.4.1.3"><p id="vpc_floatingiP_0004__p5780308921641">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_floatingiP_0004__row5153866721641"><td class="cellrowborder" valign="top" width="21.349999999999998%" headers="mcps1.3.4.2.2.4.1.1 "><p id="vpc_floatingiP_0004__p1388252621641">floatingip</p>
</td>
<td class="cellrowborder" valign="top" width="19.11%" headers="mcps1.3.4.2.2.4.1.2 "><p id="vpc_floatingiP_0004__p5074280121641"><a href="#vpc_floatingiP_0004__table8139247714">floatingip</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="59.540000000000006%" headers="mcps1.3.4.2.2.4.1.3 "><p id="vpc_floatingiP_0004__p6355285621641">Specifies the floating IP address list. For details, see <a href="#vpc_floatingiP_0004__table8139247714">Table 5</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="vpc_floatingiP_0004__table8139247714"></a><a name="table8139247714"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_floatingiP_0004__table8139247714" frame="border" border="1" rules="all"><caption><b>Table 5 </b><strong id="vpc_floatingiP_0004__b35144468386">floatingip</strong> objects</caption><thead align="left"><tr id="vpc_floatingiP_0004__row18132240714"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.3.2.4.1.1"><p id="vpc_floatingiP_0004__p101201250870"><strong id="vpc_floatingiP_0004__b4848194719387">Attribute</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.3.2.4.1.2"><p id="vpc_floatingiP_0004__p161211850674"><strong id="vpc_floatingiP_0004__b5423951113817">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.3.2.4.1.3"><p id="vpc_floatingiP_0004__p41217502719"><strong id="vpc_floatingiP_0004__b047975220387">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_floatingiP_0004__row2014192410713"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p6028218019164">status</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p5101843519164">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p6000412319164">Specifies the floating IP address status. The value can be <strong id="vpc_floatingiP_0004__b347325413814">ACTIVE</strong>, <strong id="vpc_floatingiP_0004__b547445453819">DOWN</strong>, or <strong id="vpc_floatingiP_0004__b19474135473816">ERROR</strong>.</p>
<ul id="vpc_floatingiP_0004__ul10603143175810"><li id="vpc_floatingiP_0004__li19952124945414"><strong id="vpc_floatingiP_0004__b148291056183815">DOWN</strong> indicates that the floating IP address has not been bound.</li><li id="vpc_floatingiP_0004__li13389115319543"><strong id="vpc_floatingiP_0004__b105673119392">ACTIVE</strong> indicates that the floating IP address has been bound.</li><li id="vpc_floatingiP_0004__li13907438154014"><strong id="vpc_floatingiP_0004__b250519383917">ERROR</strong> indicates that the floating IP address is abnormal. </li></ul>
</td>
</tr>
<tr id="vpc_floatingiP_0004__row4141241070"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p5513524919164">id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p212111505713">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p4121850371">Specifies the floating IP address ID.</p>
</td>
</tr>
<tr id="vpc_floatingiP_0004__row614132416712"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p1912112509713">floating_ip_address</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p11211850072">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p16122205017713">Specifies the floating IP address.</p>
</td>
</tr>
<tr id="vpc_floatingiP_0004__row115102414717"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p61223503712">floating_network_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p1812220507714">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p16122550274">Specifies the external network ID.</p>
</td>
</tr>
<tr id="vpc_floatingiP_0004__row19155241277"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p201223504719">router_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p1122155015714">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p812212506713">Specifies the ID of the belonged router.</p>
</td>
</tr>
<tr id="vpc_floatingiP_0004__row101514247714"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p412218502718">port_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p612213506716">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p141228504716">Specifies the port ID.</p>
</td>
</tr>
<tr id="vpc_floatingiP_0004__row3164249715"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p01237508720">fixed_ip_address</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p111239501770">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p1712316501972">Specifies the private IP address of the associated port.</p>
</td>
</tr>
<tr id="vpc_floatingiP_0004__row21662416711"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p812355018717">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p612316509712">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p10487112">Specifies the project ID.</p>
<p id="vpc_floatingiP_0004__p51231950174"></p>
</td>
</tr>
<tr id="vpc_floatingiP_0004__row11176241720"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p11222111885214">dns_name</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p122232018115215">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p18223161825216">Specifies the DNS name.</p>
</td>
</tr>
<tr id="vpc_floatingiP_0004__row17174241670"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.1 "><p id="vpc_floatingiP_0004__p492133065713">dns_domain</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.2 "><p id="vpc_floatingiP_0004__p16929300573">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.3.2.4.1.3 "><p id="vpc_floatingiP_0004__p3921230175711">Specifies the DNS domain.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="vpc_floatingiP_0004__section144217617428"><h4 class="sectiontitle">Example Request</h4><ul id="vpc_floatingiP_0004__ul1044220674215"><li id="vpc_floatingiP_0004__li4442186174217">Unbind a floating IP address from a port.<pre class="screen" id="vpc_floatingiP_0004__screen10945157105214">PUT https://{Endpoint}/v2.0/floatingips/b997e0d4-3359-4c74-8f88-bc0af81cd5a2
{
"floatingip": {
"port_id": null
}
}</pre>
</li><li id="vpc_floatingiP_0004__li344313617428">Bind a floating IP address to a port. The port ID is f91f5763-c5a2-4458-979d-61e48b3c3fac.<pre class="screen" id="vpc_floatingiP_0004__screen549313186520">PUT https://{Endpoint}/v2.0/floatingips/b997e0d4-3359-4c74-8f88-bc0af81cd5a2
{
"floatingip": {
"port_id": "f91f5763-c5a2-4458-979d-61e48b3c3fac"
}
}</pre>
</li></ul>
</div>
<div class="section" id="vpc_floatingiP_0004__section1944456164211"><h4 class="sectiontitle">Example Response</h4><p id="vpc_floatingiP_0004__p344417616421"><strong id="vpc_floatingiP_0004__b541464122215">Status code: 200</strong></p>
<p id="vpc_floatingiP_0004__p8867154615116">(The floating IP address is unbound from the port.)</p>
<pre class="screen" id="vpc_floatingiP_0004__screen207941120175116">{
"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,
"dns_name": "ecs-80-158-78-239",
"dns_domain": "reverse.<em id="vpc_floatingiP_0004__i079522018510">domain-name</em>.com"
}
}</pre>
<p id="vpc_floatingiP_0004__p14778819145112">(The floating IP address is bound to the port.)</p>
<pre class="screen" id="vpc_floatingiP_0004__screen177773514493">{
"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": "192.168.10.3",
"floating_ip_address": "88.88.215.205",
"port_id": "f91f5763-c5a2-4458-979d-61e48b3c3fac",
"dns_name": "ecs-80-158-78-239",
"dns_domain": "reverse.<em id="vpc_floatingiP_0004__i107789352499">domain-name</em>.com"
}
}</pre>
</div>
<div class="section" id="vpc_floatingiP_0004__section10470352390"><h4 class="sectiontitle">Status Code</h4><p id="vpc_floatingiP_0004__p18112112662914">See <a href="vpc_api_0002.html">Status Codes</a>.</p>
</div>
<div class="section" id="vpc_floatingiP_0004__section85821649202813"><h4 class="sectiontitle">Error Code</h4><p id="vpc_floatingiP_0004__p7233105282813">See <a href="vpc_api_0003.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="vpc_floatingiP_0000.html">Floating IP Address</a></div>
</div>
</div>