doc-exports/docs/opengauss/api-ref/opengauss_api_0016.html
Ru, Li Yi d97aea4dd2 opengauss_api
Reviewed-by: Boka, Ladislav <ladislav.boka@t-systems.com>
Co-authored-by: Ru, Li Yi <liyiru7@huawei.com>
Co-committed-by: Ru, Li Yi <liyiru7@huawei.com>
2024-09-06 09:04:21 +00:00

258 lines
25 KiB
HTML

<a name="EN-US_TOPIC_0000001917290492"></a><a name="EN-US_TOPIC_0000001917290492"></a>
<h1 class="topictitle1">Adding CNs, Adding Shards, or Scaling Up Storage</h1>
<div id="body0000001207167813"><div class="section" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_section150205102514"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001917290492__p112773511722">This API is used to add CNs, add shards, or scale up storage. Before calling this API:</p>
<ul id="EN-US_TOPIC_0000001917290492__en-us_topic_0128427213_ul12259155218373"><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0000001917290508_en-us_topic_0000001791349281_li3231171417412">Learn how to <a href="opengauss_api_0010.html">authenticate</a> this API.</li><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0000001917290508_en-us_topic_0000001791349281_li41227910453">Understand the API in <a href="opengauss_api_0012.html">Using APIs</a>.</li><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0000001917290508_en-us_topic_0000001791349281_en-us_topic_0110967248_li1991981933613">Obtain the required <a href="https://docs.otc.t-systems.com/regions-and-endpoints/index.html" target="_blank" rel="noopener noreferrer">region and endpoint</a>.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_section1213231413285"><h4 class="sectiontitle">Constraints</h4><ul id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_ul116721736162812"><li id="EN-US_TOPIC_0000001917290492__li452503312318">Adding CNs<ul id="EN-US_TOPIC_0000001917290492__ul852593317310"><li id="EN-US_TOPIC_0000001917290492__li152510331315">The maximum number of CNs is 256.</li><li id="EN-US_TOPIC_0000001917290492__li1552516332312">If you choose the single-AZ deployment during instance creation, add CNs in the same AZ.</li></ul>
</li><li id="EN-US_TOPIC_0000001917290492__li10525233638">Adding shards<ul id="EN-US_TOPIC_0000001917290492__ul452510331738"><li id="EN-US_TOPIC_0000001917290492__li1652515336313">The shard growth increment ranges from 1 to 64.</li><li id="EN-US_TOPIC_0000001917290492__li852553312320">The maximum number of shards is 256.</li></ul>
</li><li id="EN-US_TOPIC_0000001917290492__li35250331737">Scaling up Storage<ul id="EN-US_TOPIC_0000001917290492__ul4525233639"><li id="EN-US_TOPIC_0000001917290492__li25251331836">The storage space must be a multiple of (Number of shards x 40 GB).</li><li id="EN-US_TOPIC_0000001917290492__li252518331034">All nodes must be available.</li></ul>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_section106755832618"><h4 class="sectiontitle">URI</h4><ul id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_ul1487413230526"><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li14874623115217">URI format<p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p9874142312522"><a name="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li14874623115217"></a><a name="en-us_topic_0151958051_li14874623115217"></a>POST https://{<em id="EN-US_TOPIC_0000001917290492__en-us_topic_0128427213_i1958383021511">Endpoint</em>}/v3/{project_id}/instances/{instance_id}/action</p>
</li><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li4411135064210">Example<p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p1454414211213"><a name="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li4411135064210"></a><a name="en-us_topic_0151958051_li4411135064210"></a>https://gaussdb.eu-de.otc.t-systems.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/action</p>
</li><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li187472315526">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_table1576811235520" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_row18751223155212"><th align="left" class="cellrowborder" valign="top" width="23.69%" id="mcps1.3.3.2.3.1.2.4.1.1"><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p187572313527"><strong id="EN-US_TOPIC_0000001917290492__b1514614102187">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.8%" id="mcps1.3.3.2.3.1.2.4.1.2"><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p10875132325219"><strong id="EN-US_TOPIC_0000001917290492__b32911913141812">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="54.510000000000005%" id="mcps1.3.3.2.3.1.2.4.1.3"><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p12875122313523"><strong id="EN-US_TOPIC_0000001917290492__b92921316181819">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_row178751238528"><td class="cellrowborder" valign="top" width="23.69%" headers="mcps1.3.3.2.3.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p128751523105218">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="21.8%" headers="mcps1.3.3.2.3.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p108751223195218">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="54.510000000000005%" headers="mcps1.3.3.2.3.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p887592312524">Project ID of a tenant in a region.</p>
<p id="EN-US_TOPIC_0000001917290492__p8544202712219">To obtain this value, see <a href="opengauss_api_0034.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_row387582335220"><td class="cellrowborder" valign="top" width="23.69%" headers="mcps1.3.3.2.3.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p20875102318523">instance_id</p>
</td>
<td class="cellrowborder" valign="top" width="21.8%" headers="mcps1.3.3.2.3.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p15875723185214">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="54.510000000000005%" headers="mcps1.3.3.2.3.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p287552395211">Instance ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_section1265133172714"><h4 class="sectiontitle">Request</h4><ul id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_ul1387512325219"><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li387592375220">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001917290492__table51861761" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001917290492__row2096963"><th align="left" class="cellrowborder" valign="top" width="24.81%" id="mcps1.3.4.2.1.1.2.5.1.1"><p id="EN-US_TOPIC_0000001917290492__p20161769"><strong id="EN-US_TOPIC_0000001917290492__b11903113011819">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.68%" id="mcps1.3.4.2.1.1.2.5.1.2"><p id="EN-US_TOPIC_0000001917290492__p001861660"><strong id="EN-US_TOPIC_0000001917290492__b11453143212183">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.75%" id="mcps1.3.4.2.1.1.2.5.1.3"><p id="EN-US_TOPIC_0000001917290492__p9011612620"><strong id="EN-US_TOPIC_0000001917290492__b2072411330182">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="36.76%" id="mcps1.3.4.2.1.1.2.5.1.4"><p id="EN-US_TOPIC_0000001917290492__p6056962"><strong id="EN-US_TOPIC_0000001917290492__b17285437101813">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001917290492__row149286541761"><td class="cellrowborder" valign="top" width="24.81%" headers="mcps1.3.4.2.1.1.2.5.1.1 "><p id="EN-US_TOPIC_0000001917290492__p594117571466">expand_cluster</p>
</td>
<td class="cellrowborder" valign="top" width="18.68%" headers="mcps1.3.4.2.1.1.2.5.1.2 "><p id="EN-US_TOPIC_0000001917290492__p494119571263">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.75%" headers="mcps1.3.4.2.1.1.2.5.1.3 "><p id="EN-US_TOPIC_0000001917290492__p1494116571862">Object</p>
</td>
<td class="cellrowborder" valign="top" width="36.76%" headers="mcps1.3.4.2.1.1.2.5.1.4 "><p id="EN-US_TOPIC_0000001917290492__p109411557765">This parameter is mandatory when you add CNs or shards.</p>
<p id="EN-US_TOPIC_0000001917290492__p19990184131018">For details, see <a href="#EN-US_TOPIC_0000001917290492__table444432914102">Table 3</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001917290492__row101116861"><td class="cellrowborder" valign="top" width="24.81%" headers="mcps1.3.4.2.1.1.2.5.1.1 "><p id="EN-US_TOPIC_0000001917290492__p1407616620">enlarge_volume</p>
</td>
<td class="cellrowborder" valign="top" width="18.68%" headers="mcps1.3.4.2.1.1.2.5.1.2 "><p id="EN-US_TOPIC_0000001917290492__p1001761068">No</p>
</td>
<td class="cellrowborder" valign="top" width="19.75%" headers="mcps1.3.4.2.1.1.2.5.1.3 "><p id="EN-US_TOPIC_0000001917290492__p1819618612">Object</p>
</td>
<td class="cellrowborder" valign="top" width="36.76%" headers="mcps1.3.4.2.1.1.2.5.1.4 "><p id="EN-US_TOPIC_0000001917290492__p11206164">New storage space after scaling up. This parameter is mandatory for scaling up storage.</p>
<p id="EN-US_TOPIC_0000001917290492__p171468612">For details, see <a href="#EN-US_TOPIC_0000001917290492__table11761269">Table 6</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001917290492__table444432914102"></a><a name="table444432914102"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001917290492__table444432914102" frame="border" border="1" rules="all"><caption><b>Table 3 </b>expand_cluster field data structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001917290492__row944417293100"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.1.2.2.5.1.1"><p id="EN-US_TOPIC_0000001917290492__p1444172910106"><strong id="EN-US_TOPIC_0000001917290492__b5921182319511">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.17%" id="mcps1.3.4.2.1.2.2.5.1.2"><p id="EN-US_TOPIC_0000001917290492__p7444102910104"><strong id="EN-US_TOPIC_0000001917290492__b141418257519">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.41%" id="mcps1.3.4.2.1.2.2.5.1.3"><p id="EN-US_TOPIC_0000001917290492__p144402931014"><strong id="EN-US_TOPIC_0000001917290492__b449515264515">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="36.42%" id="mcps1.3.4.2.1.2.2.5.1.4"><p id="EN-US_TOPIC_0000001917290492__p344462917106"><strong id="EN-US_TOPIC_0000001917290492__b973252918514">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001917290492__row1485320517113"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001917290492__p1783217456117">coordinators</p>
</td>
<td class="cellrowborder" valign="top" width="18.17%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0000001917290492__p283274581111">No</p>
</td>
<td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0000001917290492__p158321045101111">Array of Coordinators objects</p>
</td>
<td class="cellrowborder" valign="top" width="36.42%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0000001917290492__p6832345131112">This parameter is mandatory for adding CNs. For details, see <a href="#EN-US_TOPIC_0000001917290492__table246654931220">Table 4</a>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001917290492__row9704184361114"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="EN-US_TOPIC_0000001917290492__p1183204531116">shard</p>
</td>
<td class="cellrowborder" valign="top" width="18.17%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="EN-US_TOPIC_0000001917290492__p178321845141119">No</p>
</td>
<td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="EN-US_TOPIC_0000001917290492__p1383254541115">Shard object</p>
</td>
<td class="cellrowborder" valign="top" width="36.42%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="EN-US_TOPIC_0000001917290492__p10832164511118">This parameter is mandatory for adding shards. For details, see <a href="#EN-US_TOPIC_0000001917290492__table5142851121216">Table 5</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001917290492__table246654931220"></a><a name="table246654931220"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001917290492__table246654931220" frame="border" border="1" rules="all"><caption><b>Table 4 </b>coordinators parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001917290492__row1446674921218"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.1.3.2.5.1.1"><p id="EN-US_TOPIC_0000001917290492__p7466449171210"><strong id="EN-US_TOPIC_0000001917290492__b475494215015">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.17%" id="mcps1.3.4.2.1.3.2.5.1.2"><p id="EN-US_TOPIC_0000001917290492__p1446694981215"><strong id="EN-US_TOPIC_0000001917290492__b10565164416012">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.41%" id="mcps1.3.4.2.1.3.2.5.1.3"><p id="EN-US_TOPIC_0000001917290492__p1446618496127"><strong id="EN-US_TOPIC_0000001917290492__b12523945602">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="36.42%" id="mcps1.3.4.2.1.3.2.5.1.4"><p id="EN-US_TOPIC_0000001917290492__p10466124920127"><strong id="EN-US_TOPIC_0000001917290492__b141031518011">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001917290492__row4466204915125"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.1.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001917290492__p9914201461416">az_code</p>
</td>
<td class="cellrowborder" valign="top" width="18.17%" headers="mcps1.3.4.2.1.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001917290492__p1291451401414">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.4.2.1.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001917290492__p11914101415143">string</p>
</td>
<td class="cellrowborder" valign="top" width="36.42%" headers="mcps1.3.4.2.1.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001917290492__p15674421151819">AZs to which CNs are to be added. If multiple CNs need to be added, enter the AZ where each CN is located.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001917290492__table5142851121216"></a><a name="table5142851121216"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001917290492__table5142851121216" frame="border" border="1" rules="all"><caption><b>Table 5 </b>shard parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001917290492__row61430518128"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.1.4.2.5.1.1"><p id="EN-US_TOPIC_0000001917290492__p314385141210"><strong id="EN-US_TOPIC_0000001917290492__b8206161410553">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.17%" id="mcps1.3.4.2.1.4.2.5.1.2"><p id="EN-US_TOPIC_0000001917290492__p11432051101218"><strong id="EN-US_TOPIC_0000001917290492__b1886121213554">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.41%" id="mcps1.3.4.2.1.4.2.5.1.3"><p id="EN-US_TOPIC_0000001917290492__p4143551131220"><strong id="EN-US_TOPIC_0000001917290492__b1032191018559">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="36.42%" id="mcps1.3.4.2.1.4.2.5.1.4"><p id="EN-US_TOPIC_0000001917290492__p10143151151220"><strong id="EN-US_TOPIC_0000001917290492__b1894028125510">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001917290492__row15143175131217"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.1.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001917290492__p199842048101610">count</p>
</td>
<td class="cellrowborder" valign="top" width="18.17%" headers="mcps1.3.4.2.1.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001917290492__p11984144815162">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.4.2.1.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001917290492__p1898444801615">integer</p>
</td>
<td class="cellrowborder" valign="top" width="36.42%" headers="mcps1.3.4.2.1.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001917290492__p2984174819168">Number of shards to be added.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001917290492__table11761269"></a><a name="table11761269"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001917290492__table11761269" frame="border" border="1" rules="all"><caption><b>Table 6 </b>enlarge_volume field data structure description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001917290492__row18110617619"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.2.1.5.2.5.1.1"><p id="EN-US_TOPIC_0000001917290492__p71146165"><strong id="EN-US_TOPIC_0000001917290492__b52701339155413">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.17%" id="mcps1.3.4.2.1.5.2.5.1.2"><p id="EN-US_TOPIC_0000001917290492__p71106965"><strong id="EN-US_TOPIC_0000001917290492__b12959163710547">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20.41%" id="mcps1.3.4.2.1.5.2.5.1.3"><p id="EN-US_TOPIC_0000001917290492__p6166662"><strong id="EN-US_TOPIC_0000001917290492__b56161835185413">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="36.42%" id="mcps1.3.4.2.1.5.2.5.1.4"><p id="EN-US_TOPIC_0000001917290492__p511361762"><strong id="EN-US_TOPIC_0000001917290492__b103834185420">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001917290492__row2106161"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.2.1.5.2.5.1.1 "><p id="EN-US_TOPIC_0000001917290492__p111761167">size</p>
</td>
<td class="cellrowborder" valign="top" width="18.17%" headers="mcps1.3.4.2.1.5.2.5.1.2 "><p id="EN-US_TOPIC_0000001917290492__p21106568">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20.41%" headers="mcps1.3.4.2.1.5.2.5.1.3 "><p id="EN-US_TOPIC_0000001917290492__p411561262">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="36.42%" headers="mcps1.3.4.2.1.5.2.5.1.4 "><p id="EN-US_TOPIC_0000001917290492__p6114618610">Storage space, which must always be a multiple of (Number of shards x 40 GB). Value range: (Number of shards x 40 GB) to (Number of shards x 16 TB).</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001917290492__section017594920414"><h4 class="sectiontitle">Example Request</h4><ul id="EN-US_TOPIC_0000001917290492__ul1378925411417"><li id="EN-US_TOPIC_0000001917290492__li2789165415411">Adding a CN<pre class="screen" id="EN-US_TOPIC_0000001917290492__screen126360054218">{
"expand_cluster": {
"coordinators": [
{
"az_code": "eu-de-01"
}
]
}
}</pre>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0000001917290492__ul189782122426"><li id="EN-US_TOPIC_0000001917290492__li597851212428">Adding multiple CNs<pre class="screen" id="EN-US_TOPIC_0000001917290492__screen510241604210">{
"expand_cluster": {
"coordinators": [
{
"az_code": "eu-de-01"
},
{
"az_code": "eu-de-01"
},
{
"az_code": "eu-de-01"
}
]
}
}</pre>
</li><li id="EN-US_TOPIC_0000001917290492__li14911171974215">Adding a DN shard<pre class="screen" id="EN-US_TOPIC_0000001917290492__screen1063112247425">{
"expand_cluster": {
"shard": {
"count": 1
}
}
}</pre>
</li><li id="EN-US_TOPIC_0000001917290492__li311017329426">Scaling up storage to 400 GB<pre class="screen" id="EN-US_TOPIC_0000001917290492__screen193101629134211">{
"enlarge_volume": {
"size": 400
}
}</pre>
</li></ul>
<div class="section" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_section159912464345"><h4 class="sectiontitle">Response</h4><ul id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_ul28758235521"><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li158771723155214">Normal response
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_table137871523165214" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Parameter description</caption><thead align="left"><tr id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_row38777235523"><th align="left" class="cellrowborder" valign="top" width="33.68%" id="mcps1.3.7.2.1.1.2.4.1.1"><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p128770232529"><strong id="EN-US_TOPIC_0000001917290492__b1097710310529">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.47%" id="mcps1.3.7.2.1.1.2.4.1.2"><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p78771723175214"><strong id="EN-US_TOPIC_0000001917290492__b1433272813527">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="32.85%" id="mcps1.3.7.2.1.1.2.4.1.3"><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p78775237527"><strong id="EN-US_TOPIC_0000001917290492__b3440142410524">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_row6877523135212"><td class="cellrowborder" valign="top" width="33.68%" headers="mcps1.3.7.2.1.1.2.4.1.1 "><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p48771723115210">job_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.47%" headers="mcps1.3.7.2.1.1.2.4.1.2 "><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p4877182318524">String</p>
</td>
<td class="cellrowborder" valign="top" width="32.85%" headers="mcps1.3.7.2.1.1.2.4.1.3 "><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p887719239520">Task ID. This parameter is returned when your instance is billed at a pay-per-use basis.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_ul42421820113517"><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li5242142010359">Example normal response<pre class="codeblock" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_codeblock1214473263512">{
"job_id": "2b414788a6004883a02390e2eb0ea227"
}</pre>
</li><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li4328453192">Abnormal response<p id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_p58771023185211"><a name="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_li4328453192"></a><a name="en-us_topic_0151958051_li4328453192"></a>For details, see <a href="opengauss_api_0031.html">Abnormal Request Results</a>.</p>
</li></ul>
<div class="section" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="EN-US_TOPIC_0000001917290492__en-us_topic_0000001703994577_en-us_topic_0110967248_ul7858132212142"><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0000001703994577_en-us_topic_0110967248_li58581622171411">Normal<p id="EN-US_TOPIC_0000001917290492__en-us_topic_0000001703994577_en-us_topic_0110967248_p1040982941020"><a name="EN-US_TOPIC_0000001917290492__en-us_topic_0000001703994577_en-us_topic_0110967248_li58581622171411"></a><a name="en-us_topic_0000001703994577_en-us_topic_0110967248_li58581622171411"></a>202</p>
</li><li id="EN-US_TOPIC_0000001917290492__en-us_topic_0000001703994577_en-us_topic_0110967248_li11583183218149">Abnormal<p id="EN-US_TOPIC_0000001917290492__en-us_topic_0000001703994577_en-us_topic_0110967248_p65078394148"><a name="EN-US_TOPIC_0000001917290492__en-us_topic_0000001703994577_en-us_topic_0110967248_li11583183218149"></a><a name="en-us_topic_0000001703994577_en-us_topic_0110967248_li11583183218149"></a>For details, see <a href="opengauss_api_0032.html">Status Codes</a>.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001917290492__en-us_topic_0151958051_section946032144017"><h4 class="sectiontitle">Error Code</h4><p id="EN-US_TOPIC_0000001917290492__en-us_topic_0000001704033841_en-us_topic_0110967248_p19357163913406">For details, see <a href="opengauss_api_0033.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="opengauss_api_0014.html">Instance Management</a></div>
</div>
</div>