forked from docs/doc-exports
Zheng, Xiu
bf0cbd66f9
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>
135 lines
10 KiB
HTML
135 lines
10 KiB
HTML
<a name="css_03_0087"></a><a name="css_03_0087"></a>
|
|
|
|
<h1 class="topictitle1">Changing the Specifications of a Specified Node Type</h1>
|
|
<div id="body0000001526386077"><div class="section" id="css_03_0087__section124411536113113"><h4 class="sectiontitle">Function</h4><p id="css_03_0087__p5442103683118">This API is used to modify cluster specifications. The following node types can be changed:</p>
|
|
<ul id="css_03_0087__ul4442133614313"><li id="css_03_0087__li1744203610317"><strong id="css_03_0087__b17442103673110">ess</strong>: data node</li><li id="css_03_0087__li144439366319"><strong id="css_03_0087__b164431736153114">ess-cold</strong>: cold data node</li><li id="css_03_0087__li204439367313"><strong id="css_03_0087__b14431636113120">ess-client</strong>: client node</li><li id="css_03_0087__li1744313663116"><strong id="css_03_0087__b544411366312">ess-master</strong>: master node</li></ul>
|
|
</div>
|
|
<div class="section" id="css_03_0087__section8445336133113"><h4 class="sectiontitle">URI</h4><p id="css_03_0087__p0445143683117">POST /v1.0/{project_id}/clusters/{cluster_id}/{types}/flavor</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0087__table4447173673111" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="css_03_0087__row184467366317"><th align="left" class="cellrowborder" valign="top" width="15.1%" id="mcps1.3.2.3.2.5.1.1"><p id="css_03_0087__p11447203611314">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.16%" id="mcps1.3.2.3.2.5.1.2"><p id="css_03_0087__p64472036133110">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.14%" id="mcps1.3.2.3.2.5.1.3"><p id="css_03_0087__p12448536163117">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="47.599999999999994%" id="mcps1.3.2.3.2.5.1.4"><p id="css_03_0087__p5448936183119">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="css_03_0087__row844673683115"><td class="cellrowborder" valign="top" width="15.1%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0087__p134497367317">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0087__p18449133613115">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.14%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0087__p134491036123111">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="47.599999999999994%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0087__p1445017362318">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_0087__row3446193610318"><td class="cellrowborder" valign="top" width="15.1%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0087__p164516367315">cluster_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0087__p64511836153119">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.14%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0087__p11452183693112">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="47.599999999999994%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0087__p44543366313">ID of the cluster whose specifications you want to change.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="css_03_0087__row16446133610319"><td class="cellrowborder" valign="top" width="15.1%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0087__p174542365316">types</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0087__p3455936133114">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.14%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0087__p13455103613116">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="47.599999999999994%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0087__p134563369312">Type of the cluster node you want to modify.</p>
|
|
<ul id="css_03_0087__ul1745613603118"><li id="css_03_0087__li13456193618315">ess: data node</li><li id="css_03_0087__li84578369313">ess-cold: cold data node</li><li id="css_03_0087__li94572362316">ess-client: client node</li><li id="css_03_0087__li11458163619319">ess-master: master node</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="css_03_0087__section1045803613317"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0087__request_UpdateFlavorByTypeReq" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameters</caption><thead align="left"><tr id="css_03_0087__row74591236153120"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="css_03_0087__p154618361318">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_0087__p1046163613317">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_0087__p746243613110">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_0087__p134624366313">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="css_03_0087__row0459436103119"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="css_03_0087__p1446218365311">needCheckReplica</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="css_03_0087__p1146333673117">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="css_03_0087__p19463113633115">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="css_03_0087__p54631336143118">Whether to check replicas. The value can be <strong id="css_03_0087__b11464153611315">true</strong> or <strong id="css_03_0087__b10464136123113">false</strong>. The check is enabled by default.</p>
|
|
<ul id="css_03_0087__ul124645367312"><li id="css_03_0087__li1546414367312"><strong id="css_03_0087__b14646360310">true</strong>: Replicas are checked.</li><li id="css_03_0087__li1446413365312"><strong id="css_03_0087__b4465133617315">false</strong>: Replicas are not checked.</li></ul>
|
|
<p id="css_03_0087__p13465103613111">Master and client nodes are not data nodes, so they do not need to check replicas no matter this parameter is set to <strong id="css_03_0087__b1646514367311">true</strong> or <strong id="css_03_0087__b134651836173111">false</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="css_03_0087__row845983615316"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="css_03_0087__p4465123618311">newFlavorId</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="css_03_0087__p1146612360312">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="css_03_0087__p94661536173112">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="css_03_0087__p144677368313">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_0087__b1146703663117">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_0087__section7470163615315"><h4 class="sectiontitle">Response Parameters</h4><p id="css_03_0087__p1647243633117">None</p>
|
|
</div>
|
|
<div class="section" id="css_03_0087__section134721236123110"><h4 class="sectiontitle">Example Requests</h4><pre class="screen" id="css_03_0087__screen547333616319">{
|
|
"needCheckReplica" : false,
|
|
"newFlavorId" : "35b060a4-f152-48ce-8773-36559ceb81f2"
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="css_03_0087__section147419362318"><h4 class="sectiontitle">Example Responses</h4><p id="css_03_0087__p447583643113">None</p>
|
|
</div>
|
|
<div class="section" id="css_03_0087__section4475163613110"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0087__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="css_03_0087__row9476173619318"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="css_03_0087__p147763611313">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_0087__p4477436113110">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="css_03_0087__row247643603113"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0087__p04781136133116">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0087__p1747913633110">Request succeeded.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="css_03_0087__row147619362315"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0087__p144791836193110">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0087__p114799364318">Invalid request.</p>
|
|
<p id="css_03_0087__p12480836143115">Modify the request before retry.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="css_03_0087__row19476183663114"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0087__p1748018363312">409</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0087__p124803366311">The request could not be completed due to a conflict with the current state of the resource.</p>
|
|
<p id="css_03_0087__p94811536183110">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_0087__row7476236193110"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="css_03_0087__p10481736133117">412</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="css_03_0087__p34811536163119">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>
|
|
|