doc-exports/docs/css/api-ref/css_03_0086.html
Zheng, Xiu bf0cbd66f9 CSS API 22.4.1 Version
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>
2023-04-12 00:11:02 +00:00

123 lines
8.8 KiB
HTML

<a name="css_03_0086"></a><a name="css_03_0086"></a>
<h1 class="topictitle1">Changing Specifications</h1>
<div id="body0000001526348441"><div class="section" id="css_03_0086__section18274144022312"><h4 class="sectiontitle">Function</h4><p id="css_03_0086__p1927454013238">This API is used to modify the specifications of a cluster. Only the nodes of the ESS type can be modified.</p>
</div>
<div class="section" id="css_03_0086__section327684002315"><h4 class="sectiontitle">URI</h4><p id="css_03_0086__p2027614062317">POST /v1.0/{project_id}/clusters/{cluster_id}/flavor</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0086__table1328484011232" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="css_03_0086__row20283124072317"><th align="left" class="cellrowborder" valign="top" width="15.45%" id="mcps1.3.2.3.2.5.1.1"><p id="css_03_0086__p15284104013232">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.73%" id="mcps1.3.2.3.2.5.1.2"><p id="css_03_0086__p162841408235">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.380000000000003%" id="mcps1.3.2.3.2.5.1.3"><p id="css_03_0086__p122855409232">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.44%" id="mcps1.3.2.3.2.5.1.4"><p id="css_03_0086__p728554015234">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0086__row3283114032311"><td class="cellrowborder" valign="top" width="15.45%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0086__p18285124082314">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.73%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0086__p16286540192316">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="17.380000000000003%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0086__p1628684082318">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.44%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0086__p1628718402230">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__row1283240132314"><td class="cellrowborder" valign="top" width="15.45%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0086__p6287154015236">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="15.73%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0086__p15288184017231">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="17.380000000000003%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0086__p2289164010231">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.44%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0086__p16289340102318">ID of the cluster whose specifications you want to change.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_03_0086__section8290154092313"><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 parameters</caption><thead align="left"><tr id="css_03_0086__row10291154016234"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="css_03_0086__p52922040152317">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_0086__p129374072316">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_0086__p152932404235">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_0086__p92931406233">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0086__row8291740122310"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="css_03_0086__p82949401231">needCheckReplica</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="css_03_0086__p1329474042311">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="css_03_0086__p32949402237">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="css_03_0086__p112951409234">Whether to check replicas. The value can be <strong id="css_03_0086__b13295140172319">true</strong> or <strong id="css_03_0086__b16295104014239">false</strong>. The check is enabled by default.</p>
<ul id="css_03_0086__ul1529514012233"><li id="css_03_0086__li229534015234"><strong id="css_03_0086__b52962407238">true</strong>: Replicas are checked.</li><li id="css_03_0086__li22969405232"><strong id="css_03_0086__b729674042317">false</strong>: Replicas are not checked.</li></ul>
</td>
</tr>
<tr id="css_03_0086__row829144012312"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="css_03_0086__p22961340162313">newFlavorId</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="css_03_0086__p132971540152316">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="css_03_0086__p1529794012238">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="css_03_0086__p12981403238">ID of the new flavor. This parameter is obtained by calling the <a href="css_03_0023.html">Obtaining the List of Instance Flavors</a> API. The API compares the values of the <strong id="css_03_0086__b2029818405237">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__section6300134010238"><h4 class="sectiontitle">Response Parameters</h4><p id="css_03_0086__p6300164092315">None</p>
</div>
<div class="section" id="css_03_0086__section1230184022316"><h4 class="sectiontitle">Example Requests</h4><pre class="screen" id="css_03_0086__screen93021440122319">{
"needCheckReplica" : false,
"newFlavorId" : "35b060a4-f152-48ce-8773-36559ceb81f2"
}</pre>
</div>
<div class="section" id="css_03_0086__section19306124011232"><h4 class="sectiontitle">Example Responses</h4><p id="css_03_0086__p1130624010234">None</p>
</div>
<div class="section" id="css_03_0086__section23078406232"><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__row13081840152316"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="css_03_0086__p15310640162313">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_0086__p133106402235">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_03_0086__row930844016232"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0086__p1031116401238">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0086__p183111940172319">Request succeeded.</p>
</td>
</tr>
<tr id="css_03_0086__row7308184010230"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0086__p16311174042313">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0086__p163121640182320">Invalid request.</p>
<p id="css_03_0086__p1312140192311">Modify the request before retry.</p>
</td>
</tr>
<tr id="css_03_0086__row03081740192313"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0086__p8312144082312">409</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0086__p15313164018234">The request could not be completed due to a conflict with the current state of the resource.</p>
<p id="css_03_0086__p1731344072315">The resource that the client attempts to create already exists, or the update request fails to be processed because of a conflict.</p>
</td>
</tr>
<tr id="css_03_0086__row9308940132317"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0086__p1631317409235">412</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0086__p11314194017236">The server did not meet one of the preconditions contained in 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>