doc-exports/docs/vpc/api-ref/vpc_eip_0005.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

63 lines
6.9 KiB
HTML

<a name="vpc_eip_0005"></a><a name="vpc_eip_0005"></a>
<h1 class="topictitle1">Releasing an EIP</h1>
<div id="body58082174"><div class="section" id="vpc_eip_0005__section21768161"><h4 class="sectiontitle">Function</h4><p id="vpc_eip_0005__p7035667">This API is used to release an EIP.</p>
<div class="note" id="vpc_eip_0005__note18686528124513"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><div class="p" id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_p39817577485">Note the following when you use EIPs of the Dedicated Load Balancer (<strong id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_b1958731314398">5_gray</strong>) type:<ul id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_ul18141507494"><li id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_li86521438154">In <strong id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_b126181649151714">eu-de</strong>, EIPs of the Dedicated Load Balancer (<strong id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_b108739322183">5_gray</strong>) type cannot be assigned anymore. You can assign EIPs of the BGP (<strong id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_b1874731121812">5_bgp</strong>) type.</li><li id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_li1194114411236">Existing EIPs of the Dedicated Load Balancer (<strong id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_b113526330389">5_gray</strong>) type can be bound to dedicated or shared load balancers.<ul id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_ul2044703613155"><li id="vpc_eip_0005__en-us_topic_0020090596_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_eip_0005__en-us_topic_0020090596_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_eip_0005__en-us_topic_0020090596_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_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_li1659819163617">You are advised to bind BGP EIPs to or unbind them from dedicated load balancers.</li></ul>
</li><li id="vpc_eip_0005__en-us_topic_0020090596_en-us_topic_0118498850_li1468695512506">Do not add EIPs of the dedicated load balancer type (<strong id="vpc_eip_0005__en-us_topic_0020090596_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>
<div class="section" id="vpc_eip_0005__section61695723"><h4 class="sectiontitle">URI</h4><p id="vpc_eip_0005__p1880364816319">DELETE /v1/{project_id}/publicips/{publicip_id}</p>
<div class="p" id="vpc_eip_0005__p11349430382"><a href="#vpc_eip_0005__table45251091">Table 1</a> describes the parameters.
<div class="tablenoborder"><a name="vpc_eip_0005__table45251091"></a><a name="table45251091"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_eip_0005__table45251091" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="vpc_eip_0005__row25040094"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.2.4.1.1"><p id="vpc_eip_0005__p14981763">Name</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.2.4.1.2"><p id="vpc_eip_0005__p5563313">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.2.4.1.3"><p id="vpc_eip_0005__p47975183">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_eip_0005__row60784581"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.1 "><p id="vpc_eip_0005__p24604028">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.2 "><p id="vpc_eip_0005__p46769243">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.3 "><p id="vpc_eip_0005__p10487112">Specifies the project ID. </p>
</td>
</tr>
<tr id="vpc_eip_0005__row3475817"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.1 "><p id="vpc_eip_0005__p13105749">publicip_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.2 "><p id="vpc_eip_0005__p54932709">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.3 "><p id="vpc_eip_0005__p20364417">Specifies the unique identifier of an EIP.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="vpc_eip_0005__section18390601"><h4 class="sectiontitle">Request Message</h4><ul id="vpc_eip_0005__ul38905106"><li id="vpc_eip_0005__li41882373">Request parameter<p id="vpc_eip_0005__p531806143813"><a name="vpc_eip_0005__li41882373"></a><a name="li41882373"></a>None</p>
</li><li id="vpc_eip_0005__li2173920694527">Example request<pre class="screen" id="vpc_eip_0005__screen11845201552019">DELETE https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}</pre>
</li></ul>
</div>
<div class="section" id="vpc_eip_0005__section31297682"><h4 class="sectiontitle">Response Message</h4><ul id="vpc_eip_0005__ul64826129"><li id="vpc_eip_0005__li02161532143211">Response parameter<p id="vpc_eip_0005__p12220143211323"><a name="vpc_eip_0005__li02161532143211"></a><a name="li02161532143211"></a>None</p>
</li><li id="vpc_eip_0005__li46564252">Example response<p id="vpc_eip_0005__p173930297206"><a name="vpc_eip_0005__li46564252"></a><a name="li46564252"></a>None</p>
<p id="vpc_eip_0005__p439562917205">Or</p>
<pre class="screen" id="vpc_eip_0005__screen1060115315202">{
"code":"xxx",
"message":"xxxxx"
}</pre>
</li></ul>
</div>
<div class="section" id="vpc_eip_0005__section31981619"><h4 class="sectiontitle">Status Code</h4><p id="vpc_eip_0005__p18112112662914">See <a href="vpc_api_0002.html">Status Codes</a>.</p>
</div>
<div class="section" id="vpc_eip_0005__section85821649202813"><h4 class="sectiontitle">Error Code</h4><p id="vpc_eip_0005__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_eip_0000.html">EIP</a></div>
</div>
</div>