doc-exports/elb/api-ref/elb_zq_hd_0005.html

63 lines
5.2 KiB
HTML

<a name="elb_zq_hd_0005"></a><a name="elb_zq_hd_0005"></a>
<h1 class="topictitle1">Removing a Backend Server</h1>
<h4 class="sectiontitle">Function</h4><p id="elb_zq_hd_0005__en-us_topic_0096561558_en-us_topic_0049139659_p49767403">This API is used to remove a backend server by its ID.</p>
<h4 class="sectiontitle">Constraints</h4><p id="elb_zq_hd_0005__en-us_topic_0096561558_en-us_topic_0049139659_p36177998">After you remove a backend server, new connections to this server will not be established. However, long connections that have been established will be maintained.</p>
<h4 class="sectiontitle">URI</h4><p id="elb_zq_hd_0005__en-us_topic_0096561558_p580951319465">DELETE /v2.0/lbaas/pools/{pool_id}/members/{member_id}</p>
<table cellpadding="4" cellspacing="0" summary="" id="elb_zq_hd_0005__en-us_topic_0096561558_table051172614182" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="elb_zq_hd_0005__en-us_topic_0096561558_row1311718267180"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.3.2.5.1.1"><p id="elb_zq_hd_0005__en-us_topic_0096561558_p611782612183">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.3.2.5.1.2"><p id="elb_zq_hd_0005__en-us_topic_0096561558_p171175268189">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.3.3.2.5.1.3"><p id="elb_zq_hd_0005__en-us_topic_0096561558_p7117192641812">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="54%" id="mcps1.3.3.3.2.5.1.4"><p id="elb_zq_hd_0005__en-us_topic_0096561558_p211762661812">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="elb_zq_hd_0005__en-us_topic_0096561558_row711782621810"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.2.5.1.1 "><p id="elb_zq_hd_0005__en-us_topic_0096561558_p61171126181819">pool_id</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.2.5.1.2 "><p id="elb_zq_hd_0005__en-us_topic_0096561558_p11175262186">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.3.2.5.1.3 "><p id="elb_zq_hd_0005__en-us_topic_0096561558_p3118172691814">String</p>
</td>
<td class="cellrowborder" valign="top" width="54%" headers="mcps1.3.3.3.2.5.1.4 "><p id="elb_zq_hd_0005__en-us_topic_0096561558_p4118132613185">Specifies the ID of the backend server group.</p>
</td>
</tr>
<tr id="elb_zq_hd_0005__en-us_topic_0096561558_row1011872641818"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.2.5.1.1 "><p id="elb_zq_hd_0005__en-us_topic_0096561558_p18118142615182">member_id</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.2.5.1.2 "><p id="elb_zq_hd_0005__en-us_topic_0096561558_p31181926141810">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.3.2.5.1.3 "><p id="elb_zq_hd_0005__en-us_topic_0096561558_p061711023719">String</p>
</td>
<td class="cellrowborder" valign="top" width="54%" headers="mcps1.3.3.3.2.5.1.4 "><p id="elb_zq_hd_0005__en-us_topic_0096561558_p13118142691814">Specifies the backend server ID.</p>
<span class="notetitle"> NOTE: </span><ul id="elb_zq_hd_0005__en-us_topic_0096561558_en-us_topic_0096561557_en-us_topic_0096561555_ul1345681012434"><li id="elb_zq_hd_0005__en-us_topic_0096561558_en-us_topic_0096561557_en-us_topic_0096561555_li14456151018436">The value of this parameter is not the ID of the server but an ID automatically generated for the backend server that has already associated with the load balancer.</li><li id="elb_zq_hd_0005__en-us_topic_0096561558_en-us_topic_0096561557_en-us_topic_0096561555_li44567107434">You can obtain this value by calling the API described in <a href="elb_zq_hd_0002.html#elb_zq_hd_0002">Querying Backend Servers</a>.</li></ul>
</td>
</tr>
</tbody>
</table>
<h4 class="sectiontitle">Request</h4><p id="elb_zq_hd_0005__en-us_topic_0096561558_p22763392113">None</p>
<h4 class="sectiontitle">Response</h4><p id="elb_zq_hd_0005__en-us_topic_0096561558_p7557921498">None</p>
<h4 class="sectiontitle">Example Request</h4><ul id="elb_zq_hd_0005__en-us_topic_0096561558_ul394711264810"><li id="elb_zq_hd_0005__en-us_topic_0096561558_li101387303818">Example request: Removing a backend server<pre class="screen" id="elb_zq_hd_0005__en-us_topic_0096561558_screen913815304818">DELETE https://{Endpoint}/v2.0/lbaas/pools/5a9a3e9e-d1aa-448e-af37-a70171f2a332/members/cf024846-7516-4e3a-b0fb-6590322c836f</pre>
</li></ul>
<h4 class="sectiontitle">Example Response</h4><ul id="elb_zq_hd_0005__en-us_topic_0096561558_ul1561903961915"><li id="elb_zq_hd_0005__en-us_topic_0096561558_li56191439151918">Example response<p id="elb_zq_hd_0005__en-us_topic_0096561558_p3619193991911"><a name="elb_zq_hd_0005__en-us_topic_0096561558_li56191439151918"></a><a name="en-us_topic_0096561558_li56191439151918"></a>None</p>
</li></ul>
<h4 class="sectiontitle">Status Code</h4><p id="elb_zq_hd_0005__en-us_topic_0096561558_en-us_topic_0096561531_en-us_topic_0049139631_p12358762">For details, see <a href="elb_gc_1102.html#elb_gc_1102">Status Codes</a>.</p>
<strong>Parent topic:</strong> <a href="elb_zq_hd_0000.html">Backend Server</a>