forked from docs/doc-exports
Zheng, Xiu
99a2d77599
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>
147 lines
11 KiB
HTML
147 lines
11 KiB
HTML
<a name="css_03_0025"></a><a name="css_03_0025"></a>
|
|
|
|
<h1 class="topictitle1">Scaling Out a Cluster with only Common Nodes</h1>
|
|
<div id="body1515114536681"><div class="section" id="css_03_0025__section874853215915"><h4 class="sectiontitle">Function</h4><p id="css_03_0025__p193287337153">This API is used to scale out a cluster with only common nodes. Clusters with master, client, or cold data nodes cannot use this API.</p>
|
|
</div>
|
|
<div class="section" id="css_03_0025__section8763193210910"><h4 class="sectiontitle">URI</h4><pre class="screen" id="css_03_0025__screen1695846201113">POST /v1.0/{project_id}/clusters/{cluster_id}/extend </pre>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_03_0025__table57631032695" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="css_03_0025__row4445336913"><th align="left" class="cellrowborder" valign="top" width="15.75%" id="mcps1.3.2.3.2.5.1.1"><p id="css_03_0025__p54417338910">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="24.060000000000002%" id="mcps1.3.2.3.2.5.1.2"><p id="css_03_0025__p1644733693">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.46%" id="mcps1.3.2.3.2.5.1.3"><p id="css_03_0025__p11441233696">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40.73%" id="mcps1.3.2.3.2.5.1.4"><p id="css_03_0025__p124403319916">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="css_03_0025__row94414331098"><td class="cellrowborder" valign="top" width="15.75%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0025__p0441331398">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0025__p9444331997">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.46%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0025__p144412334919">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.73%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0025__p18449331896">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_0025__row14453320917"><td class="cellrowborder" valign="top" width="15.75%" headers="mcps1.3.2.3.2.5.1.1 "><p id="css_03_0025__p2044193314920">cluster_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.2.3.2.5.1.2 "><p id="css_03_0025__p24410331398">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.46%" headers="mcps1.3.2.3.2.5.1.3 "><p id="css_03_0025__p844133316918">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.73%" headers="mcps1.3.2.3.2.5.1.4 "><p id="css_03_0025__p13441833493">ID of the cluster to be scaled out.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="css_03_0025__section1477913211910"><h4 class="sectiontitle">Request</h4><p id="css_03_0025__p9408125115328"><a href="#css_03_0025__table82481020121413">Table 2</a> describes the request parameters.</p>
|
|
|
|
<div class="tablenoborder"><a name="css_03_0025__table82481020121413"></a><a name="table82481020121413"></a><table cellpadding="4" cellspacing="0" summary="" id="css_03_0025__table82481020121413" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="css_03_0025__row18248112010149"><th align="left" class="cellrowborder" valign="top" width="19.2%" id="mcps1.3.3.3.2.5.1.1"><p id="css_03_0025__p10441033494">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.08%" id="mcps1.3.3.3.2.5.1.2"><p id="css_03_0025__p74493316910">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.49%" id="mcps1.3.3.3.2.5.1.3"><p id="css_03_0025__p1044533896">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="47.23%" id="mcps1.3.3.3.2.5.1.4"><p id="css_03_0025__p154413335917">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="css_03_0025__row18248182013148"><td class="cellrowborder" valign="top" width="19.2%" headers="mcps1.3.3.3.2.5.1.1 "><p id="css_03_0025__p11441933698">grow</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.08%" headers="mcps1.3.3.3.2.5.1.2 "><p id="css_03_0025__p4441233891">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.49%" headers="mcps1.3.3.3.2.5.1.3 "><p id="css_03_0025__p1344203319917">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="47.23%" headers="mcps1.3.3.3.2.5.1.4 "><p id="css_03_0025__p9448924192218">Detailed description about the cluster scale-out request. For details, see <a href="#css_03_0025__table198051725112115">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="css_03_0025__table198051725112115"></a><a name="table198051725112115"></a><table cellpadding="4" cellspacing="0" summary="" id="css_03_0025__table198051725112115" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="css_03_0025__b84235270618226">grow</strong> field description</caption><thead align="left"><tr id="css_03_0025__row38051625132113"><th align="left" class="cellrowborder" valign="top" width="19.689999999999998%" id="mcps1.3.3.4.2.5.1.1"><p id="css_03_0025__p14183513162314">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.52%" id="mcps1.3.3.4.2.5.1.2"><p id="css_03_0025__p14183813172311">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.52%" id="mcps1.3.3.4.2.5.1.3"><p id="css_03_0025__p12183151313234">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="49.27%" id="mcps1.3.3.4.2.5.1.4"><p id="css_03_0025__p12183131319238">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="css_03_0025__row1380519259210"><td class="cellrowborder" valign="top" width="19.689999999999998%" headers="mcps1.3.3.4.2.5.1.1 "><p id="css_03_0025__p161839139239">modifySize</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.52%" headers="mcps1.3.3.4.2.5.1.2 "><p id="css_03_0025__p121831413142310">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.52%" headers="mcps1.3.3.4.2.5.1.3 "><p id="css_03_0025__p17183013172315">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.27%" headers="mcps1.3.3.4.2.5.1.4 "><p id="css_03_0025__p318341317238">Number of instances in a cluster after a scale-out.</p>
|
|
<div class="note" id="css_03_0025__note17398115110518"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="css_03_0025__p1639820519513">The total number of existing instances and newly added instances in a cluster cannot exceed 32.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="css_03_0025__section19810103220915"><h4 class="sectiontitle">Response</h4><p id="css_03_0025__p0505183933312">None</p>
|
|
</div>
|
|
<div class="section" id="css_03_0025__section3958181015348"><h4 class="sectiontitle">Examples</h4><p id="css_03_0025__p64419337911">Example request</p>
|
|
<pre class="screen" id="css_03_0025__screen184473316911">POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/extend
|
|
{
|
|
"grow":
|
|
{
|
|
"modifySize": 4
|
|
}
|
|
}</pre>
|
|
<p id="css_03_0025__p1144153313915">Example response</p>
|
|
<pre class="screen" id="css_03_0025__screen112881121163417">{}</pre>
|
|
</div>
|
|
<div class="section" id="css_03_0025__section87962546391"><h4 class="sectiontitle">Status Code</h4><p id="css_03_0025__p46921709171"><a href="#css_03_0025__table12321369178">Table 4</a> describes the status code.</p>
|
|
|
|
<div class="tablenoborder"><a name="css_03_0025__table12321369178"></a><a name="table12321369178"></a><table cellpadding="4" cellspacing="0" summary="" id="css_03_0025__table12321369178" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Status codes</caption><thead align="left"><tr id="css_03_0025__en-us_topic_0000001342030725_row1972183521418"><th align="left" class="cellrowborder" valign="top" width="15.939999999999998%" id="mcps1.3.6.3.2.4.1.1"><p id="css_03_0025__en-us_topic_0000001342030725_p14560134151414">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="31.04%" id="mcps1.3.6.3.2.4.1.2"><p id="css_03_0025__en-us_topic_0000001342030725_p5563194141411">Message</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53.02%" id="mcps1.3.6.3.2.4.1.3"><p id="css_03_0025__en-us_topic_0000001342030725_p256616411143">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="css_03_0025__en-us_topic_0000001342030725_row129720356144"><td class="cellrowborder" valign="top" width="15.939999999999998%" headers="mcps1.3.6.3.2.4.1.1 "><p id="css_03_0025__en-us_topic_0000001342030725_p1957004131410">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="31.04%" headers="mcps1.3.6.3.2.4.1.2 "><p id="css_03_0025__en-us_topic_0000001342030725_p165731141171419">BadRequest</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.02%" headers="mcps1.3.6.3.2.4.1.3 "><p id="css_03_0025__en-us_topic_0000001342030725_p65778413148">Invalid request.</p>
|
|
<p id="css_03_0025__en-us_topic_0000001342030725_p1557974171415">Modify the request instead of retrying.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="css_03_0025__en-us_topic_0000001342030725_row8972103517147"><td class="cellrowborder" valign="top" width="15.939999999999998%" headers="mcps1.3.6.3.2.4.1.1 "><p id="css_03_0025__en-us_topic_0000001342030725_p75841441191410">404</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="31.04%" headers="mcps1.3.6.3.2.4.1.2 "><p id="css_03_0025__en-us_topic_0000001342030725_p258716416142">NotFound</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.02%" headers="mcps1.3.6.3.2.4.1.3 "><p id="css_03_0025__en-us_topic_0000001342030725_p15589154118141">The requested resource cannot be found.</p>
|
|
<p id="css_03_0025__en-us_topic_0000001342030725_p14590164151410">Modify the request instead of retrying.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="css_03_0025__en-us_topic_0000001342030725_row297223511416"><td class="cellrowborder" valign="top" width="15.939999999999998%" headers="mcps1.3.6.3.2.4.1.1 "><p id="css_03_0025__en-us_topic_0000001342030725_p13595164131416">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="31.04%" headers="mcps1.3.6.3.2.4.1.2 "><p id="css_03_0025__en-us_topic_0000001342030725_p9598741131416">OK</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.02%" headers="mcps1.3.6.3.2.4.1.3 "><p id="css_03_0025__en-us_topic_0000001342030725_p659994115146">The request is processed successfully.</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>
|
|
|