doc-exports/docs/css/api-ref/css_03_0086.html
Zheng, Xiu 99a2d77599 css api 23.5.1 20240520
Reviewed-by: Kacur, Michal <michal.kacur@t-systems.com>
Co-authored-by: Zheng, Xiu <zhengxiu@huawei.com>
Co-committed-by: Zheng, Xiu <zhengxiu@huawei.com>
2024-06-07 17:47:08 +00:00

131 lines
9.3 KiB
HTML

<a name="css_03_0086"></a><a name="css_03_0086"></a>
<h1 class="topictitle1">Modifying Cluster Specifications</h1>
<div id="body0000001526348441"><div class="section" id="css_03_0086__section13765154211124"><h4 class="sectiontitle">Function</h4><p id="css_03_0086__p18765134261217">This API is used to modify the specifications of a cluster. Only the specifications of ESS nodes can be modified.</p>
</div>
<div class="section" id="css_03_0086__section1576511422124"><h4 class="sectiontitle">Debugging</h4><p id="css_03_0086__p7766242161218">You can debug this API in . Automatic authentication is supported.</p>
</div>
<div class="section" id="css_03_0086__section1776613425128"><h4 class="sectiontitle">URI</h4><p id="css_03_0086__p5766114281219">POST /v1.0/{project_id}/clusters/{cluster_id}/flavor</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0086__table12768154291213" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameters</caption><thead align="left"><tr id="css_03_0086__row176717425121"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="css_03_0086__p47681142121212">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="css_03_0086__p19769184220128">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="css_03_0086__p1076974220128">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="css_03_0086__p977014214129">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0086__row376744291211"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="css_03_0086__p977084231210">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="css_03_0086__p677114241218">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="css_03_0086__p3771942181218">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="css_03_0086__p1677118425122">Project ID. For details, see <a href="css_03_0071.html">Obtaining a Project ID and Name</a>.</p>
</td>
</tr>
<tr id="css_03_0086__row8767542121218"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="css_03_0086__p177721428126">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="css_03_0086__p207721642181218">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="css_03_0086__p877334218124">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="css_03_0086__p1977315429127">ID of the cluster that you want to modify specifications</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0086__section1177419422122"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0086__request_UpdateFlavorReq" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameter</caption><thead align="left"><tr id="css_03_0086__row777524241210"><th align="left" class="cellrowborder" valign="top" width="19.98%" id="mcps1.3.4.2.2.5.1.1"><p id="css_03_0086__p1877644281211">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.02%" id="mcps1.3.4.2.2.5.1.2"><p id="css_03_0086__p17769426127">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.3"><p id="css_03_0086__p147778428126">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.2.5.1.4"><p id="css_03_0086__p15777174212120">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0086__row14775124217124"><td class="cellrowborder" valign="top" width="19.98%" headers="mcps1.3.4.2.2.5.1.1 "><p id="css_03_0086__p577894215129">needCheckReplica</p>
</td>
<td class="cellrowborder" valign="top" width="20.02%" headers="mcps1.3.4.2.2.5.1.2 "><p id="css_03_0086__p177791742141212">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="css_03_0086__p1780242141216">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="css_03_0086__p8781142171210">Indicates whether to verify replicas. Its value can be <strong id="css_03_0086__b2551939173216">true</strong> or <strong id="css_03_0086__b963224712322">false</strong>. Replica verification is enabled by default.</p>
<ul id="css_03_0086__ul87811142121213"><li id="css_03_0086__li14781942141217"><strong id="css_03_0086__b16746321332">true</strong>: Replica verification is enabled.</li><li id="css_03_0086__li1078218422125"><strong id="css_03_0086__b939814220334">false</strong>: Replica verification is disabled.</li></ul>
</td>
</tr>
<tr id="css_03_0086__row207759426125"><td class="cellrowborder" valign="top" width="19.98%" headers="mcps1.3.4.2.2.5.1.1 "><p id="css_03_0086__p137831042121210">newFlavorId</p>
</td>
<td class="cellrowborder" valign="top" width="20.02%" headers="mcps1.3.4.2.2.5.1.2 "><p id="css_03_0086__p178484281219">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="css_03_0086__p177841742141213">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="css_03_0086__p117861442181210">ID of the new flavor. This parameter is obtained by calling the <a href="ListFlavors.html">Obtaining the Instance Specifications List</a> API. The API compares the values of the <strong id="css_03_0086__b93163354368">name</strong> attribute and obtains the ID of the flavor higher than the current flavor. Only the node specifications of the same Elasticsearch engine version can be changed.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0086__section678810424121"><h4 class="sectiontitle">Response Parameters</h4><p id="css_03_0086__p2788194251214">None</p>
</div>
<div class="section" id="css_03_0086__section5789124211211"><h4 class="sectiontitle">Request Example</h4><ul id="css_03_0086__ul778914423125"><li id="css_03_0086__li9789184221219"><pre class="screen" id="css_03_0086__screen18790942111219">{
"needCheckReplica" : false,
"newFlavorId" : "35b060a4-f152-48ce-8773-36559ceb81f2",
"isAutoPay" : 1
}</pre>
</li><li id="css_03_0086__li12792164221211"><pre class="screen" id="css_03_0086__screen9793114212127">{
"needCheckReplica" : false,
"newFlavorId" : "35b060a4-f152-48ce-8773-36559ceb81f2"
}</pre>
</li></ul>
</div>
<div class="section" id="css_03_0086__section3796642161213"><h4 class="sectiontitle">Response Example</h4><p id="css_03_0086__p20797154271216">None</p>
</div>
<div class="section" id="css_03_0086__section3797144217128"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0086__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="css_03_0086__row157981422127"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="css_03_0086__p147991842181215">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.8.2.1.3.1.2"><p id="css_03_0086__p1980013426123">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0086__row1679864217126"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="css_03_0086__p68001242131216">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="css_03_0086__p20800194217127">The request is processed successfully.</p>
</td>
</tr>
<tr id="css_03_0086__row3798144218128"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="css_03_0086__p38011742161210">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="css_03_0086__p3801164261220">Invalid request.</p>
<p id="css_03_0086__p1880164210122">Modify the request instead of retrying.</p>
</td>
</tr>
<tr id="css_03_0086__row7798164217126"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="css_03_0086__p20802184212127">409</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="css_03_0086__p1180211428126">The request cannot be processed due to a conflict.</p>
<p id="css_03_0086__p280216424122">This status code indicates that the resource that the client attempts to create already exists, or the request fails to be processed because of the update of the conflict request.</p>
</td>
</tr>
<tr id="css_03_0086__row2079814427126"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="css_03_0086__p1180364213122">412</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="css_03_0086__p19803164214121">The server does not meet one of the requirements that the requester puts on the request.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="css_03_0008.html">Cluster Management APIs</a></div>
</div>
</div>