yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
577786a510d927fcd6d0fe92e1852e1e00bec243
doc-exports/docs/css/api-ref/CreateCluster.html
zhengxiu 8f6b8d3664 css api 25.6.0 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: zhengxiu <zhengxiu@huawei.com>
Co-committed-by: zhengxiu <zhengxiu@huawei.com>
2025-11-25 11:21:12 +00:00

939 lines
79 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="CreateCluster"></a><a name="CreateCluster"></a>
<h1 class="topictitle1">Creating a Cluster (Discarded)</h1>
<div id="body1708331107508"><div class="section" id="CreateCluster__section55481727144820"><h4 class="sectiontitle">Function</h4><p id="CreateCluster__p254832754817">This API can only be used to create clusters that contain a single type of nodes. To create clusters that contain multiple types of nodes (ess, ess-cold, ess-client, and ess-master), use the API for <a href="CreateClusterMultiRole.html">Creating a Cluster v2</a>.</p>
</div>
<div class="section" id="CreateCluster__atuogenerate_1"><h4 class="sectiontitle">Calling Method</h4><p id="CreateCluster__p1548152774812">For details, see <a href="css_03_0077.html">Calling APIs</a>.</p>
</div>
<div class="section" id="CreateCluster__atuogenerate_2"><h4 class="sectiontitle">URI</h4><p id="CreateCluster__p1754892711488">POST /v1.0/{project_id}/clusters</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__table5549112724814" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="CreateCluster__row554910272483"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="CreateCluster__p18549122719489">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="CreateCluster__p9549152724812">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="CreateCluster__p354972734819">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="CreateCluster__p1550102710480">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row6549132774812"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="CreateCluster__p1550027104817">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="CreateCluster__p165501727144810">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="CreateCluster__p1255018277488">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="CreateCluster__p165506272488"><strong id="CreateCluster__b1255042704818">Definition</strong>:</p>
<p id="CreateCluster__p155501627164814">Project ID. For details about how to obtain the project ID and name, see <a href="css_03_0071.html">Obtaining the Project ID and Name</a>.</p>
<p id="CreateCluster__p4550142719481"><strong id="CreateCluster__b12550202754816">Constraints</strong>:</p>
<p id="CreateCluster__p11550027164815">N/A</p>
<p id="CreateCluster__p1755022734817"><strong id="CreateCluster__b3550142714487">Value range</strong>:</p>
<p id="CreateCluster__p185501327114811">Project ID of the account.</p>
<p id="CreateCluster__p1550027164820"><strong id="CreateCluster__b175501627184816">Default value</strong>:</p>
<p id="CreateCluster__p8550122784811">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="CreateCluster__section1755012717481"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__request_CreateClusterReq" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request body parameters</caption><thead align="left"><tr id="CreateCluster__row2551112724819"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.1"><p id="CreateCluster__p25512275488">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.2"><p id="CreateCluster__p4551142704817">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.3"><p id="CreateCluster__p755122716484">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.2.5.1.4"><p id="CreateCluster__p14551132714489">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row135511827154812"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="CreateCluster__p1551102716482">cluster</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="CreateCluster__p055132712480">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="CreateCluster__p1755112277480"><a href="#CreateCluster__request_CreateClusterBody">CreateClusterBody</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="CreateCluster__p35511827144818"><strong id="CreateCluster__b105511127104816">Parameter description</strong>:</p>
<p id="CreateCluster__p4552162720483">Cluster object.</p>
<p id="CreateCluster__p4552427154811"><strong id="CreateCluster__b3552132764816">Constraints</strong>:</p>
<p id="CreateCluster__p115529275487">N/A</p>
<p id="CreateCluster__p1455242784816"><strong id="CreateCluster__b19552162711487">Options</strong>:</p>
<p id="CreateCluster__p855232716489">N/A</p>
<p id="CreateCluster__p1055252734816"><strong id="CreateCluster__b125524279482">Default value</strong>:</p>
<p id="CreateCluster__p255219275484">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="CreateCluster__request_CreateClusterBody"></a><a name="request_CreateClusterBody"></a><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__request_CreateClusterBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>CreateClusterBody</caption><thead align="left"><tr id="CreateCluster__row1655342704818"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.5.1.1"><p id="CreateCluster__p2554142714486">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.5.1.2"><p id="CreateCluster__p1755417279486">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.5.1.3"><p id="CreateCluster__p175541327164818">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.3.2.5.1.4"><p id="CreateCluster__p13554132711482">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row155352714818"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p55540278484">instance</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p9554727184820">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p9554132716483"><a href="#CreateCluster__request_CreateClusterInstanceBody">CreateClusterInstanceBody</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p855416278485"><strong id="CreateCluster__b18554102794810">Parameter description</strong>:</p>
<p id="CreateCluster__p11554172704812">Array of Buffer instances, whose memory is to be shared.</p>
<p id="CreateCluster__p1455442716480"><strong id="CreateCluster__b125543272485">Constraints</strong>:</p>
<p id="CreateCluster__p13554192744811">N/A</p>
<p id="CreateCluster__p055482714481"><strong id="CreateCluster__b1755472724819">Options</strong>:</p>
<p id="CreateCluster__p85541027174815">N/A</p>
<p id="CreateCluster__p135548278480"><strong id="CreateCluster__b13554202717485">Default value</strong>:</p>
<p id="CreateCluster__p455452716480">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row12553727184812"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p1855492774813">datastore</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p355472717489">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p155502754819"><a href="#CreateCluster__request_CreateClusterDatastoreBody">CreateClusterDatastoreBody</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p11555142764816"><strong id="CreateCluster__b16555122716480">Definition</strong>:</p>
<p id="CreateCluster__p20555122784817">Search engine.</p>
<p id="CreateCluster__p1755512716481"><strong id="CreateCluster__b10555132774817">Constraints</strong>:</p>
<p id="CreateCluster__p45551827104816">N/A</p>
<p id="CreateCluster__p1655502712481"><strong id="CreateCluster__b1955502710481">Value range</strong>:</p>
<p id="CreateCluster__p1455542754815">N/A</p>
<p id="CreateCluster__p135551727154814"><strong id="CreateCluster__b05551327134812">Default value</strong>:</p>
<p id="CreateCluster__p11555142712484">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row11553627114814"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p11555172714816">name</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p17555102713488">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p655515279481">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p1555542794817"><strong id="CreateCluster__b6555727174818">Definition</strong>:</p>
<p id="CreateCluster__p17555727194810">Cluster name.</p>
<p id="CreateCluster__p355562754814"><strong id="CreateCluster__b1155552734813">Constraints</strong>:</p>
<p id="CreateCluster__p25551227164814">N/A</p>
<p id="CreateCluster__p15551527164811"><strong id="CreateCluster__b5555427194817">Value range</strong>:</p>
<p id="CreateCluster__p13555162724813">It can contain 4 to 32 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed. The value must start with a letter.</p>
<p id="CreateCluster__p9555192716487"><strong id="CreateCluster__b1855632714813">Default value</strong>:</p>
<p id="CreateCluster__p205567276484">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row9553192744816"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p9556152774815">desc</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p125563279484">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p1255672716484">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p1555692714488"><strong id="CreateCluster__b0556122774812">Definition</strong>:</p>
<p id="CreateCluster__p555615273482">Cluster description.</p>
<p id="CreateCluster__p6556727114819"><strong id="CreateCluster__b11556127124819">Constraints</strong>:</p>
<p id="CreateCluster__p5556227184820">Enter a maximum of 128 characters.</p>
<p id="CreateCluster__p8556927184810"><strong id="CreateCluster__b45569278486">Value range</strong>:</p>
<p id="CreateCluster__p055612714488">The value can contain digits, letters, periods (.), hyphens (-), underscores (_), and other special characters.</p>
<p id="CreateCluster__p255614278483"><strong id="CreateCluster__b3556162712487">Default value</strong>:</p>
<p id="CreateCluster__p1955652704816">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row155319274484"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p5556192734813">instanceNum</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p115561027194812">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p1955662784812">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p95561527104812"><strong id="CreateCluster__b105561727124820">Definition</strong>:</p>
<p id="CreateCluster__p7556102715483">Number of cluster instances.</p>
<p id="CreateCluster__p055672784813"><strong id="CreateCluster__b755632714811">Constraints</strong>:</p>
<p id="CreateCluster__p1955772774819">N/A</p>
<p id="CreateCluster__p655712724811"><strong id="CreateCluster__b5557112710488">Value range</strong>:</p>
<p id="CreateCluster__p1855742718487">1–32.</p>
<p id="CreateCluster__p15571427104816"><strong id="CreateCluster__b355712275486">Default value</strong>:</p>
<p id="CreateCluster__p85571272485">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row1555302715488"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p3557122710485">backupStrategy</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p1555752717482">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p65576279489"><a href="#CreateCluster__request_CreateClusterBackupStrategyBody">CreateClusterBackupStrategyBody</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p7557927174815"><strong id="CreateCluster__b1557127184818">Parameter description</strong>:</p>
<p id="CreateCluster__p175575274486">Automatic snapshot creation policy, which is disabled by default.</p>
<p id="CreateCluster__p1755712716485">The automatic snapshot creation policy is enabled only when <strong id="CreateCluster__b4557122719485">backupStrategy</strong> is not left blank.</p>
<p id="CreateCluster__p1055718271483"><strong id="CreateCluster__b1655742764819">Constraints</strong>:</p>
<p id="CreateCluster__p20557112716489">N/A</p>
<p id="CreateCluster__p2055752719485"><strong id="CreateCluster__b115577271487">Options</strong>:</p>
<p id="CreateCluster__p1955702734812">N/A</p>
<p id="CreateCluster__p05571227184815"><strong id="CreateCluster__b1055715275484">Default value</strong>:</p>
<p id="CreateCluster__p10557182716488">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row155317278482"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p7557172764812">httpsEnable</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p2558727114813">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p855819272481">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p1755816278487"><strong id="CreateCluster__b105581627174815">Definition</strong>:</p>
<p id="CreateCluster__p9558162754812">Whether communication is encrypted on the cluster. The value can be <strong id="CreateCluster__b85581827194814">true</strong> or <strong id="CreateCluster__b555842764814">false</strong>. By default, communication encryption is disabled. When <strong id="CreateCluster__b1355802754811">httpsEnable</strong> is set to <strong id="CreateCluster__b16558427194810">true</strong>, <strong id="CreateCluster__b1755852764816">authorityEnable</strong> must be set to <strong id="CreateCluster__b11558227174818">true</strong>.</p>
<p id="CreateCluster__p16558727174813"><strong id="CreateCluster__b19558202734812">Constraints</strong>:</p>
<p id="CreateCluster__p17558132710489">Only Elasticsearch 6.5.4 security-mode clusters and later support this parameter.</p>
<p id="CreateCluster__p55581427144812">HTTPS access can be disabled only for OpenSearch 1.3.6 and 2.19.0 security-mode clusters. For other versions, HTTPS access is forcibly enabled and cannot be disabled.</p>
<p id="CreateCluster__p9558172713486"><strong id="CreateCluster__b855862714815">Value range</strong>:</p>
<ul id="CreateCluster__ul25581276485"><li id="CreateCluster__li1055842716480"><p id="CreateCluster__p855862719489"><a name="CreateCluster__li1055842716480"></a><a name="li1055842716480"></a><strong id="CreateCluster__b1255842710483">true</strong>: Communication is encrypted on the cluster.</p>
</li><li id="CreateCluster__li16558162774815"><p id="CreateCluster__p355818273483"><a name="CreateCluster__li16558162774815"></a><a name="li16558162774815"></a><strong id="CreateCluster__b0558152716480">false</strong>: Communication is not encrypted for the cluster.</p>
</li></ul>
<p id="CreateCluster__p145581227104814"><strong id="CreateCluster__b655813277484">Default value</strong>:</p>
<p id="CreateCluster__p1355813277483">false</p>
</td>
</tr>
<tr id="CreateCluster__row1455372715486"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p355992794814">authorityEnable</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p1355918277480">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p11559142719484">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p155919278481"><strong id="CreateCluster__b6559122724810">Definition</strong>:</p>
<p id="CreateCluster__p655982710486">Whether to enable authentication. Available values include <strong id="CreateCluster__b12559132734813">true</strong> and <strong id="CreateCluster__b6559727204812">false</strong>. Authentication is disabled by default.</p>
<p id="CreateCluster__p8559162734810"><strong id="CreateCluster__b16559227154814">Constraints</strong>:</p>
<p id="CreateCluster__p1155942704816">Only Elasticsearch 6.5.4 security-mode clusters and later support this parameter.</p>
<p id="CreateCluster__p9559227154812"><strong id="CreateCluster__b95591527124816">Value range</strong>:</p>
<ul id="CreateCluster__ul1855992713484"><li id="CreateCluster__li455920272482"><p id="CreateCluster__p2559112710485"><a name="CreateCluster__li455920272482"></a><a name="li455920272482"></a><strong id="CreateCluster__b6559202774812">true</strong>: Authentication is enabled for the cluster.</p>
</li><li id="CreateCluster__li13559182714485"><p id="CreateCluster__p175591127114814"><a name="CreateCluster__li13559182714485"></a><a name="li13559182714485"></a><strong id="CreateCluster__b4559152713489">false</strong>: Authentication is disabled for the cluster.</p>
</li></ul>
<p id="CreateCluster__p655910275480"><strong id="CreateCluster__b855942794815">Default value</strong>:</p>
<p id="CreateCluster__p11559102711484">false</p>
</td>
</tr>
<tr id="CreateCluster__row175534279482"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p555916274484">adminPwd</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p19559192794811">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p195596275481">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p1956082718481"><strong id="CreateCluster__b156019276483">Parameter description</strong>:</p>
<p id="CreateCluster__p175601427124813">Password of the cluster user <strong id="CreateCluster__b8560162719488">admin</strong> in security mode. This parameter is mandatory only when <strong id="CreateCluster__b125601427144812">authorityEnable</strong> is set to <strong id="CreateCluster__b175601927194812">true</strong>. Weak password verification is required for a security cluster. You are advised to set a strong password.</p>
<p id="CreateCluster__p175602277488"><strong id="CreateCluster__b6560172794815">Constraints</strong>:</p>
<p id="CreateCluster__p125604275481">The administrator password must meet the following requirements:</p>
<ul id="CreateCluster__ul1956072714810"><li id="CreateCluster__li6560627164815"><p id="CreateCluster__p1156082734818"><a name="CreateCluster__li6560627164815"></a><a name="li6560627164815"></a>The password can contain 8 to 32 characters.</p>
</li><li id="CreateCluster__li256012734813"><p id="CreateCluster__p356042718481"><a name="CreateCluster__li256012734813"></a><a name="li256012734813"></a>Passwords must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters ~!@#$%^&amp;*()-_=+\|[{}];:,&lt;.&gt;/?</p>
</li></ul>
<p id="CreateCluster__p5560927194811"><strong id="CreateCluster__b4560102712483">Options</strong>:</p>
<p id="CreateCluster__p1560102734813">See Constraints.</p>
<p id="CreateCluster__p2056012710482"><strong id="CreateCluster__b4560827134811">Default value</strong>:</p>
<p id="CreateCluster__p135601827164814">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row6553627144813"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p1756012719489">enterprise_project_id</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p11560192710484">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p16560122717482">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p1156017277487"><strong id="CreateCluster__b856016278485">Parameter description</strong>:</p>
<p id="CreateCluster__p9560112712488">Enterprise project ID. When creating a cluster, associate the enterprise project ID with the cluster. The value can contain a maximum of 36 characters. It is string <strong id="CreateCluster__b556022717487">0</strong> or in UUID format with hyphens (-). Value 0 indicates the default enterprise project.</p>
<p id="CreateCluster__p1856042711487"><strong id="CreateCluster__b156082794820">Constraints</strong>:</p>
<p id="CreateCluster__p956072711481">N/A</p>
<p id="CreateCluster__p1056116272489"><strong id="CreateCluster__b95618272485">Options</strong>:</p>
<p id="CreateCluster__p356116272484">N/A</p>
<p id="CreateCluster__p8561227134819"><strong id="CreateCluster__b1256114271486">Default value</strong>:</p>
<p id="CreateCluster__p115617278483">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row1355310273487"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p95613277486">tags</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p105611275487">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p25611275486">Array of <a href="#CreateCluster__request_CreateClusterTagsBody">CreateClusterTagsBody</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p3561627164810"><strong id="CreateCluster__b3561102716482">Parameter description</strong>:</p>
<p id="CreateCluster__p10561192744813">Cluster tags.</p>
<p id="CreateCluster__p175611627164810"><strong id="CreateCluster__b1756182713487">Constraints</strong>:</p>
<p id="CreateCluster__p10561162713483">N/A</p>
<p id="CreateCluster__p20561192754814"><strong id="CreateCluster__b956192718486">Options</strong>:</p>
<p id="CreateCluster__p1456192719486">N/A</p>
<p id="CreateCluster__p17561172712485"><strong id="CreateCluster__b155612027184819">Default value</strong>:</p>
<p id="CreateCluster__p105611427104814">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row6553172774810"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="CreateCluster__p17562142744817">ipv6_enable</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="CreateCluster__p11562627154814">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="CreateCluster__p75622278487">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="CreateCluster__p17562202715481"><strong id="CreateCluster__b18562172744818">Definition</strong>:</p>
<p id="CreateCluster__p15621027134819">Whether to enable automatic IPv6 address assignment for the cluster. The default value is false.</p>
<p id="CreateCluster__p4562192716486"><strong id="CreateCluster__b15625273483">Constraints</strong>:</p>
<p id="CreateCluster__p1256292794813">N/A</p>
<p id="CreateCluster__p8562527174818"><strong id="CreateCluster__b556252764813">Value range</strong>:</p>
<p id="CreateCluster__p85628278480">N/A</p>
<p id="CreateCluster__p13562527114816"><strong id="CreateCluster__b2056216272482">Default value</strong>:</p>
<p id="CreateCluster__p05621227114815">false</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="CreateCluster__request_CreateClusterInstanceBody"></a><a name="request_CreateClusterInstanceBody"></a><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__request_CreateClusterInstanceBody" frame="border" border="1" rules="all"><caption><b>Table 4 </b>CreateClusterInstanceBody</caption><thead align="left"><tr id="CreateCluster__row125642027174817"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.4.2.5.1.1"><p id="CreateCluster__p06761127184810">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.4.2.5.1.2"><p id="CreateCluster__p13676102712485">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.4.2.5.1.3"><p id="CreateCluster__p106761427204812">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.4.2.5.1.4"><p id="CreateCluster__p7676627114819">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row7564227104815"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.1 "><p id="CreateCluster__p867672715488">flavorRef</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="CreateCluster__p267682710485">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="CreateCluster__p20676132704817">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.4.2.5.1.4 "><p id="CreateCluster__p196761276484"><strong id="CreateCluster__b20676142764813">Parameter description</strong>:</p>
<p id="CreateCluster__p12676132764818">Instance flavor name. For details about the current instance flavor, see the <strong id="CreateCluster__b1367692720482">name</strong> attribute in <a href="ListFlavors.html">Obtaining the Instance Specifications List</a>.</p>
<p id="CreateCluster__p196761727134819"><strong id="CreateCluster__b1676427194810">Constraints</strong>:</p>
<p id="CreateCluster__p1267632724818">N/A</p>
<p id="CreateCluster__p176761427194810"><strong id="CreateCluster__b12676182784818">Options</strong>:</p>
<p id="CreateCluster__p1676152774811">N/A</p>
<p id="CreateCluster__p8676192711486"><strong id="CreateCluster__b5676142784819">Default value</strong>:</p>
<p id="CreateCluster__p16676112734811">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row195642027204813"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.1 "><p id="CreateCluster__p146761627194816">volume</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="CreateCluster__p467652744815">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="CreateCluster__p66761127154815"><a href="#CreateCluster__request_CreateClusterInstanceVolumeBody">CreateClusterInstanceVolumeBody</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.4.2.5.1.4 "><p id="CreateCluster__p17676927194811"><strong id="CreateCluster__b8676142712481">Parameter description</strong>:</p>
<p id="CreateCluster__p2676227184815">Volume information. You do not need to set this parameter when flavorRef is set to a local disk flavor. Currently, the following local disk flavors are supported:</p>
<ul id="CreateCluster__ul667610276485"><li id="CreateCluster__li767611274483"><p id="CreateCluster__p96761927164812"><a name="CreateCluster__li767611274483"></a><a name="li767611274483"></a>ess.spec-i3small</p>
</li><li id="CreateCluster__li1067692710481"><p id="CreateCluster__p16676122714481"><a name="CreateCluster__li1067692710481"></a><a name="li1067692710481"></a>ess.spec-i3medium</p>
</li><li id="CreateCluster__li1967616270486"><p id="CreateCluster__p1676327104812"><a name="CreateCluster__li1967616270486"></a><a name="li1967616270486"></a>ess.spec-i3.8xlarge.8</p>
</li><li id="CreateCluster__li167614271487"><p id="CreateCluster__p9676152715489"><a name="CreateCluster__li167614271487"></a><a name="li167614271487"></a>ess.spec-ds.xlarge.8</p>
</li><li id="CreateCluster__li136761727174810"><p id="CreateCluster__p667692744820"><a name="CreateCluster__li136761727174810"></a><a name="li136761727174810"></a>ess.spec-ds.2xlarge.8</p>
</li><li id="CreateCluster__li6676142719483"><p id="CreateCluster__p13676122714489"><a name="CreateCluster__li6676142719483"></a><a name="li6676142719483"></a>ess.spec-ds.4xlarge.8</p>
</li></ul>
<p id="CreateCluster__p1367642717483"><strong id="CreateCluster__b14676152714812">Constraints</strong>:</p>
<p id="CreateCluster__p14676152794814">N/A</p>
<p id="CreateCluster__p13676152704818"><strong id="CreateCluster__b9676172724813">Options</strong>:</p>
<p id="CreateCluster__p4676127144819">N/A</p>
<p id="CreateCluster__p15676172764811"><strong id="CreateCluster__b76761427164819">Default value</strong>:</p>
<p id="CreateCluster__p56761027134815">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row456402714480"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.1 "><p id="CreateCluster__p367619275481">nics</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="CreateCluster__p146762027154816">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="CreateCluster__p1367622764817"><a href="#CreateCluster__request_CreateClusterInstanceNicsBody">CreateClusterInstanceNicsBody</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.4.2.5.1.4 "><p id="CreateCluster__p196761827134818"><strong id="CreateCluster__b767612717486">Parameter description</strong>:</p>
<p id="CreateCluster__p167614279489">Subnet information.</p>
<p id="CreateCluster__p12676182716486"><strong id="CreateCluster__b19676427134812">Constraints</strong>:</p>
<p id="CreateCluster__p1867619278481">N/A</p>
<p id="CreateCluster__p1067610272480"><strong id="CreateCluster__b86760275484">Options</strong>:</p>
<p id="CreateCluster__p16676142774813">N/A</p>
<p id="CreateCluster__p46761727124816"><strong id="CreateCluster__b17676227194818">Default value</strong>:</p>
<p id="CreateCluster__p13676182764811">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row85641427124819"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.1 "><p id="CreateCluster__p17676122720482">availability_zone</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="CreateCluster__p13676122713483">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="CreateCluster__p2676112754811">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.4.2.5.1.4 "><p id="CreateCluster__p1467692774819"><strong id="CreateCluster__b19676727104810">Definition</strong>:</p>
<p id="CreateCluster__p106764276487">AZ of the node. The AZ name needs to be specified.</p>
<p id="CreateCluster__p1367618273484"><strong id="CreateCluster__b067662716484">Constraints</strong>:</p>
<p id="CreateCluster__p36766279486">When specifying the AZs of nodes, use commas (,) to separate different AZ names. For example, if multiple AZs are selected for general AZs, the value of availability_zone is region-1a,region-1b,region-1c.</p>
<p id="CreateCluster__p96761527164810"><strong id="CreateCluster__b1967642713481">Value range</strong>:</p>
<p id="CreateCluster__p1676172724813">N/A</p>
<p id="CreateCluster__p12676627154814"><strong id="CreateCluster__b15676102754818">Default value</strong>:</p>
<p id="CreateCluster__p1867612774811">availability_zone is empty by default, indicating that a single AZ is used.</p>
<div class="note" id="CreateCluster__note2677142704815"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="CreateCluster__p13566192713481">If multiple AZs are selected, the name of each AZ must be unique, and the number of nodes must be greater than or equal to the number of AZs.</p>
<p id="CreateCluster__p1677152719485">If the number of nodes is evenly divisible by the number of AZs, the nodes will be evenly distributed among all AZs.</p>
<p id="CreateCluster__p12677327124820">If the number of nodes is not evenly divisible by the number of AZs, the absolute difference between node quantity in any two AZs is 1 at most.</p>
<p id="CreateCluster__p11677192764811">AZ name. Obtain it from <a href="css_03_0001.html">Regions and Endpoints</a> in section "Before You Start".</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="CreateCluster__request_CreateClusterInstanceVolumeBody"></a><a name="request_CreateClusterInstanceVolumeBody"></a><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__request_CreateClusterInstanceVolumeBody" frame="border" border="1" rules="all"><caption><b>Table 5 </b>CreateClusterInstanceVolumeBody</caption><thead align="left"><tr id="CreateCluster__row17566112734810"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.5.1.1"><p id="CreateCluster__p1677827164818">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.5.1.2"><p id="CreateCluster__p1967716279488">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.5.2.5.1.3"><p id="CreateCluster__p26774274484">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.5.2.5.1.4"><p id="CreateCluster__p86774270484">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row1056692744814"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.5.1.1 "><p id="CreateCluster__p16770270483">volume_type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.5.1.2 "><p id="CreateCluster__p767732744812">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.5.1.3 "><p id="CreateCluster__p14677827204816">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.5.2.5.1.4 "><p id="CreateCluster__p46775277489"><strong id="CreateCluster__b1677327104814">Parameter description</strong>:</p>
<p id="CreateCluster__p167762718486">Volume type.</p>
<p id="CreateCluster__p0677627144812"><strong id="CreateCluster__b567752712484">Constraints</strong>:</p>
<p id="CreateCluster__p5677152774818">N/A</p>
<p id="CreateCluster__p15677227194813"><strong id="CreateCluster__b76776272481">Options</strong>:</p>
<ul id="CreateCluster__ul5677152713482"><li id="CreateCluster__li167762764816"><p id="CreateCluster__p96771827174819"><a name="CreateCluster__li167762764816"></a><a name="li167762764816"></a><strong id="CreateCluster__b146771327154810">COMMON</strong>: common I/O</p>
</li><li id="CreateCluster__li10677182744811"><p id="CreateCluster__p6677927124819"><a name="CreateCluster__li10677182744811"></a><a name="li10677182744811"></a><strong id="CreateCluster__b767782744811">HIGH</strong>: high I/O</p>
</li><li id="CreateCluster__li2677127114820"><p id="CreateCluster__p196771227144812"><a name="CreateCluster__li2677127114820"></a><a name="li2677127114820"></a><strong id="CreateCluster__b126771027194810">ULTRAHIGH</strong>: ultra-high I/O</p>
</li><li id="CreateCluster__li1267711271481"><p id="CreateCluster__p1667712714818"><a name="CreateCluster__li1267711271481"></a><a name="li1267711271481"></a><strong id="CreateCluster__b8677162719484">ESSD</strong>: ultra-fast SSD</p>
</li></ul>
<p id="CreateCluster__p19677152710482"><strong id="CreateCluster__b1867717272487">Default value</strong>:</p>
<p id="CreateCluster__p1867711273486">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row1456613273487"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.5.1.1 "><p id="CreateCluster__p3677122764816">size</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.5.1.2 "><p id="CreateCluster__p1867715279485">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.5.2.5.1.3 "><p id="CreateCluster__p4677172714813">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.5.2.5.1.4 "><p id="CreateCluster__p1367762784811"><strong id="CreateCluster__b5677227194818">Definition</strong>:</p>
<p id="CreateCluster__p367715275484">Disk size.</p>
<p id="CreateCluster__p5677102754812"><strong id="CreateCluster__b176771927124811">Constraints</strong>:</p>
<p id="CreateCluster__p2067782714487">The value must be greater than 0 and a common multiple of 4 and 10, in GB.</p>
<p id="CreateCluster__p15677122717488"><strong id="CreateCluster__b8677172734812">Value range</strong>:</p>
<p id="CreateCluster__p146771527184818">You can obtain the disk size from the <strong id="CreateCluster__b467732744813">diskrange</strong> attribute in <a href="ListFlavors.html">Obtaining the Instance Specifications List</a>.</p>
<p id="CreateCluster__p10677827104819"><strong id="CreateCluster__b16771227144814">Default value</strong>:</p>
<ul id="CreateCluster__ul1667717276488"><li id="CreateCluster__li8677112710480"><p id="CreateCluster__p967719275485"><a name="CreateCluster__li8677112710480"></a><a name="li8677112710480"></a>ess and ess-cold nodes: 100 GB or the minimum disk capacity supported by the selected node flavor, whichever is larger.</p>
</li><li id="CreateCluster__li1767732714815"><p id="CreateCluster__p767742754810"><a name="CreateCluster__li1767732714815"></a><a name="li1767732714815"></a>ess-master and ess-client nodes: The default volume size is 40 GB and cannot be changed.</p>
</li></ul>
<div class="note" id="CreateCluster__note1567722715483"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="CreateCluster__p95681227154812">For ess and ess-cold nodes, 100 GB or a larger value is recommended.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="CreateCluster__request_CreateClusterInstanceNicsBody"></a><a name="request_CreateClusterInstanceNicsBody"></a><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__request_CreateClusterInstanceNicsBody" frame="border" border="1" rules="all"><caption><b>Table 6 </b>CreateClusterInstanceNicsBody</caption><thead align="left"><tr id="CreateCluster__row3568152718485"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.6.2.5.1.1"><p id="CreateCluster__p96771127144819">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.6.2.5.1.2"><p id="CreateCluster__p867712711489">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.6.2.5.1.3"><p id="CreateCluster__p167712710482">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.6.2.5.1.4"><p id="CreateCluster__p10677527104817">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row3568102744819"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.6.2.5.1.1 "><p id="CreateCluster__p136777271482">vpcId</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.6.2.5.1.2 "><p id="CreateCluster__p6677172715486">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.6.2.5.1.3 "><p id="CreateCluster__p206771927104819">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.6.2.5.1.4 "><p id="CreateCluster__p067712277486"><strong id="CreateCluster__b067742718486">Parameter description</strong>:</p>
<p id="CreateCluster__p18677827114818">VPC ID, which is used for configuring cluster network.</p>
<p id="CreateCluster__p196777276489"><strong id="CreateCluster__b146774273482">Constraints</strong>:</p>
<p id="CreateCluster__p12677627134811">N/A</p>
<p id="CreateCluster__p126774276482"><strong id="CreateCluster__b1967719271484">Options</strong>:</p>
<p id="CreateCluster__p7677102718484">N/A</p>
<p id="CreateCluster__p1767714276488"><strong id="CreateCluster__b7677027164811">Default value</strong>:</p>
<p id="CreateCluster__p1367722711482">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row125681127194810"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.6.2.5.1.1 "><p id="CreateCluster__p11677202711482">netId</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.6.2.5.1.2 "><p id="CreateCluster__p1067792719484">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.6.2.5.1.3 "><p id="CreateCluster__p186777279484">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.6.2.5.1.4 "><p id="CreateCluster__p1367812710487"><strong id="CreateCluster__b6678162712485">Parameter description</strong>:</p>
<p id="CreateCluster__p167811271488">Subnet ID (network ID).</p>
<p id="CreateCluster__p8678122794815"><strong id="CreateCluster__b106781827164820">Constraints</strong>:</p>
<p id="CreateCluster__p156781227134820">N/A</p>
<p id="CreateCluster__p11678172714484"><strong id="CreateCluster__b14678827164819">Options</strong>:</p>
<p id="CreateCluster__p56783273485">N/A</p>
<p id="CreateCluster__p1067892764812"><strong id="CreateCluster__b0678132716488">Default value</strong>:</p>
<p id="CreateCluster__p767842712483">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row195687271488"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.6.2.5.1.1 "><p id="CreateCluster__p15678112744813">securityGroupId</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.6.2.5.1.2 "><p id="CreateCluster__p1667862784810">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.6.2.5.1.3 "><p id="CreateCluster__p567815278487">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.6.2.5.1.4 "><p id="CreateCluster__p1678122719483"><strong id="CreateCluster__b7678132715485">Parameter description</strong>:</p>
<p id="CreateCluster__p3678727154814">Security group ID</p>
<p id="CreateCluster__p3678192774813"><strong id="CreateCluster__b86782027154812">Constraints</strong>:</p>
<p id="CreateCluster__p1167882794812">N/A</p>
<p id="CreateCluster__p56787274483"><strong id="CreateCluster__b1678427144817">Options</strong>:</p>
<p id="CreateCluster__p5678152712484">N/A</p>
<p id="CreateCluster__p16678327194815"><strong id="CreateCluster__b0678627124812">Default value</strong>:</p>
<p id="CreateCluster__p367817270486">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="CreateCluster__request_CreateClusterDatastoreBody"></a><a name="request_CreateClusterDatastoreBody"></a><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__request_CreateClusterDatastoreBody" frame="border" border="1" rules="all"><caption><b>Table 7 </b>CreateClusterDatastoreBody</caption><thead align="left"><tr id="CreateCluster__row15570182714814"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.5.1.1"><p id="CreateCluster__p067842712485">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.5.1.2"><p id="CreateCluster__p196781427124815">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.7.2.5.1.3"><p id="CreateCluster__p14678727194811">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.7.2.5.1.4"><p id="CreateCluster__p1678202710484">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row757014271483"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.5.1.1 "><p id="CreateCluster__p36781627124815">version</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.5.1.2 "><p id="CreateCluster__p1267892754810">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.5.1.3 "><p id="CreateCluster__p8678132713488">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.7.2.5.1.4 "><p id="CreateCluster__p9678527124819"><strong id="CreateCluster__b1067817271482">Parameter description</strong>:</p>
<p id="CreateCluster__p1067882774813">Elasticsearch/Logstash engine version. For details, see the supported versions in <a href="css_03_0001.html">Before You Start</a>.</p>
<p id="CreateCluster__p1367818275483"><strong id="CreateCluster__b1467814278481">Constraints</strong>:</p>
<p id="CreateCluster__p13678327124818">N/A</p>
<p id="CreateCluster__p3678127194810"><strong id="CreateCluster__b567820271482">Options</strong>:</p>
<p id="CreateCluster__p867802784816">N/A</p>
<p id="CreateCluster__p19678152734812"><strong id="CreateCluster__b2678427104818">Default value</strong>:</p>
<p id="CreateCluster__p16678102794818">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row115701127174813"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.5.1.1 "><p id="CreateCluster__p4678127164820">type</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.5.1.2 "><p id="CreateCluster__p167892784818">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.7.2.5.1.3 "><p id="CreateCluster__p16678227124817">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.7.2.5.1.4 "><p id="CreateCluster__p9678172734813"><strong id="CreateCluster__b1167819273483">Definition</strong>:</p>
<p id="CreateCluster__p10678727154816">Engine type of the cluster to be created.</p>
<p id="CreateCluster__p19678102744810"><strong id="CreateCluster__b6678927194820">Constraints</strong>:</p>
<p id="CreateCluster__p12678227144812">N/A</p>
<p id="CreateCluster__p867872718489"><strong id="CreateCluster__b176787276481">Value range</strong>:</p>
<ul id="CreateCluster__ul767832716487"><li id="CreateCluster__li19678527164813"><p id="CreateCluster__p867882717482"><a name="CreateCluster__li19678527164813"></a><a name="li19678527164813"></a>elasticsearch: Elasticsearch cluster.</p>
</li><li id="CreateCluster__li167862724810"><p id="CreateCluster__p367813275486"><a name="CreateCluster__li167862724810"></a><a name="li167862724810"></a>opensearch: OpenSearch cluster.</p>
</li><li id="CreateCluster__li267832784819"><p id="CreateCluster__p167818271485"><a name="CreateCluster__li267832784819"></a><a name="li267832784819"></a>logstash: Logstash cluster.</p>
</li></ul>
<p id="CreateCluster__p16678102754811"><strong id="CreateCluster__b76787270481">Default value</strong>:</p>
<p id="CreateCluster__p2678427184811">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="CreateCluster__request_CreateClusterBackupStrategyBody"></a><a name="request_CreateClusterBackupStrategyBody"></a><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__request_CreateClusterBackupStrategyBody" frame="border" border="1" rules="all"><caption><b>Table 8 </b>CreateClusterBackupStrategyBody</caption><thead align="left"><tr id="CreateCluster__row85711727114819"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.8.2.5.1.1"><p id="CreateCluster__p2678182718487">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.8.2.5.1.2"><p id="CreateCluster__p9678122717482">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.8.2.5.1.3"><p id="CreateCluster__p1678527184816">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.8.2.5.1.4"><p id="CreateCluster__p1678427154817">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row1357182720488"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="CreateCluster__p1767872794816">period</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="CreateCluster__p18678172710480">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="CreateCluster__p11678427164815">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="CreateCluster__p10678142764814"><strong id="CreateCluster__b5678202714811">Definition</strong>:</p>
<p id="CreateCluster__p867814274484">Time when a snapshot is generated every day.</p>
<p id="CreateCluster__p3678172713486"><strong id="CreateCluster__b7679182717486">Constraints</strong>:</p>
<p id="CreateCluster__p767922719485">N/A</p>
<p id="CreateCluster__p19679327174818"><strong id="CreateCluster__b9679327144811">Value range</strong>:</p>
<p id="CreateCluster__p56791927204817">Snapshots can only be created on the hour. The time format is the time followed by the time zone, specifically, <strong id="CreateCluster__b4679172774812">HH:mm z</strong>. In the format, <strong id="CreateCluster__b166791027104813">HH:mm</strong> refers to the hour time and <strong id="CreateCluster__b4679162711487">z</strong> refers to the time zone. For example, 00:00 GMT+08:00 and 01:00 GMT+08:00.</p>
<p id="CreateCluster__p1367942754819"><strong id="CreateCluster__b136796276487">Default value</strong>:</p>
<p id="CreateCluster__p9679427164811">00:00 GMT+08:00</p>
<div class="note" id="CreateCluster__note10679162714813"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="CreateCluster__p557212724814">When frequency is set to HOUR, you do not need to specify period. By default, snapshot creation starts from the next hour after the settings are successful.</p>
</div></div>
</td>
</tr>
<tr id="CreateCluster__row1957112273482"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="CreateCluster__p26798276485">prefix</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="CreateCluster__p9679427154812">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="CreateCluster__p156796278486">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="CreateCluster__p66791627184811"><strong id="CreateCluster__b1067912794810">Definition</strong>:</p>
<p id="CreateCluster__p267916276487">Prefix of a snapshot that is automatically created, which is manually entered.</p>
<p id="CreateCluster__p106791927124818"><strong id="CreateCluster__b767918277483">Constraints</strong>:</p>
<p id="CreateCluster__p1667922764817">N/A</p>
<p id="CreateCluster__p367992784814"><strong id="CreateCluster__b206791227114819">Value range</strong>:</p>
<p id="CreateCluster__p76791227154817">Enter up to 32 characters and start with a lowercase letter. Lowercase letters, digits, hyphens (-), and underscores (_) are allowed.</p>
<p id="CreateCluster__p967962715481"><strong id="CreateCluster__b19679102784815">Default value</strong>:</p>
<p id="CreateCluster__p196796271483">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row12571227164820"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="CreateCluster__p3679202710486">keepday</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="CreateCluster__p1467912713486">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="CreateCluster__p1567915271488">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="CreateCluster__p1679527154814"><strong id="CreateCluster__b467992774813">Definition</strong>:</p>
<p id="CreateCluster__p8679182711482">Set the number of snapshots to be retained. Expired snapshots will be automatically deleted on the half hour. The deletion policy applies only to automated snapshots that are executed at the same frequency as the current automatic snapshot creation policy.</p>
<p id="CreateCluster__p13679427114815"><strong id="CreateCluster__b76793276484">Constraints</strong>:</p>
<p id="CreateCluster__p667942794810">N/A</p>
<p id="CreateCluster__p136798273482"><strong id="CreateCluster__b1567913274484">Value range</strong>:</p>
<p id="CreateCluster__p267932774812">1–90</p>
<p id="CreateCluster__p156792278484"><strong id="CreateCluster__b13679132719482">Default value</strong>:</p>
<p id="CreateCluster__p16679102714486">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row257282713484"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="CreateCluster__p19679027184814">bucket</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="CreateCluster__p3679192712483">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="CreateCluster__p12679142794815">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="CreateCluster__p15679127124812"><strong id="CreateCluster__b1267942720482">Parameter description</strong>:</p>
<p id="CreateCluster__p17679142784819">Name of the OBS bucket used for backup.</p>
<p id="CreateCluster__p196791527134810"><strong id="CreateCluster__b11679182719480">Constraints</strong>:</p>
<p id="CreateCluster__p1067914274483">N/A</p>
<p id="CreateCluster__p10679027194814"><strong id="CreateCluster__b26791827204815">Options</strong>:</p>
<p id="CreateCluster__p967992710486">N/A</p>
<p id="CreateCluster__p3679927194817"><strong id="CreateCluster__b1267982794817">Default value</strong>:</p>
<p id="CreateCluster__p46791527194819">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row165721927134810"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="CreateCluster__p1867902774812">basePath</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="CreateCluster__p17679182716482">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="CreateCluster__p1967942717488">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="CreateCluster__p14679162710484"><strong id="CreateCluster__b126791427174819">Parameter description</strong>:</p>
<p id="CreateCluster__p116792276489">Storage path of the snapshot in the OBS bucket.</p>
<p id="CreateCluster__p367916271486"><strong id="CreateCluster__b5679182724820">Constraints</strong>:</p>
<p id="CreateCluster__p967912715488">N/A</p>
<p id="CreateCluster__p1567910274482"><strong id="CreateCluster__b267932764817">Options</strong>:</p>
<p id="CreateCluster__p1467982784820">N/A</p>
<p id="CreateCluster__p1767915277489"><strong id="CreateCluster__b2679162712487">Default value</strong>:</p>
<p id="CreateCluster__p1467917275482">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row457252774812"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="CreateCluster__p2679192710481">agency</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="CreateCluster__p1967902724810">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="CreateCluster__p12679627134818">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="CreateCluster__p26793276482"><strong id="CreateCluster__b12679132794816">Definition</strong>:</p>
<p id="CreateCluster__p186797271482">Agency name. You can create an agency to allow CSS to call other cloud services. An agency name cannot contain special characters or Chinese characters.</p>
<p id="CreateCluster__p2067952719486"><strong id="CreateCluster__b06791827114815">Constraints</strong>:</p>
<p id="CreateCluster__p4679202744812">N/A</p>
<p id="CreateCluster__p66791427194818"><strong id="CreateCluster__b12679112710484">Value range</strong>:</p>
<p id="CreateCluster__p12679102774819">Only a-z, A-Z, 0-9, hyphens (-) and underscores (_) are allowed.</p>
<p id="CreateCluster__p8679727104816"><strong id="CreateCluster__b7679162714812">Default value</strong>:</p>
<p id="CreateCluster__p12679142714486">N/A</p>
<div class="note" id="CreateCluster__note14679202764815"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="CreateCluster__p155747273488">If none of the bucket, basePath, and agency parameters are specified, the system will automatically create an OBS bucket and an IAM agency. If the creation fails, you need to manually configure correct parameters.</p>
</div></div>
</td>
</tr>
<tr id="CreateCluster__row1757212272487"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="CreateCluster__p167952713488">frequency</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="CreateCluster__p15679927114814">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="CreateCluster__p11679172764811">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="CreateCluster__p166805279489"><strong id="CreateCluster__b5680527144817">Definition</strong>:</p>
<p id="CreateCluster__p2680927144812">Frequency of automatically creating snapshots.</p>
<p id="CreateCluster__p86801727174819"><strong id="CreateCluster__b18680227174813">Constraints</strong>:</p>
<p id="CreateCluster__p36804274485">N/A</p>
<p id="CreateCluster__p17680927154816"><strong id="CreateCluster__b1068022794811">Value range</strong>:</p>
<ul id="CreateCluster__ul768042714815"><li id="CreateCluster__li20680102713483"><p id="CreateCluster__p1568062714817"><a name="CreateCluster__li20680102713483"></a><a name="li20680102713483"></a>HOUR: Execute once every hour on the hour.</p>
</li><li id="CreateCluster__li3680127164810"><p id="CreateCluster__p2680327164810"><a name="CreateCluster__li3680127164810"></a><a name="li3680127164810"></a>DAY: Execute once every day.</p>
</li><li id="CreateCluster__li1868012716482"><p id="CreateCluster__p86802275487"><a name="CreateCluster__li1868012716482"></a><a name="li1868012716482"></a>SUN, MON, TUE, WED, THU, FRI, and SAT: Execute the task at the specified day of every week. For example, SUN indicates that the task is executed once every Sunday.</p>
</li><li id="CreateCluster__li10680327204813"><p id="CreateCluster__p6680627104818"><a name="CreateCluster__li10680327204813"></a><a name="li10680327204813"></a>The number of retained snapshots depends on the execution frequency and indexes set in the automatic snapshot creation policy. If the execution interval is short or the index data volume is large, the number of retained automatic snapshots may not reach the preset value. Set this value based on actual conditions.</p>
</li></ul>
<p id="CreateCluster__p4680152717485"><strong id="CreateCluster__b1168082719484">Default value</strong>:</p>
<p id="CreateCluster__p3680827124810">DAY</p>
</td>
</tr>
<tr id="CreateCluster__row857215278486"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="CreateCluster__p1268072704811">maxSnapshotBytesPerSeconds</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="CreateCluster__p176801027154819">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="CreateCluster__p1768032784819">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="CreateCluster__p66801827164815"><strong id="CreateCluster__b1268011271484">Definition</strong>:</p>
<p id="CreateCluster__p19680162724815">This parameter sets the maximum backup speed per node (bytes per second). When it is exceeded, flow control is triggered to prevent excessive resource usage and ensure system stability. The actual backup speed may not reach the configured value, as it depends on many factors, such as OBS performance and disk I/O.</p>
<p id="CreateCluster__p206801427124816"><strong id="CreateCluster__b66801727134820">Constraints</strong>:</p>
<p id="CreateCluster__p156803271484">N/A</p>
<p id="CreateCluster__p13680427174816"><strong id="CreateCluster__b106806279484">Value range</strong>:</p>
<p id="CreateCluster__p068022784819">The following values and formats are allowed:</p>
<ul id="CreateCluster__ul768015275480"><li id="CreateCluster__li9680727194814"><p id="CreateCluster__p36801527194814"><a name="CreateCluster__li9680727194814"></a><a name="li9680727194814"></a>Number + Unit</p>
</li></ul>
<p id="CreateCluster__p156801027194819">The number ranges from 0 to 9999.</p>
<p id="CreateCluster__p1668012784817">The unit can be k, kb, m, mb, g, gb, t, tb, p, pb, or b (case-insensitive).</p>
<p id="CreateCluster__p11680192718486"><strong id="CreateCluster__b868072713483">0mb</strong> means there is no speed limit. An overly high backup speed may lead to excessive resource usage, which may impact system stability. Therefore, set this parameter carefully.</p>
<ul id="CreateCluster__ul1668013273487"><li id="CreateCluster__li968013278480"><p id="CreateCluster__p176801027124818"><a name="CreateCluster__li968013278480"></a><a name="li968013278480"></a>0</p>
</li></ul>
<p id="CreateCluster__p8680192715482">There is no speed limit. An overly high backup speed may lead to excessive resource usage, which may impact system stability. Therefore, set this parameter carefully.</p>
<ul id="CreateCluster__ul1868012744819"><li id="CreateCluster__li46801827144816"><p id="CreateCluster__p14680427174816"><a name="CreateCluster__li46801827144816"></a><a name="li46801827144816"></a>-1</p>
</li></ul>
<p id="CreateCluster__p1368052712481">There is no speed limit. An overly high backup speed may lead to excessive resource usage, which may impact system stability. Therefore, set this parameter carefully.</p>
<p id="CreateCluster__p12680527104810"><strong id="CreateCluster__b9680142714485">Default value</strong>:</p>
<p id="CreateCluster__p06809278482">The default value is 40 MB. If this parameter is left blank, the default value is used.</p>
</td>
</tr>
<tr id="CreateCluster__row85720274485"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="CreateCluster__p106801827114811">maxRestoreBytesPerSeconds</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="CreateCluster__p1768002714487">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="CreateCluster__p468014275484">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="CreateCluster__p7680172794819"><strong id="CreateCluster__b4680152744812">Definition</strong>:</p>
<p id="CreateCluster__p9680112712489">This parameter sets the maximum recovery speed per node (bytes per second). When it is exceeded, flow control is triggered to prevent excessive resource usage and ensure system stability. The actual recovery speed may not reach the configured value, as it depends on many factors, such as OBS performance and disk I/O.</p>
<p id="CreateCluster__p46801027184811"><strong id="CreateCluster__b56801027184816">Constraints</strong>:</p>
<p id="CreateCluster__p7680727164814">For OpenSearch clusters and Elasticsearch clusters later than 7.6.2, the recovery speed is also limited by the indices.recovery.max_bytes_per_sec parameter. If Maximum recovery speed (per second) is lower than indices.recovery.max_bytes_per_sec, flow control is triggered when the former is reached. If Maximum recovery speed (per second) is higher than indices.recovery.max_bytes_per_sec, flow control is triggered when the latter is reached.</p>
<p id="CreateCluster__p76802279483"><strong id="CreateCluster__b5680122794819">Value range</strong>:</p>
<p id="CreateCluster__p7680127164812">The following values and formats are allowed:</p>
<ul id="CreateCluster__ul968012713484"><li id="CreateCluster__li14680162724816"><p id="CreateCluster__p126800279484"><a name="CreateCluster__li14680162724816"></a><a name="li14680162724816"></a>Number + Unit</p>
</li></ul>
<p id="CreateCluster__p26801227144814">The number ranges from 0 to 9999.</p>
<p id="CreateCluster__p16801527144810">The unit can be k, kb, m, mb, g, gb, t, tb, p, pb, or b (case-insensitive).</p>
<p id="CreateCluster__p1768012719489"><strong id="CreateCluster__b16680102713485">0mb</strong> means there is no speed limit. (However, for OpenSearch clusters and Elasticsearch clusters later than 7.6.2, the recovery speed is also limited by the indices.recovery.max_bytes_per_sec parameter.) An overly high recovery speed may lead to excessive resource usage, which may impact system stability. Therefore, set this parameter carefully.</p>
<ul id="CreateCluster__ul19680132715481"><li id="CreateCluster__li17680172717486"><p id="CreateCluster__p668012276488"><a name="CreateCluster__li17680172717486"></a><a name="li17680172717486"></a>0</p>
</li></ul>
<p id="CreateCluster__p16801827204818">There is no speed limit. (However, for OpenSearch clusters and Elasticsearch clusters later than 7.6.2, the recovery speed is also limited by the indices.recovery.max_bytes_per_sec parameter.) An overly high recovery speed may lead to excessive resource usage, which may impact system stability. Therefore, set this parameter carefully.</p>
<ul id="CreateCluster__ul068012710486"><li id="CreateCluster__li5680202711482"><p id="CreateCluster__p068019273485"><a name="CreateCluster__li5680202711482"></a><a name="li5680202711482"></a>-1</p>
</li></ul>
<p id="CreateCluster__p18680112714480">There is no speed limit. (However, for OpenSearch clusters and Elasticsearch clusters later than 7.6.2, the recovery speed is also limited by the indices.recovery.max_bytes_per_sec parameter.) An overly high recovery speed may lead to excessive resource usage, which may impact system stability. Therefore, set this parameter carefully.</p>
<p id="CreateCluster__p96801027154814"><strong id="CreateCluster__b20681172719487">Default value</strong>:</p>
<p id="CreateCluster__p17681102715488">For Elasticsearch clusters of 7.6.2 or earlier, the default setting is <strong id="CreateCluster__b66811327114811">40mb</strong>.</p>
<p id="CreateCluster__p3681102774817">For OpenSearch clusters and Elasticsearch clusters later than 7.6.2, the default setting is no limit, but the recovery speed is still limited by the indices.recovery.max_bytes_per_sec parameter.</p>
<p id="CreateCluster__p16681122744814">If this parameter is left blank, the default setting is used.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="CreateCluster__request_CreateClusterTagsBody"></a><a name="request_CreateClusterTagsBody"></a><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__request_CreateClusterTagsBody" frame="border" border="1" rules="all"><caption><b>Table 9 </b>CreateClusterTagsBody</caption><thead align="left"><tr id="CreateCluster__row1757672724812"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.5.1.1"><p id="CreateCluster__p14681427124814">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.5.1.2"><p id="CreateCluster__p1868142744815">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.5.1.3"><p id="CreateCluster__p1668152764817">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.9.2.5.1.4"><p id="CreateCluster__p166811027154815">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row25762027144816"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.5.1.1 "><p id="CreateCluster__p168152794812">key</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.5.1.2 "><p id="CreateCluster__p13681132716486">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.5.1.3 "><p id="CreateCluster__p186811527184814">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.9.2.5.1.4 "><p id="CreateCluster__p8681227114811"><strong id="CreateCluster__b176815271486">Definition</strong>:</p>
<p id="CreateCluster__p20681727184819">Tag key.</p>
<p id="CreateCluster__p5681327114812"><strong id="CreateCluster__b176818273482">Constraints</strong>:</p>
<p id="CreateCluster__p96812279485">N/A</p>
<p id="CreateCluster__p4681142711489"><strong id="CreateCluster__b96811627174813">Value range</strong>:</p>
<p id="CreateCluster__p7681227174812">The value can contain 1 to 36 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed.</p>
<p id="CreateCluster__p18681927144815"><strong id="CreateCluster__b106819273487">Default value</strong>:</p>
<p id="CreateCluster__p1768172712485">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row1657642774815"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.5.1.1 "><p id="CreateCluster__p368182764819">value</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.5.1.2 "><p id="CreateCluster__p268118279487">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.5.1.3 "><p id="CreateCluster__p1768112719484">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.9.2.5.1.4 "><p id="CreateCluster__p168192710482"><strong id="CreateCluster__b17681152713481">Definition</strong>:</p>
<p id="CreateCluster__p1868152710487">Tag value.</p>
<p id="CreateCluster__p5681152764816"><strong id="CreateCluster__b16811227154819">Constraints</strong>:</p>
<p id="CreateCluster__p6681627134817">N/A</p>
<p id="CreateCluster__p66815271489"><strong id="CreateCluster__b1681827164811">Value range</strong>:</p>
<ul id="CreateCluster__ul1768142718483"><li id="CreateCluster__li19681122714811"><p id="CreateCluster__p768142710487"><a name="CreateCluster__li19681122714811"></a><a name="li19681122714811"></a>Length: 0 to 255 characters.</p>
</li><li id="CreateCluster__li19681152719484"><p id="CreateCluster__p176811927114819"><a name="CreateCluster__li19681152719484"></a><a name="li19681152719484"></a>The value can contain UTF-8 letters, digits, spaces, and special characters _.://=+-@</p>
</li></ul>
<p id="CreateCluster__p1368162734811"><strong id="CreateCluster__b12681172710489">Default value</strong>:</p>
<p id="CreateCluster__p568162784811">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="CreateCluster__section468242744811"><h4 class="sectiontitle">Response Parameters</h4><p id="CreateCluster__p468292714486"><strong id="CreateCluster__b13682172774812">Status code: 200</strong></p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__response_CreateClusterResponseBody" frame="border" border="1" rules="all"><caption><b>Table 10 </b>Response body parameters</caption><thead align="left"><tr id="CreateCluster__row15580182784819"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.5.3.2.4.1.1"><p id="CreateCluster__p16683112719486">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.5.3.2.4.1.2"><p id="CreateCluster__p368352734810">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.3.2.4.1.3"><p id="CreateCluster__p268312710483">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row45808270484"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.1 "><p id="CreateCluster__p7683192714818">cluster</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.3.2.4.1.2 "><p id="CreateCluster__p668332712486"><a href="#CreateCluster__response_CreateClusterClusterResponse">CreateClusterClusterResponse</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.3.2.4.1.3 "><p id="CreateCluster__p768382716488"><strong id="CreateCluster__b56831827164810">Parameter description</strong>:</p>
<p id="CreateCluster__p14683327164819">Cluster object. For a pay-per-use cluster, only the <strong id="CreateCluster__b1968315275482">cluster</strong> parameter is returned.</p>
<p id="CreateCluster__p146831275484"><strong id="CreateCluster__b166831275484">Options</strong>:</p>
<p id="CreateCluster__p86831127114810">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="CreateCluster__response_CreateClusterClusterResponse"></a><a name="response_CreateClusterClusterResponse"></a><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__response_CreateClusterClusterResponse" frame="border" border="1" rules="all"><caption><b>Table 11 </b>CreateClusterClusterResponse</caption><thead align="left"><tr id="CreateCluster__row1958115274484"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.5.4.2.4.1.1"><p id="CreateCluster__p1368302794819">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.5.4.2.4.1.2"><p id="CreateCluster__p1968352720481">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.5.4.2.4.1.3"><p id="CreateCluster__p136831527204810">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row2058119275481"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.4.2.4.1.1 "><p id="CreateCluster__p7683162710483">id</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.4.2.4.1.2 "><p id="CreateCluster__p1668362774817">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.4.2.4.1.3 "><p id="CreateCluster__p19683142711485"><strong id="CreateCluster__b1068315273483">Parameter description</strong>:</p>
<p id="CreateCluster__p5683142712485">Cluster ID.</p>
<p id="CreateCluster__p26833277488"><strong id="CreateCluster__b7683427144817">Options</strong>:</p>
<p id="CreateCluster__p768372744817">N/A</p>
</td>
</tr>
<tr id="CreateCluster__row958112734814"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.4.2.4.1.1 "><p id="CreateCluster__p1668312716483">name</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.5.4.2.4.1.2 "><p id="CreateCluster__p166832278481">String</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.5.4.2.4.1.3 "><p id="CreateCluster__p068342794819"><strong id="CreateCluster__b11683192718489">Parameter description</strong>:</p>
<p id="CreateCluster__p146831827144814">Cluster name.</p>
<p id="CreateCluster__p11683172715489"><strong id="CreateCluster__b568318279486">Options</strong>:</p>
<p id="CreateCluster__p1683162717485">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="CreateCluster__section16831127184815"><h4 class="sectiontitle">Example Requests</h4><ul id="CreateCluster__ul968352712484"><li id="CreateCluster__li5684132754819"><p id="CreateCluster__p86841527114818"><a name="CreateCluster__li5684132754819"></a><a name="li5684132754819"></a>Example request for creating a pay-per-use cluster.</p>
<pre class="screen" id="CreateCluster__screen26841327144814">POST https://{Endpoint}/v1.0/{project_id}/clusters
{
"cluster" : {
"instance" : {
"flavorRef" : "ess.spec-4u16g",
"volume" : {
"volume_type" : "COMMON",
"size" : 120
},
"nics" : {
"vpcId" : "{VPC ID}",
"netId" : "{NET ID}",
"securityGroupId" : "{Security group ID}"
},
"availability_zone" : "{AZ CODE}"
},
"datastore" : {
"version" : "{cluster-version}",
"type" : "elasticsearch"
},
"name" : "cluster-name",
"desc" : "Cluster testing",
"instanceNum" : 3,
"backupStrategy" : {
"period" : "16:00 GMT+08:00",
"prefix" : "snapshot",
"keepday" : 7,
"frequency" : "DAY",
"bucket" : "css-obs-backup",
"basePath" : "css_repository/obs-path",
"agency" : "css_obs_agency",
"maxSnapshotBytesPerSeconds" : 40,
"maxRestoreBytesPerSeconds" : 40
},
"httpsEnable" : true,
"authorityEnable" : true,
"adminPwd" : "{password}",
"enterprise_project_id" : "0",
"tags" : [ {
"key" : "k1",
"value" : "v1"
}, {
"key" : "k2",
"value" : "v2"
} ]
}
}</pre>
</li></ul>
</div>
<div class="section" id="CreateCluster__section1768420276482"><h4 class="sectiontitle">Example Responses</h4><p id="CreateCluster__p1568414271484"><strong id="CreateCluster__b668452764816">Status code: 200</strong></p>
<p id="CreateCluster__p1468416273485">Request succeeded.</p>
<ul id="CreateCluster__ul26841827104810"><li id="CreateCluster__li13684132784811"><p id="CreateCluster__p10684827194814"><a name="CreateCluster__li13684132784811"></a><a name="li13684132784811"></a>Example response for creating a pay-per-use cluster.</p>
<pre class="screen" id="CreateCluster__screen10684172716483">{
"cluster" : {
"id" : "ef683016-871e-48bc-bf93-74a29d60d214",
"name" : "ES-Test"
}
}</pre>
</li></ul>
</div>
<div class="section" id="CreateCluster__section18689152724819"><h4 class="sectiontitle">Status Codes</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="CreateCluster__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="CreateCluster__row5600152715486"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="CreateCluster__p56891127144819">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.8.2.1.3.1.2"><p id="CreateCluster__p9689142794816">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="CreateCluster__row3600127144814"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="CreateCluster__p186891527204812">200</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="CreateCluster__p156899275486">Request succeeded.</p>
</td>
</tr>
<tr id="CreateCluster__row13600102754819"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="CreateCluster__p968962784811">400</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="CreateCluster__p106891227124815">Invalid request.</p>
<p id="CreateCluster__p146898271482">Modify the request before retry.</p>
</td>
</tr>
<tr id="CreateCluster__row1060072774817"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="CreateCluster__p76891627124814">409</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="CreateCluster__p1068962784814">The request could not be completed due to a conflict with the current state of the resource.</p>
<p id="CreateCluster__p5689827194820">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="CreateCluster__row1260062764812"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="CreateCluster__p1689102716489">412</p>
</td>
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="CreateCluster__p76892277488">The server did not meet one of the preconditions contained in the request.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="CreateCluster__section16689122712484"><h4 class="sectiontitle">Error Codes</h4><p id="CreateCluster__p76891927134819">See <a href="css_03_0076.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="cluster_management.html">Cluster Management</a></div>
</div>
</div>
View Git Blame Copy Permalink