doc-exports/docs/css/api-ref/AddIndependentNode.html
Zheng, Xiu 3fa966049f css api 20240704 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>
2024-07-22 17:01:37 +00:00

191 lines
14 KiB
HTML

<a name="AddIndependentNode"></a><a name="AddIndependentNode"></a>
<h1 class="topictitle1">Adding Master and Client Nodes</h1>
<div id="body0000001926438181"><div class="section" id="AddIndependentNode__section880755564414"><h4 class="sectiontitle">Function</h4><p id="AddIndependentNode__p880925584417">This API is used to add master and client nodes to a cluster.</p>
</div>
<div class="section" id="AddIndependentNode__section58091055154418"><h4 class="sectiontitle">Calling Method</h4><p id="AddIndependentNode__p1781013558444">For details, see <a href="css_03_0137.html">Calling APIs</a>.</p>
</div>
<div class="section" id="AddIndependentNode__section13810355104417"><h4 class="sectiontitle">URI</h4><p id="AddIndependentNode__p19811955174411">POST /v1.0/{project_id}/clusters/{cluster_id}/type/{type}/independent</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="AddIndependentNode__table581319555448" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameters</caption><thead align="left"><tr id="AddIndependentNode__row18812145517440"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="AddIndependentNode__p1781416551443">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="AddIndependentNode__p281455514413">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="AddIndependentNode__p3815135511446">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="AddIndependentNode__p081625564413">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="AddIndependentNode__row13812355174412"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="AddIndependentNode__p981685534411">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="AddIndependentNode__p58171155174418">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="AddIndependentNode__p58171855114413">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="AddIndependentNode__p0818125517445">Project ID. For details about how to obtain a project ID, see <a href="css_03_0071.html">Obtaining a Project ID and Name</a>.</p>
</td>
</tr>
<tr id="AddIndependentNode__row208126553444"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="AddIndependentNode__p6819135515441">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="AddIndependentNode__p108201455184415">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="AddIndependentNode__p14821455104417">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="AddIndependentNode__p198238559443">ID of the cluster that needs an independent master or client.</p>
</td>
</tr>
<tr id="AddIndependentNode__row208131055184410"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="AddIndependentNode__p7823165513445">type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="AddIndependentNode__p1582455518449">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="AddIndependentNode__p188251955194412">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="AddIndependentNode__p1082545516445">Node type. The value can be:</p>
<ul id="AddIndependentNode__ul13826455104413"><li id="AddIndependentNode__li282655510441"><strong id="AddIndependentNode__b1891731614381">ess-master</strong>: Master node</li><li id="AddIndependentNode__li13827755184411"><strong id="AddIndependentNode__b4568141883817">ess-client</strong>: Client node</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="AddIndependentNode__section6827195513440"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="AddIndependentNode__request_IndependentReq" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameters</caption><thead align="left"><tr id="AddIndependentNode__row482815551445"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.1"><p id="AddIndependentNode__p68311355174413">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.2"><p id="AddIndependentNode__p98311955164411">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.3"><p id="AddIndependentNode__p15832205511443">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.2.5.1.4"><p id="AddIndependentNode__p983314555444">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="AddIndependentNode__row1828155511444"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="AddIndependentNode__p183315552448">type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="AddIndependentNode__p783495511449">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="AddIndependentNode__p483525554411"><a href="#AddIndependentNode__request_IndependentBodyReq">IndependentBodyReq</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="AddIndependentNode__p38351455194419">Master/Client request body parameter</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="AddIndependentNode__request_IndependentBodyReq"></a><a name="request_IndependentBodyReq"></a><table cellpadding="4" cellspacing="0" summary="" id="AddIndependentNode__request_IndependentBodyReq" frame="border" border="1" rules="all"><caption><b>Table 3 </b>IndependentBodyReq</caption><thead align="left"><tr id="AddIndependentNode__row48361555164415"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.5.1.1"><p id="AddIndependentNode__p583816555440">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.5.1.2"><p id="AddIndependentNode__p6840145510448">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.5.1.3"><p id="AddIndependentNode__p4840555124414">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.3.2.5.1.4"><p id="AddIndependentNode__p88413557444">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="AddIndependentNode__row168361955124417"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="AddIndependentNode__p10842185517448">flavor_ref</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="AddIndependentNode__p1843055184419">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="AddIndependentNode__p19844155517446">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="AddIndependentNode__p784410551445">Flavor ID. You can obtain the value of this parameter by calling the API <a href="ListFlavors.html">Obtaining the Instance Specifications List</a>. Select the flavor ID suitable for your cluster version.</p>
</td>
</tr>
<tr id="AddIndependentNode__row11837555104413"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="AddIndependentNode__p9845145516445">node_size</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="AddIndependentNode__p18462550447">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="AddIndependentNode__p10846105517448">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="AddIndependentNode__p68471255204417">Number of nodes.</p>
<ul id="AddIndependentNode__ul7847855184411"><li id="AddIndependentNode__li11847115534416">If the node type is <strong id="AddIndependentNode__b10360418183919">ess-master</strong>, the number of nodes must be an odd number in the range 3 to 10.</li><li id="AddIndependentNode__li2848135514415">If the node type is <strong id="AddIndependentNode__b4260162593913">ess-client</strong>, the number of nodes must be in the range 1 to 32.</li></ul>
</td>
</tr>
<tr id="AddIndependentNode__row9837185518449"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="AddIndependentNode__p1484917551447">volume_type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="AddIndependentNode__p1084925514416">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="AddIndependentNode__p1185018553449">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="AddIndependentNode__p19851455164414">Node storage type. Its value can be <strong id="AddIndependentNode__b87781929183917">ULTRAHIGH</strong>, <strong id="AddIndependentNode__b58171231173912">COMMON</strong>, or <strong id="AddIndependentNode__b156751633173910">HIGH</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="AddIndependentNode__section13854155564414"><h4 class="sectiontitle">Response Parameters</h4><p id="AddIndependentNode__p1085520552442"><strong id="AddIndependentNode__b73337508051753">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="AddIndependentNode__response_IndependentRsp" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response body parameters</caption><thead align="left"><tr id="AddIndependentNode__row1985665514440"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.3.2.4.1.1"><p id="AddIndependentNode__p9857125518445">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.3.2.4.1.2"><p id="AddIndependentNode__p118581155104417">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.3.2.4.1.3"><p id="AddIndependentNode__p4859105594410">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="AddIndependentNode__row1885619555444"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.1 "><p id="AddIndependentNode__p78591855164418">id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="AddIndependentNode__p1886035517444">String</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.3.2.4.1.3 "><p id="AddIndependentNode__p20861655164418">Cluster ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="AddIndependentNode__section19861955184418"><h4 class="sectiontitle">Request Example</h4><p id="AddIndependentNode__p986211551441">Add the master and client nodes.</p>
<pre class="screen" id="AddIndependentNode__screen1886312557444">POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/type/ess-client/independent
{
"type" : {
"flavor_ref" : "d9dc06ae-b9c4-4ef4-acd8-953ef4205e27",
"node_size" : 3,
"volume_type" : "COMMON"
}
}</pre>
</div>
<div class="section" id="AddIndependentNode__section1486812553447"><h4 class="sectiontitle">Response Example</h4><p id="AddIndependentNode__p1086915516447"><strong id="AddIndependentNode__b170731069151753">Status code: 200</strong></p>
<p id="AddIndependentNode__p7869755174419">The request is processed.</p>
<pre class="screen" id="AddIndependentNode__screen15870175510444">{
"id" : "320afa24-ff2a-4f44-8460-6ba95e512ad4"
}</pre>
</div>
<div class="section" id="AddIndependentNode__section1639205611447"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="AddIndependentNode__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="AddIndependentNode__row694495504417"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="AddIndependentNode__p14393195624417">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.8.2.1.3.1.2"><p id="AddIndependentNode__p16393175616442">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="AddIndependentNode__row0944255104415"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="AddIndependentNode__p1939310563446">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="AddIndependentNode__p13394165616449">The request is processed.</p>
</td>
</tr>
<tr id="AddIndependentNode__row794415514412"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="AddIndependentNode__p839495613441">403</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="AddIndependentNode__p13394656164415">The request is rejected. The server has received and understood the request, but refused to respond to it. Modify the request directly and do not attempt to retry it.</p>
</td>
</tr>
<tr id="AddIndependentNode__row69443555443"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="AddIndependentNode__p103941056154418">500</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="AddIndependentNode__p5395165614443">The server can be accessed by the request, but it cannot understand the user's request.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="AddIndependentNode__section939575612448"><h4 class="sectiontitle">Error Codes</h4><p id="AddIndependentNode__p8395656114415">For details, see <a href="css_03_0076.html">Error Code</a>.</p>
</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>