Files
doc-exports/docs/elb/api-ref/DeleteLoadBalancerForce.html
zhoumeng 275abe4f14 ELB_API_0916
Reviewed-by: Hajba, László Antal <laszlo-antal.hajba@t-systems.com>
Co-authored-by: zhoumeng <zhoumeng35@huawei.com>
Co-committed-by: zhoumeng <zhoumeng35@huawei.com>
2025-11-11 19:40:15 +00:00

113 lines
9.8 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="DeleteLoadBalancerForce"></a><a name="DeleteLoadBalancerForce"></a>
<h1 class="topictitle1">Deleting a Load Balancer and Its Associated Resources</h1>
<div id="body1708331107508"><div class="section" id="DeleteLoadBalancerForce__section1151053113711"><h4 class="sectiontitle">Function</h4><p id="DeleteLoadBalancerForce__p1765539376">This API is used to delete a load balancer and its associated resources, including the listeners, backend server groups, and backend servers.</p>
<p id="DeleteLoadBalancerForce__p106175315378">Note:</p>
<ul id="DeleteLoadBalancerForce__ul186125311371"><li id="DeleteLoadBalancerForce__li3605312376"><p id="DeleteLoadBalancerForce__p206105316376"><a name="DeleteLoadBalancerForce__li3605312376"></a><a name="li3605312376"></a>If a load balancer has EIPs bound to it, the EIPs will be unbound from the load balancer.</p>
</li><li id="DeleteLoadBalancerForce__li461153203711"><p id="DeleteLoadBalancerForce__p136553133712"><a name="DeleteLoadBalancerForce__li461153203711"></a><a name="li461153203711"></a>If Deletion protection feature is enabled for ELB, it wont be possible to delete the ELB and its resources.</p>
</li><li id="DeleteLoadBalancerForce__li1874538371"><p id="DeleteLoadBalancerForce__p1475536379"><a name="DeleteLoadBalancerForce__li1874538371"></a><a name="li1874538371"></a>If Removal protection feature is enabled for a Backend Server Group used by the ELB, it wont be possible to delete the ELB and its resources.</p>
</li><li id="DeleteLoadBalancerForce__li191595353711"><p id="DeleteLoadBalancerForce__p215053183714"><a name="DeleteLoadBalancerForce__li191595353711"></a><a name="li191595353711"></a>If only Modification protection feature is enabled it wont protect it from force-deletion.</p>
</li></ul>
</div>
<div class="section" id="DeleteLoadBalancerForce__section8151953163712"><h4 class="sectiontitle">URI</h4><p id="DeleteLoadBalancerForce__p111518538371">DELETE /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/force-elb</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="DeleteLoadBalancerForce__table131765319378" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="DeleteLoadBalancerForce__row151615539378"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="DeleteLoadBalancerForce__p151713535373">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="DeleteLoadBalancerForce__p31713531374">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="DeleteLoadBalancerForce__p417253193716">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="DeleteLoadBalancerForce__p2017205383718">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="DeleteLoadBalancerForce__row181685311378"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="DeleteLoadBalancerForce__p21835353718">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="DeleteLoadBalancerForce__p141810538379">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="DeleteLoadBalancerForce__p918105319375">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="DeleteLoadBalancerForce__p8430151175413"><strong id="DeleteLoadBalancerForce__b6189535376">Definition</strong>: Specifies the project ID.</p>
<p id="DeleteLoadBalancerForce__p101825373718"><strong id="DeleteLoadBalancerForce__b18181853173715">Constraints</strong>: N/A</p>
<p id="DeleteLoadBalancerForce__p718153153713"><strong id="DeleteLoadBalancerForce__b181812538377">Range</strong>: The value can contain a maximum of 32 characters, including digits and lowercase letters.</p>
<p id="DeleteLoadBalancerForce__p1118105373718"><strong id="DeleteLoadBalancerForce__b1919115313713">Default value</strong>: N/A</p>
</td>
</tr>
<tr id="DeleteLoadBalancerForce__row0161253103713"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="DeleteLoadBalancerForce__p219155313376">loadbalancer_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="DeleteLoadBalancerForce__p6199533370">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="DeleteLoadBalancerForce__p1219175312378">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="DeleteLoadBalancerForce__p131915383711"><strong id="DeleteLoadBalancerForce__b919205317377">Definition</strong>: Specifies the load balancer ID.</p>
<p id="DeleteLoadBalancerForce__p18197534372"><strong id="DeleteLoadBalancerForce__b13192053153716">Constraints</strong>: N/A</p>
<p id="DeleteLoadBalancerForce__p1195531379"><strong id="DeleteLoadBalancerForce__b019353163713">Range</strong>: N/A</p>
<p id="DeleteLoadBalancerForce__p7201653103717"><strong id="DeleteLoadBalancerForce__b1220105311371">Default value</strong>: N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="DeleteLoadBalancerForce__section112015533377"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="DeleteLoadBalancerForce__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="DeleteLoadBalancerForce__row820653173711"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="DeleteLoadBalancerForce__p1211053183715">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="DeleteLoadBalancerForce__p5211533371">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="DeleteLoadBalancerForce__p221155316372">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="DeleteLoadBalancerForce__p16211953153718">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="DeleteLoadBalancerForce__row18202053143714"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="DeleteLoadBalancerForce__p16221153113717">X-Auth-Token</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="DeleteLoadBalancerForce__p822653143716">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="DeleteLoadBalancerForce__p17227535379">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="DeleteLoadBalancerForce__p322453173716"><strong id="DeleteLoadBalancerForce__b3221853133710">Definition</strong>: Specifies the token used for IAM authentication.</p>
<p id="DeleteLoadBalancerForce__p72217537375"><strong id="DeleteLoadBalancerForce__b82225313371">Constraints</strong>: N/A</p>
<p id="DeleteLoadBalancerForce__p152235313718"><strong id="DeleteLoadBalancerForce__b2225534377">Range</strong>: N/A</p>
<p id="DeleteLoadBalancerForce__p122105317374"><strong id="DeleteLoadBalancerForce__b6221253123715">Default value</strong>: N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="DeleteLoadBalancerForce__section523155323714"><h4 class="sectiontitle">Response Parameters</h4><p id="DeleteLoadBalancerForce__p32318538376"><strong id="DeleteLoadBalancerForce__b6231353133719">Status code: 204</strong></p>
<p id="DeleteLoadBalancerForce__p1923953123716">Successful request.</p>
<p id="DeleteLoadBalancerForce__p1323115313373">None</p>
</div>
<div class="section" id="DeleteLoadBalancerForce__section1023353193719"><h4 class="sectiontitle">Example Requests</h4><p id="DeleteLoadBalancerForce__p1823135315379">Deleting a load balancer and resources associated with it</p>
<pre class="screen" id="DeleteLoadBalancerForce__screen6231153103711">DELETE https://{ELB_Endpoint}/v3/060576782980d5762f9ec014dd2f1148/elb/loadbalancers/32c1057f-74a1-42d6-9b20-d55b80ab89c4/force-elb</pre>
</div>
<div class="section" id="DeleteLoadBalancerForce__section724853193712"><h4 class="sectiontitle">Example Responses</h4><p id="DeleteLoadBalancerForce__p724185315378">None</p>
</div>
<div class="section" id="DeleteLoadBalancerForce__section4241453183720"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="DeleteLoadBalancerForce__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="DeleteLoadBalancerForce__row142425310378"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="DeleteLoadBalancerForce__p12252531378">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="DeleteLoadBalancerForce__p6251553163717">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="DeleteLoadBalancerForce__row224175314379"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="DeleteLoadBalancerForce__p1725155317377">204</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="DeleteLoadBalancerForce__p142514530375">Successful request.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="DeleteLoadBalancerForce__section152515313715"><h4 class="sectiontitle">Error Codes</h4><p id="DeleteLoadBalancerForce__p8251053153714">See <a href="ErrorCode.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="module_loadbalancers.html">Load Balancer</a></div>
</div>
</div>