forked from docs/doc-exports
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: Lu, Huayi <luhuayi@huawei.com> Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
153 lines
12 KiB
HTML
153 lines
12 KiB
HTML
<a name="EN-US_TOPIC_0000001231472767"></a><a name="EN-US_TOPIC_0000001231472767"></a>
|
|
|
|
<h1 class="topictitle1">Scaling Out a Cluster</h1>
|
|
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_s7aa3de1b44f14c0487bab690bb5702d6"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_p14656161715131">This API is used to scale out a cluster.</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_s9db56e76e7694a5cbfd993c7d1db0606"><h4 class="sectiontitle">URI</h4><pre class="screen" id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_screen1624519311588">POST /v1.0/{project_id}/clusters/{cluster_id}/resize</pre>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001231472767__table91080561256" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001231472767__row141071456102516"><th align="left" class="cellrowborder" valign="top" width="20.73%" id="mcps1.3.2.3.2.5.1.1"><p id="EN-US_TOPIC_0000001231472767__p6106105614251"><strong id="EN-US_TOPIC_0000001231472767__b116305875682011">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="10.18%" id="mcps1.3.2.3.2.5.1.2"><p id="EN-US_TOPIC_0000001231472767__p1310645619258"><strong id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_b8117321319">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.4%" id="mcps1.3.2.3.2.5.1.3"><p id="EN-US_TOPIC_0000001231472767__p610614564251"><strong id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_b122633102317">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53.690000000000005%" id="mcps1.3.2.3.2.5.1.4"><p id="EN-US_TOPIC_0000001231472767__p41077567257"><strong id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_b1080593319233">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000001231472767__row1510825614255"><td class="cellrowborder" valign="top" width="20.73%" headers="mcps1.3.2.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001231472767__p15107135612515">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10.18%" headers="mcps1.3.2.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001231472767__p191071756192512">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.2.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001231472767__p51078566255">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.690000000000005%" headers="mcps1.3.2.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001231472767__p15107145632517"><span id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_text1863816153111">Project ID</span>. For details about how to obtain the ID, see <a href="dws_02_0011.html">Obtaining a Project ID</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001231472767__row151081256172514"><td class="cellrowborder" valign="top" width="20.73%" headers="mcps1.3.2.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001231472767__p17108456152517">cluster_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10.18%" headers="mcps1.3.2.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001231472767__p4108145616252">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.4%" headers="mcps1.3.2.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001231472767__p510811564258">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.690000000000005%" headers="mcps1.3.2.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001231472767__p15108185692519">ID of the cluster to be scaled out. For details about how to obtain the ID, see <a href="dws_02_00068.html">Obtaining the Cluster ID</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001231472767__section043381942612"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001231472767__table9704631162617" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001231472767__row1070573182615"><th align="left" class="cellrowborder" valign="top" width="20.330000000000002%" id="mcps1.3.3.2.2.5.1.1"><p id="EN-US_TOPIC_0000001231472767__p1670515315263"><strong id="EN-US_TOPIC_0000001231472767__b214625823682011">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.18%" id="mcps1.3.3.2.2.5.1.2"><p id="EN-US_TOPIC_0000001231472767__p1770513117269"><strong id="EN-US_TOPIC_0000001231472767__b682645243">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.56%" id="mcps1.3.3.2.2.5.1.3"><p id="EN-US_TOPIC_0000001231472767__p970573117266"><strong id="EN-US_TOPIC_0000001231472767__b1055062043">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="39.93%" id="mcps1.3.3.2.2.5.1.4"><p id="EN-US_TOPIC_0000001231472767__p19705183122614"><strong id="EN-US_TOPIC_0000001231472767__b1495008945">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000001231472767__row14706131172614"><td class="cellrowborder" valign="top" width="20.330000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001231472767__p18706031102613">scale_out</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.18%" headers="mcps1.3.3.2.2.5.1.2 "><p id="EN-US_TOPIC_0000001231472767__p270617316267">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.56%" headers="mcps1.3.3.2.2.5.1.3 "><p id="EN-US_TOPIC_0000001231472767__p14706183172615"><a href="#EN-US_TOPIC_0000001231472767__table27082031182617">ScaleOut</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.93%" headers="mcps1.3.3.2.2.5.1.4 "><p id="EN-US_TOPIC_0000001231472767__p870613142618">Object to be scaled out</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001231472767__table27082031182617"></a><a name="table27082031182617"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001231472767__table27082031182617" frame="border" border="1" rules="all"><caption><b>Table 3 </b>ScaleOut</caption><thead align="left"><tr id="EN-US_TOPIC_0000001231472767__row1370853122613"><th align="left" class="cellrowborder" valign="top" width="20.849999999999998%" id="mcps1.3.3.3.2.5.1.1"><p id="EN-US_TOPIC_0000001231472767__p770893122615"><strong id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_b713819463220">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="10.299999999999999%" id="mcps1.3.3.3.2.5.1.2"><p id="EN-US_TOPIC_0000001231472767__p47081131122619"><strong id="EN-US_TOPIC_0000001231472767__b1976210486">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.64%" id="mcps1.3.3.3.2.5.1.3"><p id="EN-US_TOPIC_0000001231472767__p1170911314269"><strong id="EN-US_TOPIC_0000001231472767__b1537215032">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53.21%" id="mcps1.3.3.3.2.5.1.4"><p id="EN-US_TOPIC_0000001231472767__p1770923152610"><strong id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_b577619462246">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000001231472767__row7709131112617"><td class="cellrowborder" valign="top" width="20.849999999999998%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001231472767__p10709103118266">count</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10.299999999999999%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001231472767__p070911316260">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.64%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001231472767__p3709631172613">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.21%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001231472767__p5710153120266">Number of nodes to be added</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001231472767__section1141104510267"><h4 class="sectiontitle">Response Parameters</h4><p id="EN-US_TOPIC_0000001231472767__p151941753162610">None</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_sa64d5fde1cb94be29689b1aab5bc2bb2"><h4 class="sectiontitle">Example Request</h4><div class="p" id="EN-US_TOPIC_0000001231472767__p1669721810277">An example of the scale_out API is as follows:<pre class="screen" id="EN-US_TOPIC_0000001231472767__screen888416108276">POST https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/resize
|
|
|
|
{
|
|
"scale_out" : {
|
|
"count" : 3
|
|
}
|
|
}</pre>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_saf8285fea2964e558a059d985c498559"><h4 class="sectiontitle">Response Message</h4><p id="EN-US_TOPIC_0000001231472767__p15958531182714">None</p>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001098816630_s318da95b204f47c4bef42e78b54a9089"><h4 class="sectiontitle">Status Code</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001231472767__en-us_topic_0000001387498504_status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="EN-US_TOPIC_0000001231472767__row6217101417"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="EN-US_TOPIC_0000001231472767__p749110148">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="EN-US_TOPIC_0000001231472767__p9561171413"><strong id="EN-US_TOPIC_0000001231472767__b1356498997">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000001231472767__row17201141418"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000001231472767__p751011144">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000001231472767__p359181416">The cluster is scaled out successfully.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001231472767__row152121101415"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000001231472767__p261615143">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000001231472767__p461317146">Request error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001231472767__row93141141410"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000001231472767__p1971415147">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000001231472767__p58121191419">Authentication failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001231472767__row19320171418"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000001231472767__p782181416">403</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000001231472767__p29161121410">You do not have required permissions.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001231472767__row53191121415"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000001231472767__p19918141417">404</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000001231472767__p5109115141">No resources found.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001231472767__row5391191415"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000001231472767__p911314147">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000001231472767__p9111817143">Internal service error.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001231472767__row331610149"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="EN-US_TOPIC_0000001231472767__p181213112148">503</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="EN-US_TOPIC_0000001231472767__p71318111411">Service unavailable.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_02_0017.html">Managing Clusters</a></div>
|
|
</div>
|
|
</div>
|
|
|