doc-exports/docs/css/api-ref/css_03_0127.html
Wuwan, Qi 8675132585 CSS API 23.2.1 20230926
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Wuwan, Qi <wuwanqi1@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-committed-by: Wuwan, Qi <wuwanqi1@noreply.gitea.eco.tsi-dev.otc-service.com>
2023-10-23 09:34:01 +00:00

157 lines
10 KiB
HTML

<a name="css_03_0127"></a><a name="css_03_0127"></a>
<h1 class="topictitle1">Enabling or Disabling the ES Load Balancer</h1>
<div id="body0000001667597892"><div class="section" id="css_03_0127__section16973132275"><h4 class="sectiontitle">Function</h4><p id="css_03_0127__p129734324716">This API is used to enable or disable the Elasticsearch load balancer.</p>
</div>
<div class="section" id="css_03_0127__atuogenerate_2"><h4 class="sectiontitle">URI</h4><p id="css_03_0127__p199741321277">POST /v1.0/{project_id}/clusters/{cluster_id}/loadbalancers/es-switch</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0127__table29765321472" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="css_03_0127__row1797519320715"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="css_03_0127__p159765326719">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="css_03_0127__p59761832175">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="css_03_0127__p2976332875">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="css_03_0127__p7977532774">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0127__row1697510321076"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0127__p597716321671">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0127__p597718322715">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0127__p1297720321573">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0127__p1197853212718">Project ID. For details about how to obtain the project ID and name, see <a href="css_03_0071.html">Obtaining the Project ID and Name</a>.</p>
</td>
</tr>
<tr id="css_03_0127__row597516321879"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0127__p119782327710">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0127__p179784328720">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0127__p69798321712">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0127__p1979432371">ID of the cluster to be modified</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0127__section109792321379"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0127__request_UpdateEsElbRequestBody" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameters</caption><thead align="left"><tr id="css_03_0127__row149806321171"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="css_03_0127__p398113328715">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="css_03_0127__p0981183212719">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="css_03_0127__p179811732471">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="css_03_0127__p1298215327719">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0127__row12980143213717"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="css_03_0127__p1098213321171">enable</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="css_03_0127__p998253217713">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="css_03_0127__p69821132576">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="css_03_0127__p18982163210712">Enable or disable the ES load balancer.</p>
<ul id="css_03_0127__ul1598310321578"><li id="css_03_0127__li1298311328712"><strong id="css_03_0127__b1983153219713">true</strong>: enable the ES load balancer.</li><li id="css_03_0127__li498363212716"><strong id="css_03_0127__b189831532079">false</strong>: disable the ES load balancer.</li></ul>
</td>
</tr>
<tr id="css_03_0127__row698012327714"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="css_03_0127__p20983632876">agency</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="css_03_0127__p1298417321671">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="css_03_0127__p1298418328710">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="css_03_0127__p998416326715">Agency name</p>
</td>
</tr>
<tr id="css_03_0127__row4980203211718"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="css_03_0127__p1398553210712">elb_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="css_03_0127__p598543218719">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="css_03_0127__p159858321577">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="css_03_0127__p18985153211718">Load balancer ID</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0127__section698513219715"><h4 class="sectiontitle">Response Parameters</h4><p id="css_03_0127__p199861321673"><strong id="css_03_0127__b129861432277">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0127__response_UpdateEsElbResponseBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response body parameters</caption><thead align="left"><tr id="css_03_0127__row129861832478"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.4.1.1"><p id="css_03_0127__p49871232175">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.4.1.2"><p id="css_03_0127__p398714328712">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.3.2.4.1.3"><p id="css_03_0127__p29882328720">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0127__row1798693216712"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.1 "><p id="css_03_0127__p1498819328719">elb_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.4.1.2 "><p id="css_03_0127__p1898813216717">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.3.2.4.1.3 "><p id="css_03_0127__p129899323712">Load balancer ID</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0127__section11989432072"><h4 class="sectiontitle">Example Requests</h4><p id="css_03_0127__p498943218717">Enable the load balancer.</p>
<pre class="screen" id="css_03_0127__screen149892327712">POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/58ee0f27-70b3-47e0-ac72-9e3df6cd15cd/loadbalancers/es-switch
{
"enable" : true,
"elb_id" : "5d45faad-6cb3-479b-96b8-3e2de0cc6268",
"agency" : "css_elb_agency"
}</pre>
</div>
<div class="section" id="css_03_0127__section16990153213716"><h4 class="sectiontitle">Example Responses</h4><p id="css_03_0127__p1991232077">None</p>
</div>
<div class="section" id="css_03_0127__section1999111327720"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0127__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="css_03_0127__row1799114321774"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="css_03_0127__p999214321579">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="css_03_0127__p199223216711">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0127__row129923326716"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0127__p4993103211712">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0127__p2099373210719">Request succeeded.</p>
</td>
</tr>
<tr id="css_03_0127__row399212325719"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0127__p9993732876">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0127__p1699316321279">Invalid request.</p>
<p id="css_03_0127__p39931432276">Modify the request instead of retrying.</p>
</td>
</tr>
<tr id="css_03_0127__row12992632578"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0127__p199419326713">409</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0127__p15994732673">The request cannot be processed due to a conflict.</p>
<p id="css_03_0127__p1599410321679">This status code indicates that the resource that the client attempts to create already exits, or the requested update failed due to a conflict.</p>
</td>
</tr>
<tr id="css_03_0127__row4992032173"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0127__p699415321177">412</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0127__p6994432772">The server does not meet one of the requirements that the requester puts on the request.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0127__section499403215713"><h4 class="sectiontitle">Error Codes</h4><p id="css_03_0127__p299517329716">See <a href="css_03_0076.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="css_03_0125.html">Load Balancing</a></div>
</div>
</div>