doc-exports/docs/as/api-ref/as_06_0302.html
guoyanyan 31704f0318 as_api_0325
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: guoyanyan <guoyanyan3@huawei.com>
Co-committed-by: guoyanyan <guoyanyan3@huawei.com>
2023-04-13 08:59:32 +00:00

154 lines
12 KiB
HTML

<a name="as_06_0302"></a><a name="as_06_0302"></a>
<h1 class="topictitle1">Removing an Instance from an AS Group</h1>
<div id="body29752153"><div class="section" id="as_06_0302__section59572368"><h4 class="sectiontitle">Function</h4><p id="as_06_0302__p61114224">This interface is used to remove a specified instance from an AS group.</p>
<ul id="as_06_0302__ul182731193615"><li id="as_06_0302__li7273691767">You can remove instances only in <strong id="as_06_0302__b8423527069636">INSERVICE</strong> state and only when the number of instances after the removal is greater than or equal to the minimum number of instances allowed.</li></ul>
</div>
<ul id="as_06_0302__ul5933151113615"><li id="as_06_0302__li39333111262">You can remove instances from an AS group only when no scaling action is in progress.</li></ul>
<div class="section" id="as_06_0302__section66389266"><h4 class="sectiontitle">URI</h4><p id="as_06_0302__p21762200">DELETE /autoscaling-api/v1/{project_id}/scaling_group_instance/{instance_id}</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="as_06_0302__table17907785" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="as_06_0302__row64797609"><th align="left" class="cellrowborder" valign="top" width="21%" id="mcps1.3.3.3.2.5.1.1"><p id="as_06_0302__p14114947"><strong id="as_06_0302__b161962195212">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19%" id="mcps1.3.3.3.2.5.1.2"><p id="as_06_0302__p2460041">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.3.2.5.1.3"><p id="as_06_0302__p65045669">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="47%" id="mcps1.3.3.3.2.5.1.4"><p id="as_06_0302__p34207804"><strong id="as_06_0302__b93712365216">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="as_06_0302__row19368760"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.3.3.2.5.1.1 "><p id="as_06_0302__p25365761">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.3.2.5.1.2 "><p id="as_06_0302__p41360766">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.2.5.1.3 "><p id="as_06_0302__p61887768">String</p>
</td>
<td class="cellrowborder" valign="top" width="47%" headers="mcps1.3.3.3.2.5.1.4 "><p id="as_06_0302__p36520930">Specifies the project ID.</p>
</td>
</tr>
<tr id="as_06_0302__row19026538"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.3.3.2.5.1.1 "><p id="as_06_0302__p64754634">instance_id</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.3.2.5.1.2 "><p id="as_06_0302__p10634019">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.2.5.1.3 "><p id="as_06_0302__p56049180">String</p>
</td>
<td class="cellrowborder" valign="top" width="47%" headers="mcps1.3.3.3.2.5.1.4 "><p id="as_06_0302__p43689693">Specifies the instance ID. For details, see <a href="as_06_0301.html">Querying Instances in an AS Group</a>.</p>
</td>
</tr>
<tr id="as_06_0302__row57662920"><td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.3.3.2.5.1.1 "><p id="as_06_0302__p40184969">instance_delete</p>
</td>
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.3.2.5.1.2 "><p id="as_06_0302__p33757095">No</p>
</td>
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.2.5.1.3 "><p id="as_06_0302__p49970185">String</p>
</td>
<td class="cellrowborder" valign="top" width="47%" headers="mcps1.3.3.3.2.5.1.4 "><p id="as_06_0302__p18389193518112">Specifies whether an instance is deleted when it is removed from the AS group.</p>
<p id="as_06_0302__p11671043414">Options:</p>
<ul id="as_06_0302__ul1072017441112"><li id="as_06_0302__li14684528214"><strong id="as_06_0302__b18912471083">no</strong> (default): The instance will not be deleted.</li><li id="as_06_0302__li19720844813"><strong id="as_06_0302__b15582714914">yes</strong>: The instance will be deleted.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="as_06_0302__section60632485"><h4 class="sectiontitle">Request Message</h4><ul id="as_06_0302__ul9007507"><li id="as_06_0302__li56913160">Request parameters<p id="as_06_0302__p60400126203515"><a name="as_06_0302__li56913160"></a><a name="li56913160"></a>None</p>
</li><li id="as_06_0302__li3640858994017">Example request<p id="as_06_0302__p15614505203519"><a name="as_06_0302__li3640858994017"></a><a name="li3640858994017"></a>This example shows how to remove but not delete the instance with ID <strong id="as_06_0302__b1140147101018">b25c1589-c96c-465b-9fef-d06540d1945c</strong> from an AS group.</p>
<pre class="screen" id="as_06_0302__screen8835131417279">DELETE https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/b25c1589-c96c-465b-9fef-d06540d1945c?instance_delete=no</pre>
</li></ul>
</div>
<div class="section" id="as_06_0302__section8821459"><h4 class="sectiontitle">Response Message</h4><ul id="as_06_0302__ul257214285370"><li id="as_06_0302__li457252823715">Response parameters<p id="as_06_0302__p85747280378"><a name="as_06_0302__li457252823715"></a><a name="li457252823715"></a>None</p>
</li><li id="as_06_0302__li125761428143711">Example response<p id="as_06_0302__p75781528113713"><a name="as_06_0302__li125761428143711"></a><a name="li125761428143711"></a>None</p>
</li></ul>
</div>
<div class="section" id="as_06_0302__section12284267"><h4 class="sectiontitle">Returned Values</h4><ul id="as_06_0302__ul33464950"><li id="as_06_0302__li32749101">Normal<p id="as_06_0302__p26306458"><a name="as_06_0302__li32749101"></a><a name="li32749101"></a>204</p>
</li><li id="as_06_0302__li35431534">Abnormal
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="as_06_0302__table50448354" frame="border" border="1" rules="all"><thead align="left"><tr id="as_06_0302__row29530116"><th align="left" class="cellrowborder" valign="top" width="43.99%" id="mcps1.3.6.2.2.1.1.3.1.1"><p id="as_06_0302__p43129175">Returned Value</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.010000000000005%" id="mcps1.3.6.2.2.1.1.3.1.2"><p id="as_06_0302__p3802258">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="as_06_0302__row39547486"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p49229794">400 Bad Request</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p28190407">The server failed to process the request.</p>
</td>
</tr>
<tr id="as_06_0302__row52387077"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p15494878">401 Unauthorized</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p47125611">You must enter the username and password to access the requested page.</p>
</td>
</tr>
<tr id="as_06_0302__row21477321"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p61941440">403 Forbidden</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p51200735">You are forbidden to access the requested page.</p>
</td>
</tr>
<tr id="as_06_0302__row58153438"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p12808013">404 Not Found</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p30816121">The server could not find the requested page.</p>
</td>
</tr>
<tr id="as_06_0302__row8909633"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p50591634">405 Method Not Allowed</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p4281684">You are not allowed to use the method specified in the request.</p>
</td>
</tr>
<tr id="as_06_0302__row38535158"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p34340132">406 Not Acceptable</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p30087318">The response generated by the server could not be accepted by the client.</p>
</td>
</tr>
<tr id="as_06_0302__row2350413"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p56165728">407 Proxy Authentication Required</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p53130157">You must use the proxy server for authentication to process the request.</p>
</td>
</tr>
<tr id="as_06_0302__row8409368"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p10070188">408 Request Timeout</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p10378893">The request timed out.</p>
</td>
</tr>
<tr id="as_06_0302__row26301173"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p50020275">409 Conflict</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p25110514">The request could not be processed due to a conflict.</p>
</td>
</tr>
<tr id="as_06_0302__row24668042"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p51954348">500 Internal Server Error</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p47552675">Failed to complete the request because of an internal service error.</p>
</td>
</tr>
<tr id="as_06_0302__row25320898"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p37726867">501 Not Implemented</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p35977388">Failed to complete the request because the server does not support the requested function.</p>
</td>
</tr>
<tr id="as_06_0302__row55361044"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p55059565">502 Bad Gateway</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p30639779">Failed to complete the request because the request is invalid.</p>
</td>
</tr>
<tr id="as_06_0302__row7322556"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p56256135">503 Service Unavailable</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p60453091">Failed to complete the request because the system is unavailable.</p>
</td>
</tr>
<tr id="as_06_0302__row7206911"><td class="cellrowborder" valign="top" width="43.99%" headers="mcps1.3.6.2.2.1.1.3.1.1 "><p id="as_06_0302__p46888886">504 Gateway Timeout</p>
</td>
<td class="cellrowborder" valign="top" width="56.010000000000005%" headers="mcps1.3.6.2.2.1.1.3.1.2 "><p id="as_06_0302__p39903442">A gateway timeout error occurred.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="as_06_0302__section17669131616110"><h4 class="sectiontitle">Error Codes</h4><p id="as_06_0302__p172692548116">See <a href="as_07_0102.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="as_06_0300.html">Instances</a></div>
</div>
</div>