Files
doc-exports/docs/eip/api-ref/eip_openstackapi_0010.html
fanqinying 406cbf6c6f EIP API 20251024 version
Reviewed-by: Hajba, László Antal <laszlo-antal.hajba@t-systems.com>
Co-authored-by: fanqinying <fanqinying@huawei.com>
Co-committed-by: fanqinying <fanqinying@huawei.com>
2026-04-13 19:54:24 +00:00

56 lines
7.9 KiB
HTML

<a name="eip_openstackapi_0010"></a><a name="eip_openstackapi_0010"></a>
<h1 class="topictitle1">Deleting a Floating IP Address</h1>
<div id="body8662426"><div class="section" id="eip_openstackapi_0010__en-us_topic_0201534157_section1285101621658"><h4 class="sectiontitle">Function</h4><p id="eip_openstackapi_0010__en-us_topic_0201534157_p3429940121658">This API is used to delete a floating IP address.</p>
<div class="note" id="eip_openstackapi_0010__en-us_topic_0201534157_note13848133064014"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><div class="p" id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_p39817577485">Note the following when you use EIPs of the Dedicated Load Balancer (<strong id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_b207851911124910">5_gray</strong>) type:<ul id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_ul18141507494"><li id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_li86521438154">In <strong id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_b143161918816">eu-de</strong>, EIPs of the Dedicated Load Balancer (<strong id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_b193114191781">5_gray</strong>) type cannot be assigned anymore. You can assign EIPs of the BGP (<strong id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_b12311419682">5_bgp</strong>) type.</li><li id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_li1194114411236">Existing EIPs of the Dedicated Load Balancer (<strong id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_b1093341819529">5_gray</strong>) type can be bound to dedicated or shared load balancers.<ul id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_ul2044703613155"><li id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_li1222113518159">The EIP console cannot be used to bind EIPs to or unbind them from dedicated load balancers.</li><li id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_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="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_li15559236131711">EIPs of this type can be bound to or unbound from shared load balancers using the EIP console or APIs.</li><li id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_li1659819163617">You are advised to bind or unbind BGP EIPs to or from dedicated load balancers.</li></ul>
</li><li id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_li1468695512506">Do not add EIPs of the dedicated load balancer type (<strong id="eip_openstackapi_0010__en-us_topic_0201534157_en-us_topic_0201534068_b153172301617">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>
<div class="section" id="eip_openstackapi_0010__en-us_topic_0201534157_section4025916121658"><h4 class="sectiontitle">URI</h4><p id="eip_openstackapi_0010__en-us_topic_0201534157_p16207163114173">DELETE /v2.0/floatingips/{floatingip_id}</p>
<p id="eip_openstackapi_0010__en-us_topic_0201534157_p17789155311512"><a href="#eip_openstackapi_0010__en-us_topic_0201534157_table49321613135118">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="eip_openstackapi_0010__en-us_topic_0201534157_table49321613135118"></a><a name="en-us_topic_0201534157_table49321613135118"></a><table cellpadding="4" cellspacing="0" summary="" id="eip_openstackapi_0010__en-us_topic_0201534157_table49321613135118" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="eip_openstackapi_0010__en-us_topic_0201534157_row89331813135112"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.4.2.5.1.1"><p id="eip_openstackapi_0010__en-us_topic_0201534157_p116676362558"><strong id="eip_openstackapi_0010__en-us_topic_0201534157_b17651848105713">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.4.2.5.1.2"><p id="eip_openstackapi_0010__en-us_topic_0201534157_p16671836175513"><strong id="eip_openstackapi_0010__en-us_topic_0201534157_b3655164915717">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.4.2.5.1.3"><p id="eip_openstackapi_0010__en-us_topic_0201534157_p1766716366555"><strong id="eip_openstackapi_0010__en-us_topic_0201534157_b1980395018576">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.4.2.5.1.4"><p id="eip_openstackapi_0010__en-us_topic_0201534157_p116679360559"><strong id="eip_openstackapi_0010__en-us_topic_0201534157_b138701551205713">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="eip_openstackapi_0010__en-us_topic_0201534157_row4934113125120"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.4.2.5.1.1 "><p id="eip_openstackapi_0010__en-us_topic_0201534157_p1036313125105">floatingip_id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.4.2.5.1.2 "><p id="eip_openstackapi_0010__en-us_topic_0201534157_p11667113619558">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.4.2.5.1.3 "><p id="eip_openstackapi_0010__en-us_topic_0201534157_p26672036175513">String</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.4.2.5.1.4 "><p id="eip_openstackapi_0010__en-us_topic_0201534157_p566713367557">Specifies the floating IP address ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="eip_openstackapi_0010__en-us_topic_0201534157_section5856898621658"><h4 class="sectiontitle">Request Parameters</h4><p id="eip_openstackapi_0010__en-us_topic_0201534157_p6829125875110">None</p>
</div>
<div class="section" id="eip_openstackapi_0010__en-us_topic_0201534157_section1555365521658"><h4 class="sectiontitle">Response Parameters</h4><p id="eip_openstackapi_0010__en-us_topic_0201534157_p5188657721658">None</p>
</div>
<div class="section" id="eip_openstackapi_0010__en-us_topic_0201534157_section1480217694210"><h4 class="sectiontitle">Example Request</h4><p id="eip_openstackapi_0010__en-us_topic_0201534157_p1580210619429">Delete the floating IP address with the ID of a95ec431-8473-463b-aede-34fb048ee3a7.</p>
<pre class="screen" id="eip_openstackapi_0010__en-us_topic_0201534157_screen1280214644215">DELETE https://{Endpoint}/v2.0/floatingips/a95ec431-8473-463b-aede-34fb048ee3a7</pre>
</div>
<div class="section" id="eip_openstackapi_0010__en-us_topic_0201534157_section1080246184215"><h4 class="sectiontitle">Example Response</h4><p id="eip_openstackapi_0010__en-us_topic_0201534157_p98022604215">None</p>
</div>
<div class="section" id="eip_openstackapi_0010__en-us_topic_0201534157_section10470352390"><h4 class="sectiontitle">Status Code</h4><p id="eip_openstackapi_0010__en-us_topic_0201534157_p18112112662914">See <a href="eip_api05_0001.html#eip_api05_0001">Status Codes</a>.</p>
</div>
<div class="section" id="eip_openstackapi_0010__en-us_topic_0201534157_section85821649202813"><h4 class="sectiontitle">Error Code</h4><p id="eip_openstackapi_0010__en-us_topic_0201534157_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_openstackapi_0005.html">Floating IP Address</a></div>
</div>
</div>