forked from docs/doc-exports
qiujiandong1
52a58dcf06
Reviewed-by: Gergo-Bence Lorincz <a200452876@noreply.gitea.eco.tsi-dev.otc-service.com> Co-authored-by: qiujiandong1 <qiujiandong1@huawei.com> Co-committed-by: qiujiandong1 <qiujiandong1@huawei.com>
1751 lines
152 KiB
HTML
1751 lines
152 KiB
HTML
<a name="cce_02_0236"></a><a name="cce_02_0236"></a>
|
|
|
|
<h1 class="topictitle1">Creating a Cluster</h1>
|
|
<div id="body1521448221833"><div class="section" id="cce_02_0236__section1686113493165"><h4 class="sectiontitle">Function</h4><p id="cce_02_0236__p209621357141610">This API is used to create an empty cluster, which has only master nodes but do not have worker nodes. After creating a cluster by calling this API, you can add nodes to the cluster. For details, see <a href="cce_02_0242.html">Creating a Node</a>.</p>
|
|
<div class="note" id="cce_02_0236__note815071332616"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="cce_02_0236__ul26375174388"><li id="cce_02_0236__li1925810430318">The URL for cluster management is in the format of <strong id="cce_02_0236__b106584372044">https://Endpoint/uri</strong>. In the URL, <strong id="cce_02_0236__b1930014451045">uri</strong> indicates the resource path, that is, the path for API access.</li><li id="cce_02_0236__li874262254119">Before creating a cluster, <a href="cce_02_0100.html">Creating a VPC and Subnet</a>. If a VPC and subnet already exists, you do not need to create them again.</li><li id="cce_02_0236__li14749112218415">By default, an account can create a maximum of five clusters in each region.</li><li id="cce_02_0236__li0486122532513">By default, ICAgent is not installed when you call this API to create a cluster. If you need to install ICAgent, add "cluster.install.addons.external/install":"[{"addonTemplateName":"icagent"}]" to <strong id="cce_02_0236__b1275386202410">annotations</strong> in the request body. ICAgent will be automatically installed during cluster creation. ICAgent is an O&M data collection agent used by Application Performance Management (APM). It runs on each server to collect data from probes in real time. ICAgent is the prerequisite for achieving application O&M. If ICAgent is not installed, the application O&M functions cannot be used.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="cce_02_0236__section8403243161416"><h4 class="sectiontitle">URI</h4><p id="cce_02_0236__p23575517439">POST /api/v3/projects/{project_id}/clusters</p>
|
|
<p id="cce_02_0236__p2037362514220"><a href="#cce_02_0236__table2027961241820">Table 1</a> describes the parameters of this API.</p>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table2027961241820"></a><a name="table2027961241820"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table2027961241820" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="cce_02_0236__row122809120186"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.4.2.4.1.1"><p id="cce_02_0236__p91421758131813">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="12%" id="mcps1.3.2.4.2.4.1.2"><p id="cce_02_0236__p101421758131816">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="68%" id="mcps1.3.2.4.2.4.1.3"><p id="cce_02_0236__p19143115818187">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row32801312121810"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.4.2.4.1.1 "><p id="cce_02_0236__p1714415589184">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.2.4.2.4.1.2 "><p id="cce_02_0236__p814518580186">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.2.4.2.4.1.3 "><p id="cce_02_0236__p1320413331216">Project ID. For details about how to obtain the project ID, see <a href="cce_02_0271.html">How to Obtain Parameters in the API URI</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="cce_02_0236__section947084713911"><h4 class="sectiontitle">Request</h4><p id="cce_02_0236__p18314816203655"><strong id="cce_02_0236__b30615622203655">Request parameters</strong>:</p>
|
|
<p id="cce_02_0236__p7105145203655"><a href="#cce_02_0236__table165001054142614">Table 2</a> and <a href="#cce_02_0236__table34052983203655">Table 3</a> describe the request parameters.</p>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table165001054142614"></a><a name="table165001054142614"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table165001054142614" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the request header</caption><thead align="left"><tr id="cce_02_0236__row55001954122614"><th align="left" class="cellrowborder" valign="top" width="18.5%" id="mcps1.3.3.4.2.5.1.1"><p id="cce_02_0236__p115009545264">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="14.249999999999998%" id="mcps1.3.3.4.2.5.1.2"><p id="cce_02_0236__p175001547265">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="10.84%" id="mcps1.3.3.4.2.5.1.3"><p id="cce_02_0236__p922311541187">String</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.410000000000004%" id="mcps1.3.3.4.2.5.1.4"><p id="cce_02_0236__p16500154162611">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row199801811203412"><td class="cellrowborder" valign="top" width="18.5%" headers="mcps1.3.3.4.2.5.1.1 "><p id="cce_02_0236__p69808112344">Content-Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.249999999999998%" headers="mcps1.3.3.4.2.5.1.2 "><p id="cce_02_0236__p3980111103414">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10.84%" headers="mcps1.3.3.4.2.5.1.3 "><p id="cce_02_0236__p133849541818">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.410000000000004%" headers="mcps1.3.3.4.2.5.1.4 "><p id="cce_02_0236__p169801011203416">Message body type (format).</p>
|
|
<p id="cce_02_0236__p1788220373510">Default: <strong id="cce_02_0236__b124918415616">application/json</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row3500125412260"><td class="cellrowborder" valign="top" width="18.5%" headers="mcps1.3.3.4.2.5.1.1 "><p id="cce_02_0236__p105001654202618">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.249999999999998%" headers="mcps1.3.3.4.2.5.1.2 "><p id="cce_02_0236__p20500954182618">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10.84%" headers="mcps1.3.3.4.2.5.1.3 "><p id="cce_02_0236__p85221454684">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.410000000000004%" headers="mcps1.3.3.4.2.5.1.4 "><p id="cce_02_0236__p18824197845">Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details on how to obtain a user token, see <a href="cce_02_0004.html">API Usage Guidelines</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table34052983203655"></a><a name="table34052983203655"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table34052983203655" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameters in the request body</caption><thead align="left"><tr id="cce_02_0236__row30254333203655"><th align="left" class="cellrowborder" valign="top" width="20.202020202020204%" id="mcps1.3.3.5.2.5.1.1"><p id="cce_02_0236__p34681881203655">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.131313131313133%" id="mcps1.3.3.5.2.5.1.2"><p id="cce_02_0236__p333122111014">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.181818181818183%" id="mcps1.3.3.5.2.5.1.3"><p id="cce_02_0236__p57769002203655">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="48.484848484848484%" id="mcps1.3.3.5.2.5.1.4"><p id="cce_02_0236__p58673482203655">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row54931625203655"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.5.2.5.1.1 "><p id="cce_02_0236__p44731858185518">kind</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.131313131313133%" headers="mcps1.3.3.5.2.5.1.2 "><p id="cce_02_0236__p20715132635516">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.3.5.2.5.1.3 "><p id="cce_02_0236__p57145269553">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.3.5.2.5.1.4 "><p id="cce_02_0236__p12712326175517">API type. For a cluster management API, the parameter must be set to <strong id="cce_02_0236__b8304143918315">Cluster</strong> and cannot be changed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row15234185203655"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.5.2.5.1.1 "><p id="cce_02_0236__p144741580551">apiVersion</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.131313131313133%" headers="mcps1.3.3.5.2.5.1.2 "><p id="cce_02_0236__p2709192613559">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.3.5.2.5.1.3 "><p id="cce_02_0236__p6707526185513">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.3.5.2.5.1.4 "><p id="cce_02_0236__p1770492695518">API version. The value is fixed at <strong id="cce_02_0236__b95215361854">v3</strong> and cannot be changed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1122635417553"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.5.2.5.1.1 "><p id="cce_02_0236__p144741558135518">metadata</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.131313131313133%" headers="mcps1.3.3.5.2.5.1.2 "><p id="cce_02_0236__p112261154155517">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.3.5.2.5.1.3 "><p id="cce_02_0236__p16227554165511"><a href="#cce_02_0236__table888212551117">metadata</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.3.5.2.5.1.4 "><p id="cce_02_0236__p102271654195515">Basic information about a cluster. metadata is a collection of attributes.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row9619511127"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.5.2.5.1.1 "><p id="cce_02_0236__p4785161212">spec</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.131313131313133%" headers="mcps1.3.3.5.2.5.1.2 "><p id="cce_02_0236__p97205171219">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.181818181818183%" headers="mcps1.3.3.5.2.5.1.3 "><p id="cce_02_0236__p67105119126"><a href="#cce_02_0236__table1034041612134">spec</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.3.5.2.5.1.4 "><p id="cce_02_0236__p10785112129">Detailed description of the cluster to be created. CCE creates or updates objects by defining or updating its <strong id="cce_02_0236__b537911355713">spec</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table888212551117"></a><a name="table888212551117"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table888212551117" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Data structure of the <strong id="cce_02_0236__b158392181162">metadata</strong> field</caption><thead align="left"><tr id="cce_02_0236__row18888115514119"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.6.2.5.1.1"><p id="cce_02_0236__p11890655514">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.6.2.5.1.2"><p id="cce_02_0236__p289311553114">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.3.6.2.5.1.3"><p id="cce_02_0236__p128941055417">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="49%" id="mcps1.3.3.6.2.5.1.4"><p id="cce_02_0236__p1289615519119">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row1489715551111"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.6.2.5.1.1 "><p id="cce_02_0236__p1289114562017">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.6.2.5.1.2 "><p id="cce_02_0236__p716614322018">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.6.2.5.1.3 "><p id="cce_02_0236__p9195144141410">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.6.2.5.1.4 "><p id="cce_02_0236__p1630772215148">Cluster name.</p>
|
|
<p id="cce_02_0236__p9110173318412">Enter 4 to 128 characters starting with a letter and not ending with a hyphen (-). Only lowercase letters, digits, and hyphens (-) are allowed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1047220313119"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.6.2.5.1.1 "><p id="cce_02_0236__p14111416111114">uid</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.6.2.5.1.2 "><p id="cce_02_0236__p611151631120">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.6.2.5.1.3 "><p id="cce_02_0236__p141111216111120">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.6.2.5.1.4 "><p id="cce_02_0236__p7111141641116">Unique resource ID, which is automatically generated after the resource is created. It cannot be specified.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row6865639152015"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.6.2.5.1.1 "><p id="cce_02_0236__p689194513209">labels</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.6.2.5.1.2 "><p id="cce_02_0236__p1886511394203">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.6.2.5.1.3 "><p id="cce_02_0236__p919624191418">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.6.2.5.1.4 "><p id="cce_02_0236__p04381929142212">Cluster labels in the format of key-value pairs.</p>
|
|
<div class="note" id="cce_02_0236__note644520299222"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p2446132972210">The value of this field is automatically generated by the system and is used by the frontend to identify the features supported by the cluster during the upgrade. The value specified by the user is invalid.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1267164013200"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.6.2.5.1.1 "><p id="cce_02_0236__p889194582016">annotations</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.6.2.5.1.2 "><p id="cce_02_0236__p116764015202">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.6.2.5.1.3 "><p id="cce_02_0236__p15196841191420">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.6.2.5.1.4 "><p id="cce_02_0236__p154337292225">Cluster annotations in the format of key-value pairs.</p>
|
|
<pre class="screen" id="cce_02_0236__screen1643382914222">"annotations": {
|
|
"key1" : "value1",
|
|
"key2" : "value2"
|
|
}</pre>
|
|
<div class="note" id="cce_02_0236__note13435129142210"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="cce_02_0236__ul141782297297"><li id="cce_02_0236__li17713431162912">Annotations are not used to identify or select objects. The metadata in <strong id="cce_02_0236__b1594211265298">annotations</strong> may be small or large, structured or unstructured, and may include characters that are not allowed in labels.</li><li id="cce_02_0236__li6178202912916">This field is not stored in the database and is used only to specify the add-ons to be installed in the cluster.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row201425155366"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.6.2.5.1.1 "><p id="cce_02_0236__p17965185543418">timezone</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.6.2.5.1.2 "><p id="cce_02_0236__p4966145583412">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.6.2.5.1.3 "><p id="cce_02_0236__p681756163419">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.6.2.5.1.4 "><p id="cce_02_0236__p158155663419"><strong id="cce_02_0236__b1181185663415">Details</strong>:</p>
|
|
<p id="cce_02_0236__p88185616346">Cluster time zone</p>
|
|
<p id="cce_02_0236__p1981256203419"><strong id="cce_02_0236__b118113562341">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p281105611342">None</p>
|
|
<p id="cce_02_0236__p148125618348"><strong id="cce_02_0236__b158195663413">Options</strong>:</p>
|
|
<p id="cce_02_0236__p481195653418">N/A</p>
|
|
<p id="cce_02_0236__p581105613415"><strong id="cce_02_0236__b78165683413">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p11811656103411">N/A</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table1034041612134"></a><a name="table1034041612134"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table1034041612134" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Data structure of the <strong id="cce_02_0236__b148704303206">spec</strong> field</caption><thead align="left"><tr id="cce_02_0236__row14348121616132"><th align="left" class="cellrowborder" valign="top" width="20.202020202020204%" id="mcps1.3.3.7.2.5.1.1"><p id="cce_02_0236__p133505167139">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.454545454545455%" id="mcps1.3.3.7.2.5.1.2"><p id="cce_02_0236__p6353201611319">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.03030303030303%" id="mcps1.3.3.7.2.5.1.3"><p id="cce_02_0236__p735501615139">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="48.313131313131315%" id="mcps1.3.3.7.2.5.1.4"><p id="cce_02_0236__p15357151631311">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row845431717814"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p44543171286">category</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p94543171188">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p1445414171086">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><div class="p" id="cce_02_0236__p132572051119">Cluster category:<ul id="cce_02_0236__ul1126620151116"><li id="cce_02_0236__li12642019119">CCE: CCE cluster</li><li id="cce_02_0236__li1226122019112">Turbo: CCE Turbo cluster</li></ul>
|
|
</div>
|
|
<div class="note" id="cce_02_0236__note1173936124019"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p107391263409">This parameter is valid in cluster of v1.17.17 or higher.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row178365271483"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p146521540191916">type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p202632127">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p1052510179227">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p1691385774411">Cluster type.</p>
|
|
<p id="cce_02_0236__p115781428135215"><strong id="cce_02_0236__b122221723185118">VirtualMachine</strong>: The master node architecture is x86.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row111221127144415"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p1612362713448">flavor</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p1112372718448">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p1512392713442">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p16621941104417">Cluster flavor.</p>
|
|
<ul id="cce_02_0236__ul154851748174415"><li id="cce_02_0236__li14485164815445"><strong id="cce_02_0236__b11489836273">cce.s1.small</strong>: small-scale, single-master cluster (≤ 50 nodes)</li><li id="cce_02_0236__li64859483443"><strong id="cce_02_0236__b367910942720">cce.s1.medium</strong>: medium-scale, single-master cluster (≤ 200 nodes)</li><li id="cce_02_0236__li8486648124416"><strong id="cce_02_0236__b1081317262919">cce.s2.small</strong>: small-scale, high availability cluster (≤ 50 nodes)</li><li id="cce_02_0236__li348664814416"><strong id="cce_02_0236__b1689322115296">cce.s2.medium</strong>: medium-scale, high availability cluster (≤ 200 nodes)</li><li id="cce_02_0236__li1848684815442"><strong id="cce_02_0236__b57413316296">cce.s2.large</strong>: large-scale, high availability cluster (≤ 1,000 nodes)</li><li id="cce_02_0236__li15483153111118"><strong id="cce_02_0236__b195451031102014">cce.s2.xlarge</strong>: ultra-large-scale, high availability cluster (≤ 2,000 nodes)</li></ul>
|
|
<div class="note" id="cce_02_0236__note10821115618447"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="cce_02_0236__ul13821356164415"><li id="cce_02_0236__li68211756114414">s1: single-master cluster</li><li id="cce_02_0236__li5821556144419">s2: high availability cluster</li><li id="cce_02_0236__li58221656194414">For example, <strong id="cce_02_0236__b1251010481560">≤ 50 nodes</strong> indicates that the maximum number of nodes that can be managed by the cluster is 50.</li><li id="cce_02_0236__li1882216565446">A single-master cluster has only one master node. If the master node is down, the cluster will become unavailable and stop serving new workloads. However, existing workloads in the cluster are not affected.</li><li id="cce_02_0236__li128221456114412">A high-availability cluster has multiple master nodes. Faults in a single master node will not take the cluster down.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row83711516191317"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p1565217404195">version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p43761516111313">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p252511174227">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p7573017202218"><strong id="cce_02_0236__b457318173220">Details</strong>:</p>
|
|
<p id="cce_02_0236__p20573111752219">Cluster version, which mirrors the baseline version of the Kubernetes community. The latest commercial version is recommended.</p>
|
|
<p id="cce_02_0236__p12573101792220">You can create clusters of the latest three versions on the CCE console. To learn which cluster versions are available, log in to the CCE console, create a cluster, and check the supported cluster versions.</p>
|
|
<p id="cce_02_0236__p857391712229">You can call APIs to create clusters of other versions. However, these cluster versions will be gradually terminated. For details about the support policy, see the CCE announcement.</p>
|
|
<p id="cce_02_0236__p057318174226"><strong id="cce_02_0236__b115731217112217">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p1757311713227">The value must be in the format of <strong id="cce_02_0236__b157391712222">vX.Y[.Z[-rN]]</strong>, for example, <strong id="cce_02_0236__b657371732218">v1.30</strong>, <strong id="cce_02_0236__b115739175225">v1.30.0</strong>, or <strong id="cce_02_0236__b165731217172211">v1.30.0-r0</strong>. Specifying either of these values will create a cluster of version 1.30.</p>
|
|
<ul id="cce_02_0236__ul17573717182212"><li id="cce_02_0236__li205731317192216"><p id="cce_02_0236__p15573151792214"><a name="cce_02_0236__li205731317192216"></a><a name="li205731317192216"></a><strong id="cce_02_0236__b957391712229">X</strong>: major version in the Kubernetes community</p>
|
|
</li><li id="cce_02_0236__li1357331702214"><p id="cce_02_0236__p12573181715227"><a name="cce_02_0236__li1357331702214"></a><a name="li1357331702214"></a><strong id="cce_02_0236__b11573121718224">Y</strong>: minor version in the Kubernetes community</p>
|
|
</li><li id="cce_02_0236__li11573181792213"><p id="cce_02_0236__p157331782211"><a name="cce_02_0236__li11573181792213"></a><a name="li11573181792213"></a><strong id="cce_02_0236__b175731117102216">Z</strong>: patch version in the Kubernetes community</p>
|
|
</li><li id="cce_02_0236__li1757341717221"><p id="cce_02_0236__p1957371717225"><a name="cce_02_0236__li1757341717221"></a><a name="li1757341717221"></a><strong id="cce_02_0236__b857371772218">N</strong>: CCE patch version.</p>
|
|
</li></ul>
|
|
<p id="cce_02_0236__p13573101732213"><strong id="cce_02_0236__b4573517122217">Options</strong>:</p>
|
|
<p id="cce_02_0236__p10573181713224">N/A</p>
|
|
<p id="cce_02_0236__p557301752218"><strong id="cce_02_0236__b1257319178223">Default value</strong>:</p>
|
|
<ul id="cce_02_0236__ul357312171221"><li id="cce_02_0236__li15573101702210"><p id="cce_02_0236__p657313172224"><a name="cce_02_0236__li15573101702210"></a><a name="li15573101702210"></a>If this parameter is left empty, a cluster of the latest version is created by default.</p>
|
|
</li><li id="cce_02_0236__li957312171223"><p id="cce_02_0236__p165731717122215"><a name="cce_02_0236__li957312171223"></a><a name="li957312171223"></a>If a baseline cluster version is specified but the R version is not specified, a cluster of the latest R version will be created by default. It is a good practice not to specify the R version.</p>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row47112883519"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p1884144893515">platformVersion</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p284124873520">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p38411148113510">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p857316175224"><strong id="cce_02_0236__b125737175223">Details</strong>:</p>
|
|
<p id="cce_02_0236__p1057361782211">CCE cluster platform version, which is an internal version under the cluster version (<strong id="cce_02_0236__b175731517122218">version</strong>). Platform versions are used to trace iterations in a major cluster version. They are unique within a major cluster version and recounted when the major cluster version changes.</p>
|
|
<p id="cce_02_0236__p1657311170220"><strong id="cce_02_0236__b20573141712222">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p165735172225">This parameter cannot be customized, and when you create a cluster, the latest corresponding platform version is selected automatically.</p>
|
|
<p id="cce_02_0236__p18573131718224"><strong id="cce_02_0236__b1257310170222">Options</strong>:</p>
|
|
<p id="cce_02_0236__p18573131752216">The format of <strong id="cce_02_0236__b257411702211">platformVersion</strong> is <strong id="cce_02_0236__b20574517132216">cce.X.Y</strong>.</p>
|
|
<ul id="cce_02_0236__ul357414179228"><li id="cce_02_0236__li1257416178223"><p id="cce_02_0236__p5574101713228"><a name="cce_02_0236__li1257416178223"></a><a name="li1257416178223"></a><strong id="cce_02_0236__b11574617102212">X</strong>: internal feature version, which indicates changes in features, patches, or OS support in the cluster version. The value starts from <strong id="cce_02_0236__b19574217192218">1</strong> and increases monotonically.</p>
|
|
</li><li id="cce_02_0236__li6574131714225"><p id="cce_02_0236__p10574131752217"><a name="cce_02_0236__li6574131714225"></a><a name="li6574131714225"></a><strong id="cce_02_0236__b3574101710227">Y</strong>: patch version of an internal feature version. It is used only for software package update after the feature version is released. No other modification is involved. The value starts from <strong id="cce_02_0236__b15574817182211">0</strong> and increases monotonically.</p>
|
|
</li></ul>
|
|
<p id="cce_02_0236__p357413172228"><strong id="cce_02_0236__b1957431714221">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p1157413170228">N/A</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1044475461115"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p133929413123">legacyVersion</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p153929421220">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p153924481212">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p113921411214">Details:</p>
|
|
<p id="cce_02_0236__p1239218451220">(Deprecated) Outdated version of CCE clusters, which serves no practical purpose and is only used to showcase the cluster version and platform version combination. The version number is globally unique. For example, if the cluster version is va.b and the platformVersion is cce.X.Y, the value of legacyVersion is va.b.X-rY.</p>
|
|
<p id="cce_02_0236__p73934413124">Constraints:</p>
|
|
<p id="cce_02_0236__p739304111215">None</p>
|
|
<p id="cce_02_0236__p183933411211">Options:</p>
|
|
<p id="cce_02_0236__p1739304191218">N/A</p>
|
|
<p id="cce_02_0236__p133931431212">Default value:</p>
|
|
<p id="cce_02_0236__p73933415123">N/A</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row438141651319"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p1653144010196">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p9485133718193">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p65261417142217">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p1318113472302">Cluster description, for example, which purpose the cluster is intended to serve. By default, this parameter is left unspecified. To modify cluster description after the cluster is created, call the <a href="cce_02_0240.html">API that is used to update information about a specified cluster</a> or go to the cluster details page on the CCE console.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row13855173825215"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p4366114413523">customSan</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p9366104405216">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p12366184414522">Array of strings</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p1336616448528">Custom SAN field in the server certificate of the cluster API server, which must comply with the SSL and X509 format specifications.</p>
|
|
<ol id="cce_02_0236__ol2366444185210"><li id="cce_02_0236__li123661644175214">Duplicate names are not allowed.</li><li id="cce_02_0236__li20366154411526">Must comply with the IP address and domain name formats.</li></ol>
|
|
<p id="cce_02_0236__p4366194411523">example: SAN 1: DNS Name=example.com SAN 2: DNS Name=www.example.com SAN 3: DNS Name=example.net SAN 4: IP Address=93.184.216.34</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row192821350151216"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p13742125720126">ipv6enable</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p774215710122">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p1274214576122">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p774245711122">Whether the cluster supports IPv6 addresses. This field is supported in clusters of v1.25 and later versions.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row17011947507"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p4701194125011">hostNetwork</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p1570134145017">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p167012042507"><a href="#cce_02_0236__table1622013552507">hostNetwork</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p123281848104313">Node network parameters, including a VPC and subnet ID. <strong id="cce_02_0236__b13136114517294">hostNetwork</strong> is mandatory because nodes in a cluster communicate with each other by using a VPC.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row651719205217"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p851151955212">containerNetwork</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p11511019115210">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p7514193520"><a href="#cce_02_0236__table882310145412">containerNetwork</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p16930187201117">Container network parameters, including a container network model and container CIDR block.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row16454592344"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p645579113413">eniNetwork</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p114551094348">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p545539173414"><a href="#cce_02_0236__request_EniNetwork">EniNetwork</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p645579113410">Configuration of Cloud Native Network 2.0. Specify this field when creating a CCE Turbo cluster.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row5905445161119"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p199067454111">publicAccess</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p690684591111">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p199064458114"><a href="#cce_02_0236__request_PublicAccess">PublicAccess</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p1290664510114">Cluster API access control.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row9493123913567"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p2493239145620">authentication</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p2493123917565">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p6493113918562"><a href="#cce_02_0236__table71529332533">authentication</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p14939395566">Configurations of the cluster authentication mode.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row336317542498"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p165111129172211">masters</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p2051112912213">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p1651220292221"><a href="#cce_02_0236__request_MasterSpec">MasterSpec</a> objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p15513112910229">Advanced configurations of the master node.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row97803915130"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p156284113136">kubernetesSvcIpRange</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p8782169151311">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p0703163016251">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p7782199181315">Service CIDR block or the IP address range which the <strong id="cce_02_0236__b1853831421311">kubernetes clusterIp</strong> must fall within. This parameter is available only for clusters of v1.11.7 and later.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row10323532155414"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p14324183215541">kubeProxyMode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p9324183255411">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p232415326549">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p113568261434">Service forwarding mode. Two modes are available:</p>
|
|
<ul id="cce_02_0236__ul1435618265318"><li id="cce_02_0236__li143564261833"><strong id="cce_02_0236__b106749431705">iptables</strong>: Traditional kube-proxy uses iptables rules to implement service load balancing. In this mode, too many iptables rules will be generated when many services are deployed. In addition, non-incremental updates will cause a latency and even obvious performance issues in the case of heavy service traffic.</li><li id="cce_02_0236__li12356202616316"><strong id="cce_02_0236__b17542918173615">ipvs</strong>: Optimized kube-proxy mode with higher throughput and faster speed. This mode supports incremental updates and can keep connections uninterrupted during service updates. It is suitable for large-sized clusters.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1384175110463"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p484119516469">extendParam</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p084112512463">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p19841451184614"><a href="#cce_02_0236__table17575013586">extendParam</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p13817123194716">Extended fields in the format of key-value pairs.</p>
|
|
<p id="cce_02_0236__p128174394710">If the cluster will span across AZs or belong to a specified enterprise project, set extended fields as described in <a href="#cce_02_0236__table17575013586">Table 14</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1685374110113"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p1025726106">enableMasterVolumeEncryption</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p2257166204">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p6257461203">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p192574618012">The system disks and data disks of the master nodes in the cluster are encrypted. By default, the AES-256 encryption algorithm is used. This function is available in both CCE standard and Turbo clusters of v1.25 and later versions. The configuration cannot be modified after the cluster is created. After this function is enabled, there is some disk I/O performance loss.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1821565285812"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p1215552195819">deletionProtection</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p921565211588">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p207661696579">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p12766159175713"><strong id="cce_02_0236__b1376619920574">Details</strong>:</p>
|
|
<p id="cce_02_0236__p3766092576">Cluster deletion protection, which prevents the deletion of a cluster when this function is enabled</p>
|
|
<p id="cce_02_0236__p976639105712"><strong id="cce_02_0236__b97661593574">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p77661796574">None</p>
|
|
<p id="cce_02_0236__p8766109205716"><strong id="cce_02_0236__b37665915571">Options</strong>:</p>
|
|
<ul id="cce_02_0236__ul147666905711"><li id="cce_02_0236__li776611965715"><p id="cce_02_0236__p8766294574"><a name="cce_02_0236__li776611965715"></a><a name="li776611965715"></a><strong id="cce_02_0236__b57662945716">true</strong>: Cluster deletion protection is enabled.</p>
|
|
</li><li id="cce_02_0236__li77667915718"><p id="cce_02_0236__p1776699175720"><a name="cce_02_0236__li77667915718"></a><a name="li77667915718"></a><strong id="cce_02_0236__b18766129165716">false</strong>: Cluster deletion protection is disabled.</p>
|
|
</li></ul>
|
|
<p id="cce_02_0236__p1076618919572"><strong id="cce_02_0236__b1376679165711">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p176611965715">false</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1993143914163"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0236__p3906153411615">configurationsOverride</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.454545454545455%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0236__p790623419618">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.03030303030303%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0236__p09061734961">Array of <a href="#cce_02_0236__request_PackageConfiguration">PackageConfiguration</a> objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.313131313131315%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0236__p15906834465"><strong id="cce_02_0236__b390618347614">Details</strong>:</p>
|
|
<p id="cce_02_0236__p17906134069">Overrides the default component configurations in a cluster.</p>
|
|
<p id="cce_02_0236__p3906934662"><strong id="cce_02_0236__b189067341611">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p12906153418611">If you specify a component or parameter that is not supported, the configuration item will be ignored.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table1622013552507"></a><a name="table1622013552507"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table1622013552507" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Data structure of the <strong id="cce_02_0236__b1761155392517">hostNetwork</strong> field</caption><thead align="left"><tr id="cce_02_0236__row922065525010"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.8.2.5.1.1"><p id="cce_02_0236__p687613311518">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.8.2.5.1.2"><p id="cce_02_0236__p589116375111">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19%" id="mcps1.3.3.8.2.5.1.3"><p id="cce_02_0236__p168912031515">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="48%" id="mcps1.3.3.8.2.5.1.4"><p id="cce_02_0236__p158914355111">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row1622075519505"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.8.2.5.1.1 "><p id="cce_02_0236__p1465319402192">vpc</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.8.2.5.1.2 "><p id="cce_02_0236__p12810837131913">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.8.2.5.1.3 "><p id="cce_02_0236__p1452691718229">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48%" headers="mcps1.3.3.8.2.5.1.4 "><p id="cce_02_0236__p2018164753013">ID of the VPC used to create a master node. The VPC ID is obtained from <a href="cce_02_0100.html">Creating a VPC and Subnet</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row322025520508"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.8.2.5.1.1 "><p id="cce_02_0236__p1665317409195">subnet</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.8.2.5.1.2 "><p id="cce_02_0236__p103711385193">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.8.2.5.1.3 "><p id="cce_02_0236__p185261417112213">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48%" headers="mcps1.3.3.8.2.5.1.4 "><p id="cce_02_0236__p111816472307">Network ID of the subnet. The value is obtained from <a href="cce_02_0100.html">Creating a VPC and Subnet</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1431620932016"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.8.2.5.1.1 "><p id="cce_02_0236__p177598209206">SecurityGroup</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.8.2.5.1.2 "><p id="cce_02_0236__p37591720122011">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.3.8.2.5.1.3 "><p id="cce_02_0236__p57591920162014">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48%" headers="mcps1.3.3.8.2.5.1.4 "><p id="cce_02_0236__p1575972042010">Default worker node security group ID of the cluster. If specified, the cluster will be bound to the target security group. Otherwise, the system will automatically create a default worker node security group for you. The default worker node security group needs to allow access from certain ports to ensure normal communications.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__request_PublicAccess"></a><a name="request_PublicAccess"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__request_PublicAccess" frame="border" border="1" rules="all"><caption><b>Table 7 </b>PublicAccess</caption><thead align="left"><tr id="cce_02_0236__row2086818441375"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.9.2.5.1.1"><p id="cce_02_0236__p8721143514198">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.11%" id="mcps1.3.3.9.2.5.1.2"><p id="cce_02_0236__p5721163510195">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.21%" id="mcps1.3.3.9.2.5.1.3"><p id="cce_02_0236__p87214359195">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="47.68%" id="mcps1.3.3.9.2.5.1.4"><p id="cce_02_0236__p77211435161913">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row17869244579"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.9.2.5.1.1 "><p id="cce_02_0236__p18522487177">cidrs</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.11%" headers="mcps1.3.3.9.2.5.1.2 "><p id="cce_02_0236__p552248191710">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.21%" headers="mcps1.3.3.9.2.5.1.3 "><p id="cce_02_0236__p1452278191715">Array of strings</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="47.68%" headers="mcps1.3.3.9.2.5.1.4 "><p id="cce_02_0236__p12522128161711">Trustlist of network CIDRs that are allowed to access cluster APIs. You are advised to allow the traffic from VPC and container network CIDRs. By default, no trustlist is configured, and the value is ["0.0.0.0/0"].</p>
|
|
<div class="note" id="cce_02_0236__note17522984179"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p25226810175">This parameter is valid only when a cluster is created.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table71529332533"></a><a name="table71529332533"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table71529332533" frame="border" border="1" rules="all"><caption><b>Table 8 </b>Data structure of the <strong id="cce_02_0236__b05411412788">authentication</strong> field</caption><thead align="left"><tr id="cce_02_0236__row131521433135310"><th align="left" class="cellrowborder" valign="top" width="21.29%" id="mcps1.3.3.10.2.5.1.1"><p id="cce_02_0236__p16152133325312">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="14.77%" id="mcps1.3.3.10.2.5.1.2"><p id="cce_02_0236__p837012427533">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.3%" id="mcps1.3.3.10.2.5.1.3"><p id="cce_02_0236__p1215283312531">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="43.64%" id="mcps1.3.3.10.2.5.1.4"><p id="cce_02_0236__p51521533135318">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row17153133125315"><td class="cellrowborder" valign="top" width="21.29%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0236__p415313335535">mode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.77%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0236__p5370942185310">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.3%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0236__p81531333165318">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.64%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0236__p10153113314537">Cluster authentication mode.</p>
|
|
<ul id="cce_02_0236__ul3255399454"><li id="cce_02_0236__li1625103920450">Clusters of Kubernetes v1.11 and earlier<ul id="cce_02_0236__ul1491611368019"><li id="cce_02_0236__li148517321005">Possible values: rbac, and authenticating_proxy</li></ul>
|
|
</li><li id="cce_02_0236__li17251839174515">Clusters of Kubernetes v1.13<ul id="cce_02_0236__ul1469415101216"><li id="cce_02_0236__li134795019116">Possible values: rbac and authenticating_proxy</li><li id="cce_02_0236__li11655919617">Default value: rbac</li></ul>
|
|
</li><li id="cce_02_0236__li17541834878">Clusters of Kubernetes v1.15 and later<ul id="cce_02_0236__ul57651107810"><li id="cce_02_0236__li9209191013812">Possible values: rbac, and authenticating_proxy</li><li id="cce_02_0236__li4209410082">Default value: rbac</li></ul>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1790141562916"><td class="cellrowborder" valign="top" width="21.29%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0236__p149011915202913">authenticatingProxy</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.77%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0236__p1290171520290">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.3%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0236__p8901161513297"><a href="#cce_02_0236__table17313161473013">authenticatingProxy</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.64%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0236__p2901121513292">Configurations of the <strong id="cce_02_0236__b1076411138231">authenticating_proxy</strong> mode.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table17313161473013"></a><a name="table17313161473013"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table17313161473013" width="100%" frame="border" border="1" rules="all"><caption><b>Table 9 </b>Data structure of the <strong id="cce_02_0236__b33131314183013">authenticatingProxy</strong> field</caption><thead align="left"><tr id="cce_02_0236__row1531310142305"><th align="left" class="cellrowborder" valign="top" width="17.4017401740174%" id="mcps1.3.3.11.2.5.1.1"><p id="cce_02_0236__p1931491463016">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.47134713471347%" id="mcps1.3.3.11.2.5.1.2"><p id="cce_02_0236__p137751123205411">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.681868186818683%" id="mcps1.3.3.11.2.5.1.3"><p id="cce_02_0236__p0314131443011">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50.44504450445044%" id="mcps1.3.3.11.2.5.1.4"><p id="cce_02_0236__p33141014163014">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row4512022131720"><td class="cellrowborder" valign="top" width="17.4017401740174%" headers="mcps1.3.3.11.2.5.1.1 "><p id="cce_02_0236__p7845203261715">ca</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.47134713471347%" headers="mcps1.3.3.11.2.5.1.2 "><p id="cce_02_0236__p1384510329171">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.681868186818683%" headers="mcps1.3.3.11.2.5.1.3 "><p id="cce_02_0236__p198451232111719">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50.44504450445044%" headers="mcps1.3.3.11.2.5.1.4 "><p id="cce_02_0236__p12513022121710">X509 CA certificate (Base64-encoded) configured in authenticating_proxy mode. This field is mandatory when the cluster authentication mode is <strong id="cce_02_0236__b626210529171">authenticating_proxy</strong>. The maximum size of the certificate is 1 MB.</p>
|
|
<div class="note" id="cce_02_0236__note20530135522914"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p618479233">The uploaded CA certificate is used for both the authentication proxy and the kube-apiserver aggregation layer configuration. If the certificate is invalid, the cluster cannot be created. For details about the kube-apiserver aggregation layer, see <a href="https://kubernetes.io/docs/tasks/extend-kubernetes/configure-aggregation-layer/" target="_blank" rel="noopener noreferrer">Configure the Aggregation Layer</a>.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row7184124612145"><td class="cellrowborder" valign="top" width="17.4017401740174%" headers="mcps1.3.3.11.2.5.1.1 "><p id="cce_02_0236__p124971744184314">cert</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.47134713471347%" headers="mcps1.3.3.11.2.5.1.2 "><p id="cce_02_0236__p9455191615158">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.681868186818683%" headers="mcps1.3.3.11.2.5.1.3 "><p id="cce_02_0236__p1845521651517">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50.44504450445044%" headers="mcps1.3.3.11.2.5.1.4 "><p id="cce_02_0236__p8185946121414">Client certificate (Base64-encoded) issued by the X509 CA certificate configured in authenticating_proxy mode. This certificate is used for authentication from kube-apiserver to the extended API server. This field is mandatory when the cluster authentication mode is <strong id="cce_02_0236__b1141529183">authenticating_proxy</strong>.</p>
|
|
<p id="cce_02_0236__p76035526297">For details about the kube-apiserver aggregation layer, see <a href="https://kubernetes.io/docs/tasks/extend-kubernetes/configure-aggregation-layer/" target="_blank" rel="noopener noreferrer">Configure the Aggregation Layer</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row3933175011415"><td class="cellrowborder" valign="top" width="17.4017401740174%" headers="mcps1.3.3.11.2.5.1.1 "><p id="cce_02_0236__p1693419508146">privateKey</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.47134713471347%" headers="mcps1.3.3.11.2.5.1.2 "><p id="cce_02_0236__p1594318186156">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.681868186818683%" headers="mcps1.3.3.11.2.5.1.3 "><p id="cce_02_0236__p179438185150">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50.44504450445044%" headers="mcps1.3.3.11.2.5.1.4 "><p id="cce_02_0236__p2934115041415">Private key (Base64-encoded) of the client certificate issued by the X509 CA certificate configured in authenticating_proxy mode. This key is used for authentication from kube-apiserver to the extended API server. The private key used by the Kubernetes cluster does not support password encryption. Use an unencrypted private key. This field is mandatory when the cluster authentication mode is <strong id="cce_02_0236__b9533729141816">authenticating_proxy</strong>.</p>
|
|
<p id="cce_02_0236__p18682159122911">For details about the kube-apiserver aggregation layer, see <a href="https://kubernetes.io/docs/tasks/extend-kubernetes/configure-aggregation-layer/" target="_blank" rel="noopener noreferrer">Configure the Aggregation Layer</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table882310145412"></a><a name="table882310145412"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table882310145412" frame="border" border="1" rules="all"><caption><b>Table 10 </b>Data structure of the <strong id="cce_02_0236__b464715522912">containerNetwork</strong> field</caption><thead align="left"><tr id="cce_02_0236__row1682316016545"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.12.2.5.1.1"><p id="cce_02_0236__p1694819205543">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.12.2.5.1.2"><p id="cce_02_0236__p149646206541">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.3.12.2.5.1.3"><p id="cce_02_0236__p11964620145410">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="49%" id="mcps1.3.3.12.2.5.1.4"><p id="cce_02_0236__p09648200542">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row482317016541"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.1 "><p id="cce_02_0236__p2082320195415">mode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.12.2.5.1.2 "><p id="cce_02_0236__p2082310011547">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.12.2.5.1.3 "><p id="cce_02_0236__p28237014542">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.12.2.5.1.4 "><p id="cce_02_0236__p2398131181613">Container network model. Select one of the following possible values:</p>
|
|
<ul id="cce_02_0236__ul1085141916166"><li id="cce_02_0236__li34128225166"><strong id="cce_02_0236__b1892704916116">overlay_l2</strong>: an overlay_l2 network built for containers by using OpenVSwitch (OVS).</li><li id="cce_02_0236__li485171981612"><strong id="cce_02_0236__b15370163183618">vpc-router</strong>: an underlay_l2 network built for containers by using ipvlan and custom VPC routes.</li><li id="cce_02_0236__li175841223205113"><strong id="cce_02_0236__b0584623145118">eni</strong>: cloud native 2.0 network model. This model deeply integrates the native ENI capability of VPC, uses the VPC CIDR block to allocate container addresses, and supports passthrough between load balancers and containers to provide high performance. You can use this network model when creating a CCE Turbo cluster.</li></ul>
|
|
<div class="note" id="cce_02_0236__note1860516155199"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="cce_02_0236__ul21791736131915"><li id="cce_02_0236__li5179536151917">Tunnel network: Under this model, the container network is an overlay network on top of a VPC network based on the VXLAN technology. VXLAN encapsulates Ethernet packets as UDP packets for tunnel transmission. Though at some cost of performance, the tunnel encapsulation enables higher interoperability and compatibility with advanced features (such as network policy-based isolation), meeting the requirements of most applications.</li><li id="cce_02_0236__li2020854413199">VPC network: Routing is implemented within a VPC network according to custom VPC routes. Each node is assigned a CIDR block of a fixed size. vpc-router networks are free of tunnel encapsulation overheads and provide better container network performance than tunnel networks. In addition, as routes to node IP addresses and the containers have been configured on vpc-router, container instances can be directly accessed from outside the cluster.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row482313013542"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.1 "><p id="cce_02_0236__p1982310145419">cidr</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.12.2.5.1.2 "><p id="cce_02_0236__p082314014543">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.12.2.5.1.3 "><p id="cce_02_0236__p19823401545">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.12.2.5.1.4 "><p id="cce_02_0236__p181514571229">Container CIDR block. Recommended: 10.0.0.0/12-19, 172.16.0.0/16-19, or 192.168.0.0/16-19. If the selected CIDR block conflicts with existing CIDR blocks, the system automatically selects another CIDR block.</p>
|
|
<p id="cce_02_0236__p84121213016">This parameter cannot be modified after the cluster is created. Exercise caution when setting this parameter.(This parameter has been discarded. If <strong id="cce_02_0236__b1093110531174">cidrs</strong> has been configured, skip this parameter.)</p>
|
|
<p id="cce_02_0236__p1390788347">Minimum: <strong id="cce_02_0236__b163907813342">0</strong></p>
|
|
<p id="cce_02_0236__p93901184349">Maximum: <strong id="cce_02_0236__b4390118123411">64</strong></p>
|
|
<div class="note" id="cce_02_0236__note379416532712"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p1862910356273">This parameter is not valid for CCE Turbo cluster.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1258115125819"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.1 "><p id="cce_02_0236__p838891319370">cidrs</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.12.2.5.1.2 "><p id="cce_02_0236__p19388713193715">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.3.12.2.5.1.3 "><p id="cce_02_0236__p20389121343714">Array of <a href="#cce_02_0236__request_ContainerCIDR">ContainerCIDR</a> objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.3.12.2.5.1.4 "><p id="cce_02_0236__p19321153174">List of container CIDR blocks. In clusters of v1.21 and later, the <strong id="cce_02_0236__b19328533718">cidrs</strong> field is used. When the cluster network type is <strong id="cce_02_0236__b89321153070">vpc-router</strong>, you can add multiple container CIDR blocks. In versions earlier than v1.21, if the <strong id="cce_02_0236__b1093212531171">cidrs</strong> field is used, the first CIDR element in the array is used as the container CIDR block.</p>
|
|
<p id="cce_02_0236__p793215531276">The configuration cannot be changed after the cluster is created.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__request_ContainerCIDR"></a><a name="request_ContainerCIDR"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__request_ContainerCIDR" frame="border" border="1" rules="all"><caption><b>Table 11 </b>ContainerCIDR</caption><thead align="left"><tr id="cce_02_0236__row13957412123714"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.13.2.5.1.1"><p id="cce_02_0236__p832930154717">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.13.2.5.1.2"><p id="cce_02_0236__p113215303473">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.13.2.5.1.3"><p id="cce_02_0236__p63203034712">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.13.2.5.1.4"><p id="cce_02_0236__p733203004715">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row5957141212376"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.13.2.5.1.1 "><p id="cce_02_0236__p183902137370">cidr</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.13.2.5.1.2 "><p id="cce_02_0236__p9391121373712">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.13.2.5.1.3 "><p id="cce_02_0236__p103911513193716">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.13.2.5.1.4 "><p id="cce_02_0236__p12391313113711">Container CIDR block. Recommended: 10.0.0.0/12-19, 172.16.0.0/16-19, and 192.168.0.0/16-19</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__request_EniNetwork"></a><a name="request_EniNetwork"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__request_EniNetwork" frame="border" border="1" rules="all"><caption><b>Table 12 </b>EniNetwork</caption><thead align="left"><tr id="cce_02_0236__row18429162325114"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.14.2.5.1.1"><p id="cce_02_0236__p13585182315513">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.14.2.5.1.2"><p id="cce_02_0236__p55851235512">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.14.2.5.1.3"><p id="cce_02_0236__p458572314518">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.14.2.5.1.4"><p id="cce_02_0236__p6585523185115">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row1429723185112"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.14.2.5.1.1 "><p id="cce_02_0236__p55859232519">eniSubnetId</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.14.2.5.1.2 "><p id="cce_02_0236__p3585192319515">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.14.2.5.1.3 "><p id="cce_02_0236__p1758592312514">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.14.2.5.1.4 "><p id="cce_02_0236__p658517237511">IPv4 Subnet ID of the ENI container subnet. Currently, IPv6 is not supported.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row6429192310512"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.14.2.5.1.1 "><p id="cce_02_0236__p2058582320518">eniSubnetCIDR</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.14.2.5.1.2 "><p id="cce_02_0236__p358582315519">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.14.2.5.1.3 "><p id="cce_02_0236__p258572318516">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.14.2.5.1.4 "><p id="cce_02_0236__p058522315117">ENI subnet CIDR block.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__request_MasterSpec"></a><a name="request_MasterSpec"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__request_MasterSpec" frame="border" border="1" rules="all"><caption><b>Table 13 </b>MasterSpec</caption><thead align="left"><tr id="cce_02_0236__row660352917222"><th align="left" class="cellrowborder" valign="top" width="17.630000000000003%" id="mcps1.3.3.15.2.5.1.1"><p id="cce_02_0236__p16532730142211">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="11.129999999999999%" id="mcps1.3.3.15.2.5.1.2"><p id="cce_02_0236__p2532163013227">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.459999999999999%" id="mcps1.3.3.15.2.5.1.3"><p id="cce_02_0236__p55321330132215">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.78%" id="mcps1.3.3.15.2.5.1.4"><p id="cce_02_0236__p0532193015226">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row7603132916227"><td class="cellrowborder" valign="top" width="17.630000000000003%" headers="mcps1.3.3.15.2.5.1.1 "><p id="cce_02_0236__p135321630142216">availabilityZone</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.129999999999999%" headers="mcps1.3.3.15.2.5.1.2 "><p id="cce_02_0236__p155321230162218">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.459999999999999%" headers="mcps1.3.3.15.2.5.1.3 "><p id="cce_02_0236__p125322030142219">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.78%" headers="mcps1.3.3.15.2.5.1.4 "><p id="cce_02_0236__p178875298384">Availability Zone.</p>
|
|
<p id="cce_02_0236__p48691940163718">For example:</p>
|
|
<pre class="screen" id="cce_02_0236__screen89571524944">"masters": [
|
|
{
|
|
"availabilityZone": "eu-de-01"
|
|
},
|
|
{
|
|
"availabilityZone": "eu-de-01"
|
|
},
|
|
{
|
|
"availabilityZone": "eu-de-02"
|
|
}
|
|
],</pre>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table17575013586"></a><a name="table17575013586"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table17575013586" frame="border" border="1" rules="all"><caption><b>Table 14 </b>Data structure of the extendParam field</caption><thead align="left"><tr id="cce_02_0236__row51071750155814"><th align="left" class="cellrowborder" valign="top" width="17.29%" id="mcps1.3.3.16.2.5.1.1"><p id="cce_02_0236__p41071050115816">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="11.73%" id="mcps1.3.3.16.2.5.1.2"><p id="cce_02_0236__p9808942152218">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.189999999999998%" id="mcps1.3.3.16.2.5.1.3"><p id="cce_02_0236__p1312155019587">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="51.790000000000006%" id="mcps1.3.3.16.2.5.1.4"><p id="cce_02_0236__p13121155016582">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row1457961164816"><td class="cellrowborder" valign="top" width="17.29%" headers="mcps1.3.3.16.2.5.1.1 "><p id="cce_02_0236__p14579101174811">clusterAZ</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.3.3.16.2.5.1.2 "><p id="cce_02_0236__p8809184232210">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.3.16.2.5.1.3 "><p id="cce_02_0236__p205793194812">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.790000000000006%" headers="mcps1.3.3.16.2.5.1.4 "><p id="cce_02_0236__p114561146513">If you want to enable multiple AZs for the cluster, enter {"clusterAZ": "multi_az"}.</p>
|
|
<div class="note" id="cce_02_0236__note193489237289"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p134992342810">Only HA clusters support multiple AZs. To be specific, this field can be configured only when the <strong id="cce_02_0236__b5383153416301">flavor</strong> field in <a href="#cce_02_0236__table1034041612134">Table 5</a> is set to <strong id="cce_02_0236__b109089113316">cce.s2.small</strong>, <strong id="cce_02_0236__b1695118368313">cce.s2.medium</strong>, <strong id="cce_02_0236__b6135146133115">cce.s2.large</strong>, <strong id="cce_02_0236__b1768451113115">cce.t2.small</strong>, <strong id="cce_02_0236__b1766555113114">cce.t2.medium</strong>, or <strong id="cce_02_0236__b135489019329">cce.t2.large</strong>. After multi-AZ deployment is enabled, the three master nodes of the cluster are distributed in different AZs. The cluster remains available even when one of the AZs is down.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row15380172523019"><td class="cellrowborder" valign="top" width="17.29%" headers="mcps1.3.3.16.2.5.1.1 "><p id="cce_02_0236__p113811255309">dssMasterVolumes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.3.3.16.2.5.1.2 "><p id="cce_02_0236__p080911421227">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.3.16.2.5.1.3 "><p id="cce_02_0236__p113813253300">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.790000000000006%" headers="mcps1.3.3.16.2.5.1.4 "><p id="cce_02_0236__p1038132513014">Whether the system and data disks of a master node use dedicated distributed storage. If this parameter is omitted or left unspecified, EVS disks are used by default.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row14779928204314"><td class="cellrowborder" valign="top" width="17.29%" headers="mcps1.3.3.16.2.5.1.1 "><p id="cce_02_0236__p18780112824315">kubeProxyMode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.3.3.16.2.5.1.2 "><p id="cce_02_0236__p978017280436">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.3.16.2.5.1.3 "><p id="cce_02_0236__p778017283439">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.790000000000006%" headers="mcps1.3.3.16.2.5.1.4 "><p id="cce_02_0236__p13993161712338">Service forwarding mode. Two modes are available:</p>
|
|
<ul id="cce_02_0236__ul38043388275"><li id="cce_02_0236__li57062914375"><strong id="cce_02_0236__b1894710223315">iptables</strong>: Traditional kube-proxy uses iptables rules to implement service load balancing. In this mode, too many iptables rules will be generated when many Services are deployed. In addition, non-incremental updates will cause a latency and even tangible performance issues in the case of service traffic spikes.</li><li id="cce_02_0236__li13951481275"><strong id="cce_02_0236__b3294043134317">ipvs</strong>: Optimized kube-proxy mode with higher throughput and faster speed. This mode supports incremental updates and can keep connections uninterrupted during service updates. It is suitable for large-sized clusters.</li></ul>
|
|
<div class="note" id="cce_02_0236__note7104137202618"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p2104113717261">This parameter has been deprecated. If both this parameter and kubeProxyMode under ClusterSpec are specified, the latter will be used.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row2685716193113"><td class="cellrowborder" valign="top" width="17.29%" headers="mcps1.3.3.16.2.5.1.1 "><p id="cce_02_0236__p136861116153119">clusterExternalIP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.3.3.16.2.5.1.2 "><p id="cce_02_0236__p768621620318">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.3.16.2.5.1.3 "><p id="cce_02_0236__p1686191683110">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.790000000000006%" headers="mcps1.3.3.16.2.5.1.4 "><p id="cce_02_0236__p515313509336">EIP of the master node.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row532417272514"><td class="cellrowborder" valign="top" width="17.29%" headers="mcps1.3.3.16.2.5.1.1 "><p id="cce_02_0236__p9864604409">alpha.cce/fixPoolMask</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.3.3.16.2.5.1.2 "><p id="cce_02_0236__p10864150134011">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.3.16.2.5.1.3 "><p id="cce_02_0236__p178642084019">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.790000000000006%" headers="mcps1.3.3.16.2.5.1.4 "><p id="cce_02_0236__p13838144314217">Number of mask bits of the fixed IP address pool of the container network model. This field is supported only for the VPC network model (vpc-router).</p>
|
|
<p id="cce_02_0236__p198381543204213">This parameter determines the number of container IP addresses that can be allocated to a node. The maximum number of pods that can be created on a node is decided by this parameter and maxPods set during node creation.</p>
|
|
<p id="cce_02_0236__p58381443204220">The value is an integer ranging from 24 to 28.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row160911912257"><td class="cellrowborder" valign="top" width="17.29%" headers="mcps1.3.3.16.2.5.1.1 "><p id="cce_02_0236__p1157918534017">kubernetes.io/cpuManagerPolicy</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.3.3.16.2.5.1.2 "><p id="cce_02_0236__p105797584015">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.3.16.2.5.1.3 "><p id="cce_02_0236__p20579151409">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.790000000000006%" headers="mcps1.3.3.16.2.5.1.4 "><p id="cce_02_0236__p1756334142010">Cluster CPU management policy. The value can be <strong id="cce_02_0236__b139666123314">none</strong> or <strong id="cce_02_0236__b1249631703115">static</strong>. The default value is <strong id="cce_02_0236__b1913772403112">none</strong>.</p>
|
|
<ul id="cce_02_0236__ul51601215183212"><li id="cce_02_0236__li1416071511320"><strong id="cce_02_0236__b1966542218322">none</strong>: CPU cores will not be exclusively allocated to workload pods. Select this value if you want a large pool of shareable CPU cores.</li><li id="cce_02_0236__li1616018156323"><strong id="cce_02_0236__b680142743215">static</strong>: CPU cores can be exclusively allocated to workload pods. Select this value if your workload is sensitive to latency in CPU cache and scheduling.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1027521462516"><td class="cellrowborder" valign="top" width="17.29%" headers="mcps1.3.3.16.2.5.1.1 "><p id="cce_02_0236__p191639915401">upgradefrom</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.3.3.16.2.5.1.2 "><p id="cce_02_0236__p111637994010">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.189999999999998%" headers="mcps1.3.3.16.2.5.1.3 "><p id="cce_02_0236__p1163189174016">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.790000000000006%" headers="mcps1.3.3.16.2.5.1.4 "><p id="cce_02_0236__p7176173622017">Reserved. This field is returned only for a query.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__request_PackageConfiguration"></a><a name="request_PackageConfiguration"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__request_PackageConfiguration" frame="border" border="1" rules="all"><caption><b>Table 15 </b>PackageConfiguration</caption><thead align="left"><tr id="cce_02_0236__row0649834867"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.17.2.5.1.1"><p id="cce_02_0236__p79200345613">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.17.2.5.1.2"><p id="cce_02_0236__p2092093410612">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.17.2.5.1.3"><p id="cce_02_0236__p1092083416611">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.17.2.5.1.4"><p id="cce_02_0236__p12920103416610">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row56491834560"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.17.2.5.1.1 "><p id="cce_02_0236__p792073416618">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.17.2.5.1.2 "><p id="cce_02_0236__p992015341565">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.17.2.5.1.3 "><p id="cce_02_0236__p69201234369">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.17.2.5.1.4 "><p id="cce_02_0236__p1892012341617"><strong id="cce_02_0236__b209201534760">Details</strong>:</p>
|
|
<p id="cce_02_0236__p19920234664">Component name</p>
|
|
<p id="cce_02_0236__p159207341568"><strong id="cce_02_0236__b11920183418616">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p5920163413611">None</p>
|
|
<p id="cce_02_0236__p0920434766"><strong id="cce_02_0236__b29205341363">Options</strong>:</p>
|
|
<p id="cce_02_0236__p29206341611">N/A</p>
|
|
<p id="cce_02_0236__p69201134163"><strong id="cce_02_0236__b99201534367">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p392018343612">N/A</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row26499341865"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.17.2.5.1.1 "><p id="cce_02_0236__p392043414615">configurations</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.17.2.5.1.2 "><p id="cce_02_0236__p1692019341767">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.17.2.5.1.3 "><p id="cce_02_0236__p69201334960">Array of <a href="#cce_02_0236__request_ConfigurationItem">ConfigurationItem</a> objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.17.2.5.1.4 "><p id="cce_02_0236__p1192153415613"><strong id="cce_02_0236__b392116344614">Details</strong>:</p>
|
|
<p id="cce_02_0236__p109211034366">Component configuration items</p>
|
|
<p id="cce_02_0236__p1392153417617"><strong id="cce_02_0236__b49211534161">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p392153411610">None</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__request_ConfigurationItem"></a><a name="request_ConfigurationItem"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__request_ConfigurationItem" frame="border" border="1" rules="all"><caption><b>Table 16 </b>ConfigurationItem</caption><thead align="left"><tr id="cce_02_0236__row5650153420610"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.18.2.5.1.1"><p id="cce_02_0236__p1992113341611">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.18.2.5.1.2"><p id="cce_02_0236__p89215345619">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.18.2.5.1.3"><p id="cce_02_0236__p17921173413613">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.18.2.5.1.4"><p id="cce_02_0236__p20921934363">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row2650934365"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.18.2.5.1.1 "><p id="cce_02_0236__p199213341262">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.18.2.5.1.2 "><p id="cce_02_0236__p1492111341661">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.18.2.5.1.3 "><p id="cce_02_0236__p1792113412610">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.18.2.5.1.4 "><p id="cce_02_0236__p3921193420614"><strong id="cce_02_0236__b29214342610">Details</strong>:</p>
|
|
<p id="cce_02_0236__p209211346613">Configuration overrides of the default components in a cluster.</p>
|
|
<p id="cce_02_0236__p15921734664"><strong id="cce_02_0236__b29214341465">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p13921334063">If you specify a component or parameter that is not supported, this configuration item will be ignored.</p>
|
|
<p id="cce_02_0236__p39211734767"><strong id="cce_02_0236__b149211534767">Options</strong>:</p>
|
|
<p id="cce_02_0236__p592163419614">N/A</p>
|
|
<p id="cce_02_0236__p492103415610"><strong id="cce_02_0236__b492117341966">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p129211134669">N/A</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row2065015341466"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.18.2.5.1.1 "><p id="cce_02_0236__p1921183412614">value</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.18.2.5.1.2 "><p id="cce_02_0236__p8921234969">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.18.2.5.1.3 "><p id="cce_02_0236__p1592117341561">AnyType</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.18.2.5.1.4 "><p id="cce_02_0236__p9921193419617"><strong id="cce_02_0236__b199219341360">Details</strong>:</p>
|
|
<p id="cce_02_0236__p15921173416617">Configuration overrides of the default components in a cluster.</p>
|
|
<p id="cce_02_0236__p109211434164"><strong id="cce_02_0236__b3921934263">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p2092110341768">If you specify a component or parameter that is not supported, this configuration item will be ignored.</p>
|
|
<p id="cce_02_0236__p169211334162"><strong id="cce_02_0236__b692163416617">Options</strong>:</p>
|
|
<p id="cce_02_0236__p139211134267">N/A</p>
|
|
<p id="cce_02_0236__p29212341569"><strong id="cce_02_0236__b492133419614">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p6921133415610">N/A</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="cce_02_0236__p53625936203655"><strong id="cce_02_0236__b562002">Example Request</strong></p>
|
|
<div class="p" id="cce_02_0236__p192315102458">CCE Cluster:<pre class="screen" id="cce_02_0236__screen1938663583313">{
|
|
"kind": "Cluster",
|
|
"apiVersion": "v3",
|
|
"metadata": {
|
|
"name": "mycluster",
|
|
"labels": {
|
|
"foo": "bar"
|
|
},
|
|
"annotations": {
|
|
"foo2": "bar2"
|
|
}
|
|
},
|
|
"spec": {
|
|
"type": "VirtualMachine",
|
|
"flavor": "cce.s2.small",
|
|
"version": "v1.19.8-r0",
|
|
"description": "this is a demo cluster",
|
|
"hostNetwork": {
|
|
"vpc": "23d3725f-6ffe-400e-8fb6-b4f9a7b3e8c1",
|
|
"subnet": "c90b3ce5-e1f1-4c87-a006-644d78846438"
|
|
},
|
|
"containerNetwork": {
|
|
"mode": "overlay_l2",
|
|
"cidr": "172.16.0.0/16"
|
|
},
|
|
"authentication": {
|
|
"mode": "rbac",
|
|
},
|
|
"kubeProxyMode": "iptables",
|
|
"billingMode": 0,
|
|
"extendParam": {
|
|
"clusterAZ": "multi_az"
|
|
}
|
|
}
|
|
}</pre>
|
|
</div>
|
|
<p id="cce_02_0236__p63292211454">CCE Turbo Cluster:</p>
|
|
<pre class="screen" id="cce_02_0236__screen446254024515">{
|
|
"kind": "Cluster",
|
|
"apiVersion": "v3",
|
|
"metadata": {
|
|
"name": "turbo"
|
|
},
|
|
"spec": {
|
|
"type": "VirtualMachine",
|
|
"flavor": "cce.s2.medium",
|
|
"version": "v1.19.10-r0",
|
|
"hostNetwork": {
|
|
"vpc": "05c33818-78df-4329-b546-5df2f1aa823e",
|
|
"subnet": "9f0c8ef2-c608-4238-88be-87bce5fe90da"
|
|
},
|
|
"containerNetwork": {
|
|
"mode": "eni"
|
|
},
|
|
"eniNetwork": {
|
|
"eniSubnetId": "417dcc1f-95d7-43e7-8533-ab078d266303",
|
|
"eniSubnetCIDR": "192.168.0.0/24"
|
|
},
|
|
"kubernetesSvcIpRange": "10.247.0.0/16",
|
|
"authentication": {
|
|
"mode": "rbac"
|
|
},
|
|
"extendParam": {
|
|
"kubeProxyMode": "ipvs"
|
|
}
|
|
}
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="cce_02_0236__section61819725020"><h4 class="sectiontitle">Response</h4><p id="cce_02_0236__en-us_topic_0079614900_p2018733"><strong id="cce_02_0236__b2611581026">Response parameters:</strong></p>
|
|
<p id="cce_02_0236__p16966318249"><a href="#cce_02_0236__en-us_topic_0079616779_en-us_topic_0079614912_ref458774242">Table 17</a> describes the response parameters.</p>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__en-us_topic_0079616779_en-us_topic_0079614912_ref458774242"></a><a name="en-us_topic_0079616779_en-us_topic_0079614912_ref458774242"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__en-us_topic_0079616779_en-us_topic_0079614912_ref458774242" frame="border" border="1" rules="all"><caption><b>Table 17 </b>Response parameters</caption><thead align="left"><tr id="cce_02_0236__en-us_topic_0079616779_en-us_topic_0079614912_row38450714"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.4.2.4.1.1"><p id="cce_02_0236__en-us_topic_0079616779_en-us_topic_0079614912_p27500114">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.4.2.4.1.2"><p id="cce_02_0236__p1654581422214">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="55.00000000000001%" id="mcps1.3.4.4.2.4.1.3"><p id="cce_02_0236__p125451914132219">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__en-us_topic_0079616779_en-us_topic_0079614912_row48220637"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="cce_02_0236__p108391536181311">kind</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.4.1.2 "><p id="cce_02_0236__p1056311621716">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.4.2.4.1.3 "><p id="cce_02_0236__p75781816181715">API type. The value is fixed at <strong id="cce_02_0236__b11847261531">Cluster</strong> and cannot be changed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1698782994313"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="cce_02_0236__p1785493610136">apiVersion</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.4.1.2 "><p id="cce_02_0236__p757801610179">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.4.2.4.1.3 "><p id="cce_02_0236__p12578616151718">API version. The value is fixed at <strong id="cce_02_0236__b1677919249511">v3</strong> and cannot be changed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__en-us_topic_0079616779_en-us_topic_0079614912_row28135397"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="cce_02_0236__p1185493615135">metadata</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.4.1.2 "><p id="cce_02_0236__p1334385071712"><a href="#cce_02_0236__table669019286188">metadata</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.4.2.4.1.3 "><p id="cce_02_0236__p10343195011177">Cluster metadata, which is a collection of attributes.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row125326326151"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="cce_02_0236__p6532732161518">spec</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.4.1.2 "><p id="cce_02_0236__p5359350141715"><a href="#cce_02_0236__table195921039143517">spec</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.4.2.4.1.3 "><p id="cce_02_0236__p173598507179">Detailed description of the cluster to be created. CCE creates or updates objects by defining or updating its spec.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row22041436171514"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.4.2.4.1.1 "><p id="cce_02_0236__p15204203610152">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.4.1.2 "><p id="cce_02_0236__p1920413611513"><a href="#cce_02_0236__table6749834132215">status</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.00000000000001%" headers="mcps1.3.4.4.2.4.1.3 "><p id="cce_02_0236__p9204133661512">Cluster status and jobID of the cluster creation job.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table669019286188"></a><a name="table669019286188"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table669019286188" frame="border" border="1" rules="all"><caption><b>Table 18 </b>Data structure of the <strong id="cce_02_0236__b1618814517392">metadata</strong> field</caption><thead align="left"><tr id="cce_02_0236__row869032841815"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.5.2.4.1.1"><p id="cce_02_0236__p196902028151813">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.98%" id="mcps1.3.4.5.2.4.1.2"><p id="cce_02_0236__p126901728121814">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="55.02%" id="mcps1.3.4.5.2.4.1.3"><p id="cce_02_0236__p1069010288189">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row15690328101814"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="cce_02_0236__p11771347194">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.98%" headers="mcps1.3.4.5.2.4.1.2 "><p id="cce_02_0236__p577117401918">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.02%" headers="mcps1.3.4.5.2.4.1.3 "><p id="cce_02_0236__p1977117411193">Cluster name.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1169042813188"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="cce_02_0236__p6786241193">uid</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.98%" headers="mcps1.3.4.5.2.4.1.2 "><p id="cce_02_0236__p14111627201917">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.02%" headers="mcps1.3.4.5.2.4.1.3 "><p id="cce_02_0236__p1786447194">Cluster ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1569018282188"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="cce_02_0236__p16180152612019">creationTimestamp</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.98%" headers="mcps1.3.4.5.2.4.1.2 "><p id="cce_02_0236__p191801726182014">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.02%" headers="mcps1.3.4.5.2.4.1.3 "><p id="cce_02_0236__p20180132652013">Time when the cluster was created.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row669012861812"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="cce_02_0236__p6180202692018">updateTimestamp</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.98%" headers="mcps1.3.4.5.2.4.1.2 "><p id="cce_02_0236__p166835167215">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.02%" headers="mcps1.3.4.5.2.4.1.3 "><p id="cce_02_0236__p91641926182011">Time when the cluster was updated.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row66901028161820"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="cce_02_0236__p1786194191915">labels</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.98%" headers="mcps1.3.4.5.2.4.1.2 "><p id="cce_02_0236__p17401032131916">Map<String,String></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.02%" headers="mcps1.3.4.5.2.4.1.3 "><p id="cce_02_0236__p1080274161918">Cluster labels in the format of key-value pairs.</p>
|
|
<div class="note" id="cce_02_0236__note4645327216"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p2645421128">The value of this field is automatically generated by the system and is used by the frontend to identify the features supported by the cluster during the upgrade. The value specified by the user is invalid.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1269015284182"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="cce_02_0236__p1180210415193">annotations</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.98%" headers="mcps1.3.4.5.2.4.1.2 "><p id="cce_02_0236__p14802164201917">Map<String,String></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.02%" headers="mcps1.3.4.5.2.4.1.3 "><p id="cce_02_0236__p18181491919">Cluster annotations in the format of key-value pairs.</p>
|
|
<pre class="screen" id="cce_02_0236__screen76583581439">"annotations": { "key1" : "value1", "key2" : "value2" }</pre>
|
|
<div class="note" id="cce_02_0236__note7549061542"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="cce_02_0236__ul7798153757"><li id="cce_02_0236__li137981053552"><strong id="cce_02_0236__b1437220714620">annotations</strong> is not used to identify or select objects. Metadata in <strong id="cce_02_0236__b36118221369">annotations</strong> can be small or large, structured or unstructured, and can include characters that are not allowed in labels.</li><li id="cce_02_0236__li17482657355">This field is not stored in the database and is used only to specify the add-ons to be installed the cluster.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row12053615376"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="cce_02_0236__p6971456193416">timezone</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.98%" headers="mcps1.3.4.5.2.4.1.2 "><p id="cce_02_0236__p10971256113419">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.02%" headers="mcps1.3.4.5.2.4.1.3 "><p id="cce_02_0236__p14976564346"><strong id="cce_02_0236__b179755673420">Details</strong>:</p>
|
|
<p id="cce_02_0236__p49735643413">Cluster time zone</p>
|
|
<p id="cce_02_0236__p1097135613343"><strong id="cce_02_0236__b17979567349">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p0971956153416">None</p>
|
|
<p id="cce_02_0236__p1597185633416"><strong id="cce_02_0236__b1197145618342">Options</strong>:</p>
|
|
<p id="cce_02_0236__p397256123417">N/A</p>
|
|
<p id="cce_02_0236__p09714564349"><strong id="cce_02_0236__b39725633413">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p49785673415">N/A</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table195921039143517"></a><a name="table195921039143517"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table195921039143517" frame="border" border="1" rules="all"><caption><b>Table 19 </b>Data structure of the <strong id="cce_02_0236__b1911214023919">spec</strong> field</caption><thead align="left"><tr id="cce_02_0236__row1960853920353"><th align="left" class="cellrowborder" valign="top" width="23%" id="mcps1.3.4.6.2.4.1.1"><p id="cce_02_0236__p11624153903519">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21%" id="mcps1.3.4.6.2.4.1.2"><p id="cce_02_0236__p11624183910351">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.00000000000001%" id="mcps1.3.4.6.2.4.1.3"><p id="cce_02_0236__p1962419396356">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row536445181810"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p445312243268">category</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p3453724122618">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><div class="p" id="cce_02_0236__p2453102422616">Cluster category:<ul id="cce_02_0236__ul345362412265"><li id="cce_02_0236__li13453724192612">CCE: CCE cluster</li><li id="cce_02_0236__li445316242268">Turbo: CCE Turbo cluster</li></ul>
|
|
</div>
|
|
<div class="note" id="cce_02_0236__note1445452418268"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p194541924182615">This parameter is valid in cluster of v1.17.17 or higher.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row7639113912353"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p3639039143513">type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p76391539183511">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p13501152113195">Cluster type.</p>
|
|
<p id="cce_02_0236__p36288482542"><strong id="cce_02_0236__b1562820485542">VirtualMachine</strong>: The master node architecture is x86.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row5117135719491"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p2011765764910">flavor</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p1011715718499">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p980431118507">Cluster flavor, which cannot be changed after the cluster is created.</p>
|
|
<ul id="cce_02_0236__ul4805141115020"><li id="cce_02_0236__cce_02_0236_li14485164815445"><strong id="cce_02_0236__cce_02_0236_b11489836273">cce.s1.small</strong>: small-scale, single-master cluster (≤ 50 nodes)</li><li id="cce_02_0236__cce_02_0236_li64859483443"><strong id="cce_02_0236__cce_02_0236_b367910942720">cce.s1.medium</strong>: medium-scale, single-master cluster (≤ 200 nodes)</li><li id="cce_02_0236__cce_02_0236_li8486648124416"><strong id="cce_02_0236__cce_02_0236_b1081317262919">cce.s2.small</strong>: small-scale, high availability cluster (≤ 50 nodes)</li><li id="cce_02_0236__cce_02_0236_li348664814416"><strong id="cce_02_0236__cce_02_0236_b1689322115296">cce.s2.medium</strong>: medium-scale, high availability cluster (≤ 200 nodes)</li><li id="cce_02_0236__cce_02_0236_li1848684815442"><strong id="cce_02_0236__cce_02_0236_b57413316296">cce.s2.large</strong>: large-scale, high availability cluster (≤ 1,000 nodes)</li><li id="cce_02_0236__cce_02_0236_li15483153111118"><strong id="cce_02_0236__cce_02_0236_b195451031102014">cce.s2.xlarge</strong>: ultra-large-scale, high availability cluster (≤ 2,000 nodes)</li></ul>
|
|
<div class="note" id="cce_02_0236__note4806191195020"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="cce_02_0236__ul13806131119500"><li id="cce_02_0236__li3806161113508">s1: single-master cluster</li><li id="cce_02_0236__li6807141112509">s2: high availability cluster</li><li id="cce_02_0236__li14807101119503">For example, <strong id="cce_02_0236__b16794622013">≤ 50 nodes</strong> indicates that the maximum number of nodes that can be managed by the cluster is 50.</li><li id="cce_02_0236__li10807191112507">A single-master cluster is a cluster that has only one master node. If the master node is down, the cluster will become unavailable and stop serving new workloads. However, existing workloads in the cluster are not affected.</li><li id="cce_02_0236__li98071411175015">A high-availability cluster has multiple master nodes. Faults in a single master node will not take the cluster down.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row767203910354"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p166721839133515">version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p1368643913517">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p14701915145510">Cluster's baseline Kubernetes version. The latest version is recommended.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row53881265396"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p7499692395">platformVersion</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p149979133919">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p114995918397">Version of the CCE cluster platform, which is for viewing only and cannot be specified during cluster creation. The latest platform version corresponding to the cluster version is automatically selected during cluster creation.</p>
|
|
<div class="p" id="cce_02_0236__p8865192034417">Value format: <strong id="cce_02_0236__b48669207446">cce.X.Y</strong><ul id="cce_02_0236__ul786615209447"><li id="cce_02_0236__li18866182017441"><strong id="cce_02_0236__b138661420174417">X</strong> indicates the quarterly or regularly feature version number, starting from 1.</li><li id="cce_02_0236__li88661920124419"><strong id="cce_02_0236__b12866112064415">Y</strong> indicates the patch version of the cluster, starting from 0 (feature version). Other values indicate later patch versions after the feature version is released.</li></ul>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row261134371220"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p187801454171211">legacyVersion</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p1780125401210">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p07801254181220">Details:</p>
|
|
<p id="cce_02_0236__p37801542122">(Deprecated) Outdated version of CCE clusters, which serves no practical purpose and is only used to showcase the cluster version and platform version combination. The version number is globally unique. For example, if the cluster version is va.b and the platformVersion is cce.X.Y, the value of legacyVersion is va.b.X-rY.</p>
|
|
<p id="cce_02_0236__p17780954171220">Constraints:</p>
|
|
<p id="cce_02_0236__p1878125461214">None</p>
|
|
<p id="cce_02_0236__p178115451218">Options:</p>
|
|
<p id="cce_02_0236__p87811254111217">N/A</p>
|
|
<p id="cce_02_0236__p1781754191220">Default value:</p>
|
|
<p id="cce_02_0236__p978145410128">N/A</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row9686193912354"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p5686133953518">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p370263913354">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p1370233913517">Cluster description.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row8784222563"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p87835545617">customSan</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p478313585613">Array of strings</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p2078305185612">Custom SAN field in the server certificate of the cluster API server, which must comply with the SSL and X509 format specifications.</p>
|
|
<ol id="cce_02_0236__ol117832525615"><li id="cce_02_0236__li127834514562">Duplicate names are not allowed.</li><li id="cce_02_0236__li1978320511562">Must comply with the IP address and domain name formats.</li></ol>
|
|
<p id="cce_02_0236__p1478313515619">example: SAN 1: DNS Name=example.com SAN 2: DNS Name=www.example.com SAN 3: DNS Name=example.net SAN 4: IP Address=93.184.216.34</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row2549173892612"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p181548333122">ipv6enable</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p18154173311127">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p14159181552117">Whether the cluster supports IPv6 addresses. This field is supported in clusters of v1.25 and later versions.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row770233993516"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p871733903513">hostNetwork</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p77172039133514"><a href="#cce_02_0236__table14385916163118">hostNetwork</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p373417399356">Node network parameters.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row97341339143516"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p1773433923516">containerNetwork</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p19734539193517"><a href="#cce_02_0236__table882310145412">containerNetwork</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p12749539163518">Container network parameters.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row623165542619"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p1245112501418">eniNetwork</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p72451025161414"><a href="#cce_02_0236__table97937811553">EniNetwork</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p13510202715618">Configuration of Cloud Native Network 2.0. Specify this field when creating a CCE Turbo cluster.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row6111350121711"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p567412459716">publicAccess</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p176747451871"><a href="#cce_02_0236__response_PublicAccess">PublicAccess</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p51121750201714">Cluster API access control.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row2751113913367"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p167519392363">authentication</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p87512392363"><a href="#cce_02_0236__table7220112133716">authentication</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p175133914366">Configurations of the cluster authentication mode.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row591414201496"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p725352519911">billingMode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p32531825295">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p3253162511916">Billing mode of a node.</p>
|
|
<div class="note" id="cce_02_0236__note20254925394"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p17254112516910">This field is not supported for the current version.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row152269299256"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p125808301229">masters</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p185804306221">Array of <a href="#cce_02_0236__response_MasterSpec">MasterSpec</a> objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p558017308229">Advanced configurations of the master node.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row41742581998"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p12478124151010">kubernetesSvcIpRange</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p6175155812919">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p1828218189101">Service CIDR block or the IP address range which the kubernetes clusterIp must fall within. This parameter is available only for clusters of v1.11.7 and later.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row0171162319272"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p13592387156">kubeProxyMode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p65920851519">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p1912138191611">Service forwarding mode. Two modes are available:</p>
|
|
<ul id="cce_02_0236__ul1912738101620"><li id="cce_02_0236__li131263813169"><strong id="cce_02_0236__b141263810163">iptables</strong>: Traditional kube-proxy uses iptables rules to implement service load balancing. In this mode, too many iptables rules will be generated when many services are deployed. In addition, non-incremental updates will cause a latency and even obvious performance issues in the case of heavy service traffic.</li><li id="cce_02_0236__li41293821611"><strong id="cce_02_0236__b312173821614">ipvs</strong>: Optimized kube-proxy mode with higher throughput and faster speed. This mode supports incremental updates and can keep connections uninterrupted during service updates. It is suitable for large-sized clusters.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row2639175641111"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p77011441498">az</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p57011441897">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p147011644098">AZ. This field is returned only for a query.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row15145181082615"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p3764239143515">extendParam</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p127641039153517"><a href="#cce_02_0236__table0102129153810">extendParam</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p378014396351">Extended fields in the format of key-value pairs.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row14524183215262"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p142721448112617">supportIstio</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p327214812610">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p1827214485268">Whether Istio is supported.</p>
|
|
<div class="note" id="cce_02_0236__note4524203310278"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p95244337278">This field is not supported for the current version.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row17820142917610"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p208208291767">deletionProtection</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p882052915617">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p19787169115717"><strong id="cce_02_0236__b1578719965718">Details</strong>:</p>
|
|
<p id="cce_02_0236__p207878955712">Cluster deletion protection, which prevents the deletion of a cluster when this function is enabled</p>
|
|
<p id="cce_02_0236__p87873910575"><strong id="cce_02_0236__b1278710911571">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p17876910579">None</p>
|
|
<p id="cce_02_0236__p11787391575"><strong id="cce_02_0236__b57872914571">Options</strong>:</p>
|
|
<ul id="cce_02_0236__ul7787179145719"><li id="cce_02_0236__li197871397576"><p id="cce_02_0236__p167871091577"><a name="cce_02_0236__li197871397576"></a><a name="li197871397576"></a><strong id="cce_02_0236__b15787209125714">true</strong>: Cluster deletion protection is enabled.</p>
|
|
</li><li id="cce_02_0236__li1278711935716"><p id="cce_02_0236__p12787699573"><a name="cce_02_0236__li1278711935716"></a><a name="li1278711935716"></a><strong id="cce_02_0236__b127871099571">false</strong>: Cluster deletion protection is disabled.</p>
|
|
</li></ul>
|
|
<p id="cce_02_0236__p207871592577"><strong id="cce_02_0236__b178714985715">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p8787291570">false</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row13255111162215"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.4.6.2.4.1.1 "><p id="cce_02_0236__p393015343610">configurationsOverride</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="cce_02_0236__p199306346616">Array of <a href="#cce_02_0236__response_PackageConfiguration">PackageConfiguration</a> objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.00000000000001%" headers="mcps1.3.4.6.2.4.1.3 "><p id="cce_02_0236__p993053413615"><strong id="cce_02_0236__b1693093417612">Details</strong>:</p>
|
|
<p id="cce_02_0236__p393016349611">Overrides the default component configurations in a cluster.</p>
|
|
<p id="cce_02_0236__p99301634269"><strong id="cce_02_0236__b1993043418619">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p1693019348614">If you specify a component or parameter that is not supported, the configuration item will be ignored.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table14385916163118"></a><a name="table14385916163118"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table14385916163118" frame="border" border="1" rules="all"><caption><b>Table 20 </b>Data structure of the <strong id="cce_02_0236__b153851016133119">hostNetwork</strong> field</caption><thead align="left"><tr id="cce_02_0236__row1538511623118"><th align="left" class="cellrowborder" valign="top" width="22.99%" id="mcps1.3.4.7.2.4.1.1"><p id="cce_02_0236__p23861716203112">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.490000000000002%" id="mcps1.3.4.7.2.4.1.2"><p id="cce_02_0236__p1638621620312">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="55.52%" id="mcps1.3.4.7.2.4.1.3"><p id="cce_02_0236__p738651610318">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row6386616173117"><td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.7.2.4.1.1 "><p id="cce_02_0236__p0386141615311">vpc</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.490000000000002%" headers="mcps1.3.4.7.2.4.1.2 "><p id="cce_02_0236__p4386716113119">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.52%" headers="mcps1.3.4.7.2.4.1.3 "><p id="cce_02_0236__p11386316133118">ID of the VPC used to create a master node. The VPC ID is obtained from <a href="cce_02_0100.html">Creating a VPC and Subnet</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row12386141633110"><td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.7.2.4.1.1 "><p id="cce_02_0236__p538611164313">subnet</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.490000000000002%" headers="mcps1.3.4.7.2.4.1.2 "><p id="cce_02_0236__p6387121610319">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.52%" headers="mcps1.3.4.7.2.4.1.3 "><p id="cce_02_0236__p17387316183110">Network ID of the subnet. The value is obtained from <a href="cce_02_0100.html">Creating a VPC and Subnet</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row84291052103113"><td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.7.2.4.1.1 "><p id="cce_02_0236__p13853161510596">SecurityGroup</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.490000000000002%" headers="mcps1.3.4.7.2.4.1.2 "><p id="cce_02_0236__p148539152594">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="55.52%" headers="mcps1.3.4.7.2.4.1.3 "><p id="cce_02_0236__p204301156173319">Default worker node security group ID of the cluster. If specified, the cluster will be bound to the target security group. Otherwise, the system will automatically create a default worker node security group for you. The default worker node security group needs to allow access from certain ports to ensure normal communications.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table97937811553"></a><a name="table97937811553"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table97937811553" frame="border" border="1" rules="all"><caption><b>Table 21 </b>EniNetwork</caption><thead align="left"><tr id="cce_02_0236__row157931588552"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.8.2.5.1.1"><p id="cce_02_0236__p1579368195516">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.8.2.5.1.2"><p id="cce_02_0236__p1179311875512">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.8.2.5.1.3"><p id="cce_02_0236__p5793281557">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.8.2.5.1.4"><p id="cce_02_0236__p37931487556">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row197938895510"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="cce_02_0236__p579312825517">eniSubnetId</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="cce_02_0236__p15793783551">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="cce_02_0236__p9794487559">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="cce_02_0236__p14794187551">IPv4 Subnet ID of the ENI container subnet. Currently, IPv6 is not supported.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row9794128165518"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.1 "><p id="cce_02_0236__p15794889555">eniSubnetCIDR</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.2 "><p id="cce_02_0236__p147942816554">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.8.2.5.1.3 "><p id="cce_02_0236__p3794198165510">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.8.2.5.1.4 "><p id="cce_02_0236__p17949845519">ENI subnet CIDR block.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__response_PublicAccess"></a><a name="response_PublicAccess"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__response_PublicAccess" frame="border" border="1" rules="all"><caption><b>Table 22 </b>PublicAccess</caption><thead align="left"><tr id="cce_02_0236__row1099284417714"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.4.1.1"><p id="cce_02_0236__p1074744191815">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.9.2.4.1.2"><p id="cce_02_0236__p197415449180">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.9.2.4.1.3"><p id="cce_02_0236__p1274944151813">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row129925441379"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.1 "><p id="cce_02_0236__p1756011812171">cidrs</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.9.2.4.1.2 "><p id="cce_02_0236__p145601385179">Array of strings</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.9.2.4.1.3 "><p id="cce_02_0236__p195601588175">Trustlist of network CIDRs that are allowed to access cluster APIs. You are advised to allow the traffic from VPC and container network CIDRs. By default, no trustlist is configured, and the value is ["0.0.0.0/0"].</p>
|
|
<div class="note" id="cce_02_0236__note15560148141719"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p45619841713">This parameter is valid only when a cluster is created.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table7220112133716"></a><a name="table7220112133716"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table7220112133716" width="100%" frame="border" border="1" rules="all"><caption><b>Table 23 </b>Data structure of the <strong id="cce_02_0236__b11912121884611">authentication</strong> field</caption><thead align="left"><tr id="cce_02_0236__row7252191263710"><th align="left" class="cellrowborder" valign="top" width="25.252525252525253%" id="mcps1.3.4.10.2.4.1.1"><p id="cce_02_0236__p162521412143717">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.202020202020204%" id="mcps1.3.4.10.2.4.1.2"><p id="cce_02_0236__p925241243714">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="54.545454545454554%" id="mcps1.3.4.10.2.4.1.3"><p id="cce_02_0236__p22521112163712">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row12679127377"><td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.10.2.4.1.1 "><p id="cce_02_0236__p426711263719">mode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.10.2.4.1.2 "><p id="cce_02_0236__p826791263713">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.545454545454554%" headers="mcps1.3.4.10.2.4.1.3 "><p id="cce_02_0236__p9613105172620">Cluster authentication mode.</p>
|
|
<ul id="cce_02_0236__ul851344502618"><li id="cce_02_0236__li11297756122618">Clusters of Kubernetes v1.11 or earlier support <strong id="cce_02_0236__b11446947027">rbac</strong>, and <strong id="cce_02_0236__b131547533219">authenticating_proxy</strong>. </li><li id="cce_02_0236__li15513204511267">Clusters of Kubernetes v1.13 support <strong id="cce_02_0236__b9936306314">rbac</strong> and <strong id="cce_02_0236__b09381401336">authenticating_proxy</strong>. The default value is <strong id="cce_02_0236__b181096471934">rbac</strong>.</li><li id="cce_02_0236__li725316421218">Clusters of Kubernetes v1.15 or later support <strong id="cce_02_0236__b79926121218"> rbac</strong> and <strong id="cce_02_0236__b6107262125">authenticating_proxy</strong>. The default value is <strong id="cce_02_0236__b1210172651215">rbac</strong>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__response_MasterSpec"></a><a name="response_MasterSpec"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__response_MasterSpec" frame="border" border="1" rules="all"><caption><b>Table 24 </b>MasterSpec</caption><thead align="left"><tr id="cce_02_0236__row1881162932217"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.11.2.4.1.1"><p id="cce_02_0236__p3608173052220">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.11.2.4.1.2"><p id="cce_02_0236__p166091830182217">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.4.11.2.4.1.3"><p id="cce_02_0236__p8609193019223">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row148111129122218"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.1 "><p id="cce_02_0236__p360973052215">availabilityZone</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.11.2.4.1.2 "><p id="cce_02_0236__p156091430182217">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.4.11.2.4.1.3 "><p id="cce_02_0236__p182740555108">Availability Zone.</p>
|
|
<pre class="screen" id="cce_02_0236__screen14339450552">"masters": [
|
|
{
|
|
"availabilityZone": "eu-de-01"
|
|
},
|
|
{
|
|
"availabilityZone": "eu-de-01"
|
|
},
|
|
{
|
|
"availabilityZone": "eu-de-02"
|
|
}
|
|
],</pre>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table0102129153810"></a><a name="table0102129153810"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table0102129153810" frame="border" border="1" rules="all"><caption><b>Table 25 </b>Data structure of the extendParam field</caption><thead align="left"><tr id="cce_02_0236__row81032096382"><th align="left" class="cellrowborder" valign="top" width="19.59%" id="mcps1.3.4.12.2.4.1.1"><p id="cce_02_0236__p410369123818">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.740000000000002%" id="mcps1.3.4.12.2.4.1.2"><p id="cce_02_0236__p310317973810">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="58.67%" id="mcps1.3.4.12.2.4.1.3"><p id="cce_02_0236__p5104209103816">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row101045918387"><td class="cellrowborder" valign="top" width="19.59%" headers="mcps1.3.4.12.2.4.1.1 "><p id="cce_02_0236__p010419933820">clusterAZ</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.4.12.2.4.1.2 "><p id="cce_02_0236__p1010412916388">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.67%" headers="mcps1.3.4.12.2.4.1.3 "><p id="cce_02_0236__p110413993815">If you want to enable multiple AZs for the cluster, enter {"clusterAZ": "multi_az"}.</p>
|
|
<div class="note" id="cce_02_0236__note2010439103815"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p2104598383">Only HA clusters support multiple AZs. To be specific, this field can be configured only when the <strong id="cce_02_0236__b410417943816">flavor</strong> field in <a href="#cce_02_0236__table1034041612134">Table 5</a> is set to <strong id="cce_02_0236__b191049963818">cce.s2.small</strong>, <strong id="cce_02_0236__b10105493386">cce.s2.medium</strong>, <strong id="cce_02_0236__b151052923816">cce.s2.large</strong>, <strong id="cce_02_0236__b110511916384">cce.t2.small</strong>, <strong id="cce_02_0236__b4105399386">cce.t2.medium</strong>, or <strong id="cce_02_0236__b10105129193813">cce.t2.large</strong>. After multi-AZ deployment is enabled, the three master nodes of the cluster are distributed in different AZs. The cluster remains available even when one of the AZs is down.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row161058923820"><td class="cellrowborder" valign="top" width="19.59%" headers="mcps1.3.4.12.2.4.1.1 "><p id="cce_02_0236__p810516914387">dssMasterVolumes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.4.12.2.4.1.2 "><p id="cce_02_0236__p101061191384">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.67%" headers="mcps1.3.4.12.2.4.1.3 "><p id="cce_02_0236__p6106294381">Whether the system and data disks of a master node use dedicated distributed storage. If this parameter is omitted or left unspecified, EVS disks are used by default.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row15270929164517"><td class="cellrowborder" valign="top" width="19.59%" headers="mcps1.3.4.12.2.4.1.1 "><p id="cce_02_0236__p11352163012457">kubeProxyMode</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.4.12.2.4.1.2 "><p id="cce_02_0236__p133527309454">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.67%" headers="mcps1.3.4.12.2.4.1.3 "><p id="cce_02_0236__p143525302450">Service forwarding mode. Two modes are available:</p>
|
|
<ul id="cce_02_0236__ul20352133012457"><li id="cce_02_0236__li4352133017453"><strong id="cce_02_0236__b1352153013452">iptables</strong>: Traditional kube-proxy uses iptables rules to implement service load balancing. In this mode, too many iptables rules will be generated when many Services are deployed. In addition, non-incremental updates will cause a latency and even tangible performance issues in the case of service traffic spikes.</li><li id="cce_02_0236__li19352143010454"><strong id="cce_02_0236__b535243004512">ipvs</strong>: Optimized kube-proxy mode with higher throughput and faster speed. This mode supports incremental updates and can keep connections uninterrupted during service updates. It is suitable for large-sized clusters.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row2010619103816"><td class="cellrowborder" valign="top" width="19.59%" headers="mcps1.3.4.12.2.4.1.1 "><p id="cce_02_0236__p207671018163110">clusterExternalIP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.4.12.2.4.1.2 "><p id="cce_02_0236__p3106159153812">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.67%" headers="mcps1.3.4.12.2.4.1.3 "><p id="cce_02_0236__p139831857192418">EIP used to access the cluster.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row13724113447"><td class="cellrowborder" valign="top" width="19.59%" headers="mcps1.3.4.12.2.4.1.1 "><p id="cce_02_0236__p28741320104611">alpha.cce/fixPoolMask</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.4.12.2.4.1.2 "><p id="cce_02_0236__p0874192084619">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.67%" headers="mcps1.3.4.12.2.4.1.3 "><p id="cce_02_0236__p68842584426">Number of mask bits of the fixed IP address pool of the container network model. This field is supported only for the VPC network model (vpc-router).</p>
|
|
<p id="cce_02_0236__p13884358114216">This parameter determines the number of container IP addresses that can be allocated to a node. The maximum number of pods that can be created on a node is decided by this parameter and maxPods set during node creation.</p>
|
|
<p id="cce_02_0236__p7884358194217">The value is an integer ranging from 24 to 28.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1695033121412"><td class="cellrowborder" valign="top" width="19.59%" headers="mcps1.3.4.12.2.4.1.1 "><p id="cce_02_0236__p0950332149">kubernetes.io/cpuManagerPolicy</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.4.12.2.4.1.2 "><p id="cce_02_0236__p4951234148">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.67%" headers="mcps1.3.4.12.2.4.1.3 "><p id="cce_02_0236__p1863495714155">Cluster CPU management policy. The value can be <strong id="cce_02_0236__b206771441161">none</strong> or <strong id="cce_02_0236__b7197154111610">static</strong>. The default value is <strong id="cce_02_0236__b14695838161620">none</strong>.</p>
|
|
<ul id="cce_02_0236__ul1466125410154"><li id="cce_02_0236__li946620545151"><strong id="cce_02_0236__b185691923141614">none</strong>: CPU cores will not be exclusively allocated to workload pods. Select this value if you want a large pool of shareable CPU cores.</li><li id="cce_02_0236__li14466195441514"><strong id="cce_02_0236__b1698892811614">static</strong>: CPU cores can be exclusively allocated to workload pods. Select this value if your workload is sensitive to latency in CPU cache and scheduling.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row79861510101510"><td class="cellrowborder" valign="top" width="19.59%" headers="mcps1.3.4.12.2.4.1.1 "><p id="cce_02_0236__p389455522417">upgradefrom</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.4.12.2.4.1.2 "><p id="cce_02_0236__p13741720122514">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.67%" headers="mcps1.3.4.12.2.4.1.3 "><p id="cce_02_0236__p7894135518241">Reserved. This field is returned only for a query.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table6749834132215"></a><a name="table6749834132215"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table6749834132215" width="100%" frame="border" border="1" rules="all"><caption><b>Table 26 </b>Data structure of the <strong id="cce_02_0236__b59711736135011">status</strong> field</caption><thead align="left"><tr id="cce_02_0236__row14749534122218"><th align="left" class="cellrowborder" valign="top" width="25.252525252525253%" id="mcps1.3.4.13.2.4.1.1"><p id="cce_02_0236__p37490340223">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.202020202020204%" id="mcps1.3.4.13.2.4.1.2"><p id="cce_02_0236__p7749734112218">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="54.545454545454554%" id="mcps1.3.4.13.2.4.1.3"><p id="cce_02_0236__p67491034152211">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row1749834132213"><td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.13.2.4.1.1 "><p id="cce_02_0236__p16749153410220">phase</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.13.2.4.1.2 "><p id="cce_02_0236__p4749193482216">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.545454545454554%" headers="mcps1.3.4.13.2.4.1.3 "><p id="cce_02_0236__p19996100113820">Cluster status. Possible values:</p>
|
|
<ul id="cce_02_0236__ul954920813385"><li id="cce_02_0236__li100912163818"><strong id="cce_02_0236__b1490361952318">Available</strong>: The cluster is running properly.</li><li id="cce_02_0236__li6188523133814"><strong id="cce_02_0236__b11507102716231">Unavailable</strong>: The cluster is exhibiting unexpected behavior.</li><li id="cce_02_0236__li649426113819"><strong id="cce_02_0236__b1277171719249">ScalingUp</strong>: Nodes are being added to the cluster.</li><li id="cce_02_0236__li2896132853810"><strong id="cce_02_0236__b1376363119242">ScalingDown</strong>: The cluster is being downsized to fewer nodes.</li><li id="cce_02_0236__li15646103143819"><strong id="cce_02_0236__b139541128192817">Creating</strong>: The cluster is being created.</li><li id="cce_02_0236__li6622435133811"><strong id="cce_02_0236__b3795163611280">Deleting</strong>: The cluster is being deleted.</li><li id="cce_02_0236__li1617693833820"><strong id="cce_02_0236__b1359145216284">Upgrading</strong>: The cluster is being upgraded.</li><li id="cce_02_0236__li4866114312382"><strong id="cce_02_0236__b1971185942813">Empty</strong>: The cluster has no resources.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row77494342221"><td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.13.2.4.1.1 "><p id="cce_02_0236__p6749143432216">jobID</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.13.2.4.1.2 "><p id="cce_02_0236__p117745018256">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.545454545454554%" headers="mcps1.3.4.13.2.4.1.3 "><p id="cce_02_0236__p1774918349229">ID of the cluster creation job. You can <a href="cce_02_0247.html">query job progress</a> by job ID to keep updated on cluster creation progress.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row767910437497"><td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.13.2.4.1.1 "><p id="cce_02_0236__p96724434499">deleteOption</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.13.2.4.1.2 "><p id="cce_02_0236__p19672243154918">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.545454545454554%" headers="mcps1.3.4.13.2.4.1.3 "><p id="cce_02_0236__p367214317497">Whether to delete configurations. This parameter is contained only in the response to the deletion request.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row8678114317493"><td class="cellrowborder" valign="top" width="25.252525252525253%" headers="mcps1.3.4.13.2.4.1.1 "><p id="cce_02_0236__p14673174394914">deleteStatus</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.13.2.4.1.2 "><p id="cce_02_0236__p2673154320496">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.545454545454554%" headers="mcps1.3.4.13.2.4.1.3 "><p id="cce_02_0236__p16673144316495">Whether to delete the status information. This parameter is contained only in the response to the deletion request.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__response_PackageConfiguration"></a><a name="response_PackageConfiguration"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__response_PackageConfiguration" frame="border" border="1" rules="all"><caption><b>Table 27 </b>PackageConfiguration</caption><thead align="left"><tr id="cce_02_0236__row3693153419616"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.14.2.4.1.1"><p id="cce_02_0236__p1493963420620">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.14.2.4.1.2"><p id="cce_02_0236__p893983419616">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.14.2.4.1.3"><p id="cce_02_0236__p593963416617">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row166931034862"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.14.2.4.1.1 "><p id="cce_02_0236__p10939153411613">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.14.2.4.1.2 "><p id="cce_02_0236__p16939934762">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.14.2.4.1.3 "><p id="cce_02_0236__p16939203414617"><strong id="cce_02_0236__b493916346613">Details</strong>:</p>
|
|
<p id="cce_02_0236__p3939143420613">Component name</p>
|
|
<p id="cce_02_0236__p14939103419613"><strong id="cce_02_0236__b17939143413616">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p1893910341564">None</p>
|
|
<p id="cce_02_0236__p189394341367"><strong id="cce_02_0236__b69391134961">Options</strong>:</p>
|
|
<p id="cce_02_0236__p1793917341664">N/A</p>
|
|
<p id="cce_02_0236__p993917349619"><strong id="cce_02_0236__b6939334260">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p79394342069">N/A</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row26931934760"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.14.2.4.1.1 "><p id="cce_02_0236__p793910341260">configurations</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.14.2.4.1.2 "><p id="cce_02_0236__p893983410618">Array of <a href="#cce_02_0236__response_ConfigurationItem">ConfigurationItem</a> objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.14.2.4.1.3 "><p id="cce_02_0236__p1193915342612"><strong id="cce_02_0236__b1993911342614">Details</strong>:</p>
|
|
<p id="cce_02_0236__p593910341761">Component configuration items</p>
|
|
<p id="cce_02_0236__p14939103413611"><strong id="cce_02_0236__b1193914348611">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p109391534161">None</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__response_ConfigurationItem"></a><a name="response_ConfigurationItem"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__response_ConfigurationItem" frame="border" border="1" rules="all"><caption><b>Table 28 </b>ConfigurationItem</caption><thead align="left"><tr id="cce_02_0236__row569363411614"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.15.2.4.1.1"><p id="cce_02_0236__p169395348610">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.15.2.4.1.2"><p id="cce_02_0236__p89398346615">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.15.2.4.1.3"><p id="cce_02_0236__p1093933412610">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row1169320341561"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.15.2.4.1.1 "><p id="cce_02_0236__p179391234560">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.15.2.4.1.2 "><p id="cce_02_0236__p11940103415612">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.15.2.4.1.3 "><p id="cce_02_0236__p169401434164"><strong id="cce_02_0236__b894033415612">Details</strong>:</p>
|
|
<p id="cce_02_0236__p6940153420610">Configuration overrides of the default components in a cluster.</p>
|
|
<p id="cce_02_0236__p209401734569"><strong id="cce_02_0236__b894013342619">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p13940163416611">If you specify a component or parameter that is not supported, this configuration item will be ignored.</p>
|
|
<p id="cce_02_0236__p1894016341567"><strong id="cce_02_0236__b169401134567">Options</strong>:</p>
|
|
<p id="cce_02_0236__p1694017345611">N/A</p>
|
|
<p id="cce_02_0236__p1094053415611"><strong id="cce_02_0236__b494063418615">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p149409343616">N/A</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row1469317341161"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.15.2.4.1.1 "><p id="cce_02_0236__p169401334869">value</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.15.2.4.1.2 "><p id="cce_02_0236__p13940193419615">AnyType</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.15.2.4.1.3 "><p id="cce_02_0236__p8940123416611"><strong id="cce_02_0236__b8940183420613">Details</strong>:</p>
|
|
<p id="cce_02_0236__p16940834566">Configuration overrides of the default components in a cluster.</p>
|
|
<p id="cce_02_0236__p209401734466"><strong id="cce_02_0236__b11940634063">Constraints</strong>:</p>
|
|
<p id="cce_02_0236__p294023411615">If you specify a component or parameter that is not supported, this configuration item will be ignored.</p>
|
|
<p id="cce_02_0236__p894017345616"><strong id="cce_02_0236__b09405349610">Options</strong>:</p>
|
|
<p id="cce_02_0236__p1940103419611">N/A</p>
|
|
<p id="cce_02_0236__p8940133416618"><strong id="cce_02_0236__b294016341366">Default value</strong>:</p>
|
|
<p id="cce_02_0236__p99406342618">N/A</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="cce_02_0236__section0128952114111"><h4 class="sectiontitle">Example Responses</h4><p id="cce_02_0236__p14167114311423"><strong id="cce_02_0236__b6167843184210">Status code: 201</strong></p>
|
|
<p id="cce_02_0236__p116754315429">The cluster creation job is successfully delivered.</p>
|
|
<pre class="screen" id="cce_02_0236__screen1714945220429">{
|
|
"kind" : "Cluster",
|
|
"apiVersion" : "v3",
|
|
"metadata" : {
|
|
"name" : "cluster",
|
|
"uid" : "1df09f9a-5b9e-11ef-8f52-0255ac10003e",
|
|
"creationTimestamp" : "2024-08-16 07:06:53.704389459 +0000 UTC",
|
|
"updateTimestamp" : "2024-08-16 07:06:53.704389529 +0000 UTC",
|
|
"annotations" : {
|
|
"jobid" : "1e50bfbe-5b9e-11ef-8f52-0255ac10003e",
|
|
"resourceJobId" : "1df0ec6b-5b9e-11ef-8f52-0255ac10003e"
|
|
},
|
|
"timezone" :
|
|
},
|
|
"spec" : {
|
|
"publicAccess" : { },
|
|
"category" : "CCE",
|
|
"type" : "VirtualMachine",
|
|
"enableAutopilot" : false,
|
|
"flavor" : "cce.s1.small",
|
|
"version" : "v1.29",
|
|
"platformVersion" : "cce.4.0",
|
|
"configurationsOverride" : [ {
|
|
"name" : "kube-apiserver",
|
|
"configurations" : [ {
|
|
"name" : "support-overload",
|
|
"value" : true
|
|
} ]
|
|
<span id="cce_02_0236__ph1693022384318"> },{ </span>
|
|
<span id="cce_02_0236__ph119301023164319"> "name": "eni",</span>
|
|
<span id="cce_02_0236__ph1593082311433"> "configurations": [ {</span>
|
|
<span id="cce_02_0236__ph1593015238433"><strong id="cce_02_0236__b58001246466"> "name": "dataplane-v2", </strong></span>
|
|
<span id="cce_02_0236__ph7930223144310"><strong id="cce_02_0236__b2800152414462"> "value": true</strong></span>
|
|
<span id="cce_02_0236__ph893052314438"> } ]</span>
|
|
} ],
|
|
"hostNetwork" : {
|
|
"vpc" : "0538a5d0-9a65-4c1d-a8bf-e9acee237980",
|
|
"subnet" : "bc81be88-6e34-4b02-83bd-df0a1f7672c5"
|
|
},
|
|
"containerNetwork" : {
|
|
"mode" : "vpc-router",
|
|
"cidr" : "172.17.0.0/16",
|
|
"cidrs" : [ {
|
|
"cidr" : "172.17.0.0/16"
|
|
} ]
|
|
},
|
|
"eniNetwork" : { },
|
|
"serviceNetwork" : {
|
|
"IPv4CIDR" : "10.247.0.0/16"
|
|
},
|
|
"authentication" : {
|
|
"mode" : "rbac",
|
|
"authenticatingProxy" : { }
|
|
},
|
|
"billingMode" : 0,
|
|
"kubernetesSvcIpRange" : "10.247.0.0/16",
|
|
"kubeProxyMode" : "iptables",
|
|
"extendParam" : {
|
|
"alpha.cce/fixPoolMask" : "25",
|
|
"enterpriseProjectId" : "0",
|
|
"orderID" : ""
|
|
}
|
|
},
|
|
"status" : {
|
|
"phase" : "Creating",
|
|
"jobID" : "1e50bfbe-5b9e-11ef-8f52-0255ac10003e"
|
|
}
|
|
}</pre>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__table1873418287490"></a><a name="table1873418287490"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__table1873418287490" frame="border" border="1" rules="all"><caption><b>Table 29 </b>Parameter Description</caption><thead align="left"><tr id="cce_02_0236__row8734152810495"><th align="left" class="cellrowborder" valign="top" width="33.33%" id="mcps1.3.5.5.2.3.1.1"><p id="cce_02_0236__p773419289491">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="66.67%" id="mcps1.3.5.5.2.3.1.2"><p id="cce_02_0236__p77341828144919">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__row197341228114916"><td class="cellrowborder" valign="top" width="33.33%" headers="mcps1.3.5.5.2.3.1.1 "><p id="cce_02_0236__p13735142819497">support-overload</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="66.67%" headers="mcps1.3.5.5.2.3.1.2 "><p id="cce_02_0236__p105911418125">Cluster overload control. After this function is enabled, CCE will dynamically adjust concurrent requests based on the resource demands received by master nodes to ensure the stability and reliability of the master nodes and the cluster.</p>
|
|
<p id="cce_02_0236__p16591121161220"><strong id="cce_02_0236__b27861220122910">Configuration suggestion</strong>: Enable this function. In scenarios like short-term request bursts, a cluster may still become overloaded even with overload control enabled. In such cases, you are advised to manage and control access to the cluster promptly.</p>
|
|
<p id="cce_02_0236__p10591121121210"><strong id="cce_02_0236__b891035273910">Applicable cluster version</strong>: This parameter is available only in clusters v1.23 or later.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cce_02_0236__row7735162815494"><td class="cellrowborder" valign="top" width="33.33%" headers="mcps1.3.5.5.2.3.1.1 "><p id="cce_02_0236__p116055911222">dataplane-v2 (supported by clusters using the VPC networks)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="66.67%" headers="mcps1.3.5.5.2.3.1.2 "><p id="cce_02_0236__p91603592228">eBPF is used at the kernel layer for Kubernetes network acceleration, enhancing high-performance service communication through ClusterIP Services, precise traffic control via network policies, and intelligent bandwidth management with egress bandwidth.</p>
|
|
<p id="cce_02_0236__p17160155917229">This function has the restrictions below. </p>
|
|
<ul id="cce_02_0236__ul1916012592221"><li id="cce_02_0236__li12160205911225">Restrictions on clusters: This function can be enabled only for clusters v1.27.16-r30, v1.28.15-r20, v1.29.13-r0, v1.30.10-r0, v1.31.6-r0, or later that use VPC networks.</li><li id="cce_02_0236__li171601159182219">Restrictions on memory: After this function is enabled, CCE will automatically deploy the cilium-agent on every node in a cluster. Each cilium-agent will use 80 MiB of memory, and the memory usage will increase by 10 KiB whenever a new pod is added.</li><li id="cce_02_0236__li416015915226">Restrictions on OSs: After a node is created, it can only use <span id="cce_02_0236__ph356563617436">HCE OS 2.0</span>.</li></ul>
|
|
<div class="note" id="cce_02_0236__note31613595228"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0236__p516118594228">CCE DataPlane V2 is released with restrictions. To use this feature, submit a service ticket to CCE.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="cce_02_0236__s50f1049a6a4d404c895cf636eb8f3bf1"><h4 class="sectiontitle">Status Code</h4><p id="cce_02_0236__en-us_topic_0079614900_p21869221"><a href="#cce_02_0236__en-us_topic_0079614900_table46761928">Table 30</a> describes the status code of this API.</p>
|
|
|
|
<div class="tablenoborder"><a name="cce_02_0236__en-us_topic_0079614900_table46761928"></a><a name="en-us_topic_0079614900_table46761928"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0236__en-us_topic_0079614900_table46761928" frame="border" border="1" rules="all"><caption><b>Table 30 </b>Status code</caption><thead align="left"><tr id="cce_02_0236__en-us_topic_0079614900_row33254664"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.6.3.2.3.1.1"><p id="cce_02_0236__p55616028205955">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.6.3.2.3.1.2"><p id="cce_02_0236__p8604418205955">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cce_02_0236__en-us_topic_0079614900_row41084259"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.3.2.3.1.1 "><p id="cce_02_0236__en-us_topic_0079614900_p39490674">201</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.6.3.2.3.1.2 "><p id="cce_02_0236__en-us_topic_0079614900_p44628050">The job for creating a cluster is successfully delivered.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="cce_02_0236__p347213715512">For the description about error status codes, see <a href="cce_02_0084.html">Status Code</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="cce_02_0092.html">Cluster Management</a></div>
|
|
</div>
|
|
</div>
|
|
|