yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
a41a4e0331fbc0beff63bb28fa59228cc9a751df
doc-exports/docs/cce/api-ref/cce_02_0356.html
qiujiandong1 affc0093ff CCE API 20251107 version 
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>
2026-02-17 10:09:34 +00:00

700 lines
54 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

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

<a name="cce_02_0356"></a><a name="cce_02_0356"></a>
<h1 class="topictitle1">Updating a Specified Node Pool</h1>
<div id="body1587440508951"><div class="section" id="cce_02_0356__section1686113493165"><h4 class="sectiontitle">Function</h4><p id="cce_02_0356__p83383918711">This API is used to update a specified node pool.</p>
<div class="note" id="cce_02_0356__note815071332616"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="cce_02_0356__ul118961316938"><li id="cce_02_0356__li38961016438">The URL for cluster management is in the format of <strong id="cce_02_0356__b10265023947">https://Endpoint/uri</strong>. In the URL, <strong id="cce_02_0356__b1879728942">uri</strong> indicates the resource path, that is, the path for API access.</li><li id="cce_02_0356__li1794412813320">Currently, only the node pool name and scaling parameters in <strong id="cce_02_0356__b851413361632">spec</strong> can be updated, such as <strong id="cce_02_0356__b1646012479315">initialNodeCount, autoscaling, name, k8sTags, taints, login</strong>, and <strong id="cce_02_0356__b15323185519315">userTags</strong>.</li></ul>
</div></div>
</div>
<div class="section" id="cce_02_0356__section8403243161416"><h4 class="sectiontitle">URI</h4><p id="cce_02_0356__p23575517439">PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools/{nodepool_id}</p>
<p id="cce_02_0356__p2037362514220"><a href="#cce_02_0356__table127923532918">Table 1</a> describes the parameters of this API.</p>
<div class="tablenoborder"><a name="cce_02_0356__table127923532918"></a><a name="table127923532918"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__table127923532918" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="cce_02_0356__row9792195314913"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.4.2.4.1.1"><p id="cce_02_0356__p07921153694">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_0356__p1979216532917">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_0356__p77922531296">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__row137928532918"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.4.2.4.1.1 "><p id="cce_02_0356__p579295315911">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.2.4.2.4.1.2 "><p id="cce_02_0356__p137927531494">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.2.4.2.4.1.3 "><p id="cce_02_0356__p8793153899">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>
<tr id="cce_02_0356__row1410610454440"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.4.2.4.1.1 "><p id="cce_02_0356__p4106245124416">cluster_id</p>
</td>
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.2.4.2.4.1.2 "><p id="cce_02_0356__p11061345164415">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.2.4.2.4.1.3 "><p id="cce_02_0356__p15106445114416">Cluster ID. For details about how to obtain the cluster ID, see <a href="cce_02_0271.html">How to Obtain Parameters in the API URI</a>.</p>
</td>
</tr>
<tr id="cce_02_0356__row16968171161010"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.4.2.4.1.1 "><p id="cce_02_0356__p196921101017">nodepool_id</p>
</td>
<td class="cellrowborder" valign="top" width="12%" headers="mcps1.3.2.4.2.4.1.2 "><p id="cce_02_0356__p15970201151012">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.3.2.4.2.4.1.3 "><p id="cce_02_0356__p8970111121012">Node pool ID. For details about how to obtain the node pool ID, see <a href="cce_02_0269.html">Listing All Node Pools in a Specified Cluster</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="cce_02_0356__section947084713911"><h4 class="sectiontitle">Request</h4><p id="cce_02_0356__zh-cn_topic_0079614900_p54374860"><strong id="cce_02_0356__b162259487412">Request parameters</strong>:</p>
<p id="cce_02_0356__p132051734919"><a href="#cce_02_0356__table794104818135">Table 2</a> and <a href="#cce_02_0356__table1644211019">Table 3</a> lists the request parameters.</p>
<div class="tablenoborder"><a name="cce_02_0356__table794104818135"></a><a name="table794104818135"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__table794104818135" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameters in the request header</caption><thead align="left"><tr id="cce_02_0356__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_0356__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_0356__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_0356__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_0356__cce_02_0236_p16500154162611">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__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_0356__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_0356__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_0356__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_0356__cce_02_0236_p169801011203416">Message body type (format).</p>
<p id="cce_02_0356__cce_02_0236_p1788220373510">Default: <strong id="cce_02_0356__cce_02_0236_b124918415616">application/json</strong></p>
</td>
</tr>
<tr id="cce_02_0356__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_0356__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_0356__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_0356__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_0356__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_0356__table1644211019"></a><a name="table1644211019"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__table1644211019" frame="border" border="1" rules="all"><caption><b>Table 3 </b>NodePool structure</caption><thead align="left"><tr id="cce_02_0356__row13647211510"><th align="left" class="cellrowborder" valign="top" width="19.06%" id="mcps1.3.3.5.2.5.1.1"><p id="cce_02_0356__p26442115115">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.58%" id="mcps1.3.3.5.2.5.1.2"><p id="cce_02_0356__p91938272444">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.97%" id="mcps1.3.3.5.2.5.1.3"><p id="cce_02_0356__p46415215116">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.39%" id="mcps1.3.3.5.2.5.1.4"><p id="cce_02_0356__p1864192116112">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__row20809211716"><td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.3.3.5.2.5.1.1 "><p id="cce_02_0356__p17569275215">metadata</p>
</td>
<td class="cellrowborder" valign="top" width="11.58%" headers="mcps1.3.3.5.2.5.1.2 "><p id="cce_02_0356__p15200026689">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="24.97%" headers="mcps1.3.3.5.2.5.1.3 "><p id="cce_02_0356__p1334385071712"><a href="#cce_02_0356__table13456192212">metadata</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="44.39%" headers="mcps1.3.3.5.2.5.1.4 "><p id="cce_02_0356__p82961949883">Metadata of the node pool.</p>
</td>
</tr>
<tr id="cce_02_0356__row12484123982118"><td class="cellrowborder" valign="top" width="19.06%" headers="mcps1.3.3.5.2.5.1.1 "><p id="cce_02_0356__p75691778211">spec</p>
</td>
<td class="cellrowborder" valign="top" width="11.58%" headers="mcps1.3.3.5.2.5.1.2 "><p id="cce_02_0356__p519812264814">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="24.97%" headers="mcps1.3.3.5.2.5.1.3 "><p id="cce_02_0356__p1436685371011"><a href="#cce_02_0356__table620623542313">spec</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="44.39%" headers="mcps1.3.3.5.2.5.1.4 "><p id="cce_02_0356__p1829416499817">Parameters of the node pool.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="cce_02_0356__table13456192212"></a><a name="table13456192212"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__table13456192212" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Data structure of the <strong id="cce_02_0356__b1477813513174">metadata</strong> field</caption><thead align="left"><tr id="cce_02_0356__row031056182217"><th align="left" class="cellrowborder" valign="top" width="19.8%" id="mcps1.3.3.6.2.5.1.1"><p id="cce_02_0356__p10814151115613">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.51%" id="mcps1.3.3.6.2.5.1.2"><p id="cce_02_0356__p19813951165614">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.85%" id="mcps1.3.3.6.2.5.1.3"><p id="cce_02_0356__p381265105617">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.84%" id="mcps1.3.3.6.2.5.1.4"><p id="cce_02_0356__p68111951165614">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__row11915579512"><td class="cellrowborder" valign="top" width="19.8%" headers="mcps1.3.3.6.2.5.1.1 "><p id="cce_02_0356__p14915157855">name</p>
</td>
<td class="cellrowborder" valign="top" width="13.51%" headers="mcps1.3.3.6.2.5.1.2 "><p id="cce_02_0356__p1540322987">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="21.85%" headers="mcps1.3.3.6.2.5.1.3 "><p id="cce_02_0356__p15915147656">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.84%" headers="mcps1.3.3.6.2.5.1.4 "><p id="cce_02_0356__p1383013514117">Node pool name.</p>
<p id="cce_02_0356__p783085191119">Naming rule: Enter 1 to 50 characters that starts with a lowercase letter and cannot end with a hyphen (-). Lowercase letters, digits, and hyphens (-) are allowed. The value cannot be <strong id="cce_02_0356__b15830135131110">DefaultPool</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="cce_02_0356__table620623542313"></a><a name="table620623542313"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__table620623542313" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Data structure of the <strong id="cce_02_0356__b11905154481710">spec</strong> field</caption><thead align="left"><tr id="cce_02_0356__row520663552315"><th align="left" class="cellrowborder" valign="top" width="18.23%" id="mcps1.3.3.7.2.5.1.1"><p id="cce_02_0356__p1363450175710">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.41%" id="mcps1.3.3.7.2.5.1.2"><p id="cce_02_0356__p146333017572">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.89%" id="mcps1.3.3.7.2.5.1.3"><p id="cce_02_0356__p26331602573">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="43.47%" id="mcps1.3.3.7.2.5.1.4"><p id="cce_02_0356__p1959819065711">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__row5117192925918"><td class="cellrowborder" valign="top" width="18.23%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0356__p311772965918">initialNodeCount</p>
</td>
<td class="cellrowborder" valign="top" width="12.41%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0356__p1811792915595">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="25.89%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0356__p14117122912595">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="43.47%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0356__p942619415113">Expected number of nodes in this node pool. The value cannot be greater than the maximum number of nodes allowed for the cluster.</p>
</td>
</tr>
<tr id="cce_02_0356__row79521721105"><td class="cellrowborder" valign="top" width="18.23%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0356__p6952525018">autoscaling</p>
</td>
<td class="cellrowborder" valign="top" width="12.41%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0356__p09521821016">No</p>
</td>
<td class="cellrowborder" valign="top" width="25.89%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0356__p1920643502317">autoscaling object</p>
</td>
<td class="cellrowborder" valign="top" width="43.47%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0356__p10423941151110">Auto scaling parameters.</p>
</td>
</tr>
<tr id="cce_02_0356__row12206153513232"><td class="cellrowborder" valign="top" width="18.23%" headers="mcps1.3.3.7.2.5.1.1 "><p id="cce_02_0356__p6206135142317">nodeTemplate</p>
</td>
<td class="cellrowborder" valign="top" width="12.41%" headers="mcps1.3.3.7.2.5.1.2 "><p id="cce_02_0356__p612474161018">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="25.89%" headers="mcps1.3.3.7.2.5.1.3 "><p id="cce_02_0356__p13234357570"><a href="cce_02_0354.html#cce_02_0354__table3150105216225">Table6 Data structure of the nodeTemplate field</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="43.47%" headers="mcps1.3.3.7.2.5.1.4 "><p id="cce_02_0356__p183191542173818">Parameters of the node pool template.</p>
<p id="cce_02_0356__p251151212251">If <strong id="cce_02_0356__cce_02_0354_b913215386244">az </strong>is set to <strong id="cce_02_0356__cce_02_0354_b313283816249">random</strong>, when you create a node pool or update the number of nodes in a node pool, a scaling task is triggered. The system selects an AZ from all AZs where scaling is allowed to add nodes based on priorities.</p>
<div class="p" id="cce_02_0356__p19206135162314">AZs with a smaller number of existing nodes have a higher priority. If AZs have the same number of nodes, the system selects the AZ based on the AZ sequence. Example:<ul id="cce_02_0356__cce_02_0354_ul17620345102116"><li id="cce_02_0356__cce_02_0354_li36201445182118">Creating nodes in a node pool for the first time: Assume that AZ 1, AZ 2, and AZ 3 have available resources. These AZs have the same priority because they have no existing nodes. In this case, AZ 1 is selected by sequence to create all nodes to be added.</li><li id="cce_02_0356__cce_02_0354_li116594579212">Adding nodes to a node pool that already has nodes:<ul id="cce_02_0356__cce_02_0354_ul9304125919217"><li id="cce_02_0356__cce_02_0354_li9453545223">Assume that the node pool has 1 node in AZ 1, 3 in AZ 2, and 2 in AZ 3, and that resources in AZ 1 have been sold out. Only AZ 2 and AZ 3 are available for scaling. In this case, AZ 3 has a higher priority than AZ 2 because AZ 3 has less nodes. Therefore, all nodes to be added will be created in AZ 3.</li><li id="cce_02_0356__cce_02_0354_li98475172114">Assume that the node pool has 1 node in AZ 1, 2 in AZ 2, and 2 in AZ 3, and that resources in AZ 1 have been sold out. Only AZ 2 and AZ 3 are available for scaling. In this case, AZ 2 and AZ 3 have the same priority because they have the same number of nodes. Therefore, all nodes to be added will be created in AZ 2.</li></ul>
</li></ul>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__table1472543502018" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Data structure of the <strong id="cce_02_0356__b2075185120170">autoscaling</strong> field</caption><thead align="left"><tr id="cce_02_0356__row574220353207"><th align="left" class="cellrowborder" valign="top" width="18.888111188881112%" id="mcps1.3.3.8.2.5.1.1"><p id="cce_02_0356__p1436044185710">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.438756124387561%" id="mcps1.3.3.8.2.5.1.2"><p id="cce_02_0356__p16359243573">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="23.807619238076192%" id="mcps1.3.3.8.2.5.1.3"><p id="cce_02_0356__p153581844577">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.86551344865513%" id="mcps1.3.3.8.2.5.1.4"><p id="cce_02_0356__p735715418577">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__row14742113519208"><td class="cellrowborder" valign="top" width="18.888111188881112%" headers="mcps1.3.3.8.2.5.1.1 "><p id="cce_02_0356__p13757103512202">enable</p>
</td>
<td class="cellrowborder" valign="top" width="12.438756124387561%" headers="mcps1.3.3.8.2.5.1.2 "><p id="cce_02_0356__p1296323118192">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.807619238076192%" headers="mcps1.3.3.8.2.5.1.3 "><p id="cce_02_0356__p19773103519202">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="44.86551344865513%" headers="mcps1.3.3.8.2.5.1.4 "><p id="cce_02_0356__p078171181318">Whether to enable auto scaling.</p>
</td>
</tr>
<tr id="cce_02_0356__row33071322119"><td class="cellrowborder" valign="top" width="18.888111188881112%" headers="mcps1.3.3.8.2.5.1.1 "><p id="cce_02_0356__p143071138211">minNodeCount</p>
</td>
<td class="cellrowborder" valign="top" width="12.438756124387561%" headers="mcps1.3.3.8.2.5.1.2 "><p id="cce_02_0356__p0853154813122">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.807619238076192%" headers="mcps1.3.3.8.2.5.1.3 "><p id="cce_02_0356__p730723142112">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.86551344865513%" headers="mcps1.3.3.8.2.5.1.4 "><p id="cce_02_0356__p11781612131">Minimum number of nodes after a scale-down if auto scaling is enabled.</p>
</td>
</tr>
<tr id="cce_02_0356__row264916692110"><td class="cellrowborder" valign="top" width="18.888111188881112%" headers="mcps1.3.3.8.2.5.1.1 "><p id="cce_02_0356__p564956102116">maxNodeCount</p>
</td>
<td class="cellrowborder" valign="top" width="12.438756124387561%" headers="mcps1.3.3.8.2.5.1.2 "><p id="cce_02_0356__p7852648171218">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.807619238076192%" headers="mcps1.3.3.8.2.5.1.3 "><p id="cce_02_0356__p1964956122118">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.86551344865513%" headers="mcps1.3.3.8.2.5.1.4 "><p id="cce_02_0356__p16780191191320">Maximum number of nodes after a scale-up if auto scaling is enabled. The value of this parameter must be greater than or equal to that of <strong id="cce_02_0356__b185811357101317">minNodeCount</strong> and does not exceed the maximum number of nodes for the cluster.</p>
</td>
</tr>
<tr id="cce_02_0356__row170860392"><td class="cellrowborder" valign="top" width="18.888111188881112%" headers="mcps1.3.3.8.2.5.1.1 "><p id="cce_02_0356__p8706123825519">scaleDownCooldownTime</p>
</td>
<td class="cellrowborder" valign="top" width="12.438756124387561%" headers="mcps1.3.3.8.2.5.1.2 "><p id="cce_02_0356__p11851154811124">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.807619238076192%" headers="mcps1.3.3.8.2.5.1.3 "><p id="cce_02_0356__p87011643913">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.86551344865513%" headers="mcps1.3.3.8.2.5.1.4 "><p id="cce_02_0356__p577971111318">Interval during which nodes added after a scale-up will not be deleted, in minutes.</p>
</td>
</tr>
<tr id="cce_02_0356__row20753209193912"><td class="cellrowborder" valign="top" width="18.888111188881112%" headers="mcps1.3.3.8.2.5.1.1 "><p id="cce_02_0356__p1138185216552">priority</p>
</td>
<td class="cellrowborder" valign="top" width="12.438756124387561%" headers="mcps1.3.3.8.2.5.1.2 "><p id="cce_02_0356__p19850348151217">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.807619238076192%" headers="mcps1.3.3.8.2.5.1.3 "><p id="cce_02_0356__p575315915398">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.86551344865513%" headers="mcps1.3.3.8.2.5.1.4 "><p id="cce_02_0356__p57777114137">Node pool weight. A higher weight indicates a higher priority in scale-up.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__table6639183818241" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Data structure of the <strong id="cce_02_0356__b086104184112">nodeTemplate</strong> field</caption><thead align="left"><tr id="cce_02_0356__row20639103819249"><th align="left" class="cellrowborder" valign="top" width="18.47815218478152%" id="mcps1.3.3.9.2.5.1.1"><p id="cce_02_0356__p37365711577">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.818718128187182%" id="mcps1.3.3.9.2.5.1.2"><p id="cce_02_0356__p1873518795711">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="23.837616238376164%" id="mcps1.3.3.9.2.5.1.3"><p id="cce_02_0356__p97342725717">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.86551344865513%" id="mcps1.3.3.9.2.5.1.4"><p id="cce_02_0356__p197331795711">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__row10932152613432"><td class="cellrowborder" valign="top" width="18.47815218478152%" headers="mcps1.3.3.9.2.5.1.1 "><p id="cce_02_0356__p1893232664313">k8sTags</p>
</td>
<td class="cellrowborder" valign="top" width="12.818718128187182%" headers="mcps1.3.3.9.2.5.1.2 "><p id="cce_02_0356__p687685520467">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.837616238376164%" headers="mcps1.3.3.9.2.5.1.3 "><p id="cce_02_0356__p3932102613432"></p>
<p id="cce_02_0356__p1291225013418">Map&lt;String,String&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="44.86551344865513%" headers="mcps1.3.3.9.2.5.1.4 "><p id="cce_02_0356__p5876455194611">Kubernetes label, in the format of key-value pair. A maximum of 20 key-value pairs are allowed.</p>
<ul id="cce_02_0356__ul102539423175"><li id="cce_02_0356__li18253184211714"><strong id="cce_02_0356__b13194738429">Key</strong>: Enter 1 to 63 characters starting with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. A DNS subdomain can be prefixed to a key and contain a maximum of 253 characters. Example DNS subdomain: example.com/my-key.</li><li id="cce_02_0356__li444712449171"><strong id="cce_02_0356__b165341214174212">Value</strong>: The value can be left blank or a string of 1 to 63 characters starting with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed in the character string.</li></ul>
<p id="cce_02_0356__p1644615065413">Example:</p>
<pre class="screen" id="cce_02_0356__screen851218415616">"k8sTags": {
"key": "value"
}</pre>
</td>
</tr>
<tr id="cce_02_0356__row1863534901713"><td class="cellrowborder" valign="top" width="18.47815218478152%" headers="mcps1.3.3.9.2.5.1.1 "><p id="cce_02_0356__p791212501047">userTags</p>
</td>
<td class="cellrowborder" valign="top" width="12.818718128187182%" headers="mcps1.3.3.9.2.5.1.2 "><p id="cce_02_0356__p189124501042">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.837616238376164%" headers="mcps1.3.3.9.2.5.1.3 "><p id="cce_02_0356__p491255019414">Array of <a href="#cce_02_0356__request_UserTag">Table 9</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="44.86551344865513%" headers="mcps1.3.3.9.2.5.1.4 "><p id="cce_02_0356__p891213501345"><strong id="cce_02_0356__b791220501042">Definition</strong></p>
<p id="cce_02_0356__p79121550247">Cloud server resource tags</p>
<p id="cce_02_0356__p991255019411"><strong id="cce_02_0356__b491219503415">Constraints</strong></p>
<ul id="cce_02_0356__ul1091210501345"><li id="cce_02_0356__li0912550747"><p id="cce_02_0356__p119124501441"><a name="cce_02_0356__li0912550747"></a><a name="li0912550747"></a>The key of a tag must be unique. The maximum number of custom tags supported by CCE varies depending on regions and cannot exceed 8.</p>
</li><li id="cce_02_0356__li1691214509416"><p id="cce_02_0356__p5912125012416"><a name="cce_02_0356__li1691214509416"></a><a name="li1691214509416"></a>If this parameter is not specified, the custom cloud server resource tags of the node pool will not be updated.</p>
</li><li id="cce_02_0356__li179121750642"><p id="cce_02_0356__p391216506413"><a name="cce_02_0356__li179121750642"></a><a name="li179121750642"></a>If the parameter is left empty, the custom cloud server resource tags of the node pool will be deleted.</p>
</li></ul>
</td>
</tr>
<tr id="cce_02_0356__row680512296436"><td class="cellrowborder" valign="top" width="18.47815218478152%" headers="mcps1.3.3.9.2.5.1.1 "><p id="cce_02_0356__p10805132914318">taints</p>
</td>
<td class="cellrowborder" valign="top" width="12.818718128187182%" headers="mcps1.3.3.9.2.5.1.2 "><p id="cce_02_0356__p16339544472">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.837616238376164%" headers="mcps1.3.3.9.2.5.1.3 "><p id="cce_02_0356__p1853209124017">Array of <a href="#cce_02_0356__request_Taint">Table 10</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="44.86551344865513%" headers="mcps1.3.3.9.2.5.1.4 "><div class="p" id="cce_02_0356__p62291832164216">Taints added to the created node to set anti-affinity. The following three parameters are contained in every taint:<ul id="cce_02_0356__ul17274222121015"><li id="cce_02_0356__li227482216106"><strong id="cce_02_0356__b6682164511421">Key</strong>: Enter 1 to 63 characters starting with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. A DNS subdomain can be prefixed to a key.</li><li id="cce_02_0356__li7274112241020"><strong id="cce_02_0356__b18151133184317">Value</strong>: The value can be a string of 1 to 63 characters starting with a letter or digit. Letters, digits, hyphens (-), underscores (_), and periods (.) are allowed.</li><li id="cce_02_0356__li1655171215812"><strong id="cce_02_0356__b499072144314">Effect</strong>: Set it to <strong id="cce_02_0356__b39903212438">NoSchedule</strong>, <strong id="cce_02_0356__b1799072184315">PreferNoSchedule</strong>, or <strong id="cce_02_0356__b49901321164316">NoExecute</strong>.</li></ul>
</div>
<p id="cce_02_0356__p98321812817">Example:</p>
<pre class="screen" id="cce_02_0356__screen19127268812">"taints": [
{
"key": "status",
"value": "unavailable",
"effect": "NoSchedule"
},
{
"key": "looks",
"value": "bad",
"effect": "NoSchedule"
}]</pre>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__table469616391478" frame="border" border="1" rules="all"><caption><b>Table 8 </b>Data structure of the spec/extendParam field</caption><thead align="left"><tr id="cce_02_0356__row166966391777"><th align="left" class="cellrowborder" valign="top" width="18.45%" id="mcps1.3.3.10.2.5.1.1"><p id="cce_02_0356__p1833364243316">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="12.83%" id="mcps1.3.3.10.2.5.1.2"><p id="cce_02_0356__p173331842193317">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="23.79%" id="mcps1.3.3.10.2.5.1.3"><p id="cce_02_0356__p73331942143320">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.93%" id="mcps1.3.3.10.2.5.1.4"><p id="cce_02_0356__p93331942183314">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__row14696839976"><td class="cellrowborder" valign="top" width="18.45%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0356__p594212564360">maxPods</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0356__p149421756133614">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0356__p1094255614368">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="44.93%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0356__p73419192371">Maximum number of pods on the node.</p>
</td>
</tr>
<tr id="cce_02_0356__row469614394718"><td class="cellrowborder" valign="top" width="18.45%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0356__p2418192319916">agency_name</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0356__p1934334611915">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0356__p113435461493">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.93%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0356__p3419323992">Specifies the IAM agency name.</p>
</td>
</tr>
<tr id="cce_02_0356__row5696113912717"><td class="cellrowborder" valign="top" width="18.45%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0356__p203338425338">alpha.cce/preInstall</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0356__p1033318426332">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0356__p15333164220338">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.93%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0356__p3333154263315">Script required before the installation.</p>
<div class="note" id="cce_02_0356__note137011215354"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="cce_02_0356__p270172113358">The input value must be encoded using Base64. (Command: <strong id="cce_02_0356__b10861022802">echo -n "<em id="cce_02_0356__i155831735103">Content to be encoded</em>" | base64</strong>)</p>
</div></div>
</td>
</tr>
<tr id="cce_02_0356__row19696539975"><td class="cellrowborder" valign="top" width="18.45%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0356__p173671051153311">alpha.cce/postInstall</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0356__p163671751203313">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0356__p103676513337">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.93%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0356__p14771778110"><strong id="cce_02_0356__b18477117121119">Details</strong>:</p>
<p id="cce_02_0356__p11477575117">Post-installation script.</p>
<p id="cce_02_0356__p104777761114">The input value must be encoded using Base64. The method is as follows:</p>
<pre class="screen" id="cce_02_0356__screen747711711119">echo -n "*Content to be encoded*" | base64</pre>
<p id="cce_02_0356__p44779791119"><strong id="cce_02_0356__b54776781114">Constraints</strong>:</p>
<p id="cce_02_0356__p174778741116">The characters of both the pre-installation and post-installation scripts are centrally calculated, and the total number of characters after transcoding cannot exceed 10,240.</p>
<p id="cce_02_0356__p114771579116"><strong id="cce_02_0356__b54771712113">Options</strong>:</p>
<p id="cce_02_0356__p44774731119">N/A</p>
<p id="cce_02_0356__p947716751113"><strong id="cce_02_0356__b1147711721118">Default value</strong>:</p>
<p id="cce_02_0356__p1047777141117">N/A</p>
</td>
</tr>
<tr id="cce_02_0356__row17696939673"><td class="cellrowborder" valign="top" width="18.45%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0356__p125541033155112">alpha.cce/NodeImageID</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0356__p18554133165110">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0356__p5554153320517">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.93%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0356__p25343288481">Mandatory if a custom image is used in creating a bare metal node.</p>
</td>
</tr>
<tr id="cce_02_0356__row1569614391374"><td class="cellrowborder" valign="top" width="18.45%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0356__p93712193523">DockerLVMConfigOverride</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0356__p737161995213">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0356__p437151955211">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.93%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0356__p159432713497">Docker data disk configuration item. (This parameter has been discarded. Use the <strong id="cce_02_0356__b994574314813">storage</strong> field instead.)The following is an example configuration:</p>
<pre class="screen" id="cce_02_0356__screen1959482716492">"DockerLVMConfigOverride":"dockerThinpool=vgpaas/90%VG;kubernetesLV=vgpaas/10%VG;diskType=evs;lvType=linear"</pre>
<p id="cce_02_0356__p10594192714916">In this example:</p>
<ul id="cce_02_0356__ul11594182764917"><li id="cce_02_0356__li1859416272495"><strong id="cce_02_0356__b259510276497">userLV</strong>: size of the user space, for example, <strong id="cce_02_0356__b95959279498">vgpaas/20%VG</strong>.</li><li id="cce_02_0356__li17595727144919"><strong id="cce_02_0356__b1559510272493">userPath</strong>: mount path of the user space, for example, <strong id="cce_02_0356__b959572717492">/home/wqt-test</strong>.</li><li id="cce_02_0356__li659552724918"><strong id="cce_02_0356__b1559512711496">diskType</strong>: disk type. Currently, only the <strong id="cce_02_0356__b17595152710498">evs</strong>, <strong id="cce_02_0356__b859515272492">hdd</strong>, and <strong id="cce_02_0356__b155950277496">ssd</strong> are supported.</li><li id="cce_02_0356__li1459552718493"><strong id="cce_02_0356__b18595152719499">lvType</strong>: type of a logic volume. Currently, the value can be <strong id="cce_02_0356__b059515275492">linear</strong> or <strong id="cce_02_0356__b17595122764916">striped</strong>.</li><li id="cce_02_0356__li159542712499"><strong id="cce_02_0356__b159532714913">dockerThinpool</strong>: Docker space size, for example, <strong id="cce_02_0356__b16595132710491">vgpaas/60%VG</strong>.</li><li id="cce_02_0356__li10427163074917"><strong id="cce_02_0356__b16595122710499">kubernetesLV</strong>: kubelet space size, for example, <strong id="cce_02_0356__b159510275494">vgpaas/20%VG</strong>.</li></ul>
</td>
</tr>
<tr id="cce_02_0356__row1074115325107"><td class="cellrowborder" valign="top" width="18.45%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0356__p72717235354">publicKey</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0356__p8869917153510">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0356__p6869161753514">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.93%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0356__p17869191718359">Public key of the node. Used when creating a key pair.</p>
</td>
</tr>
<tr id="cce_02_0356__row1389234181020"><td class="cellrowborder" valign="top" width="18.45%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0356__p639893222117">nicMultiqueue</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0356__p1065417472214">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0356__p96541741228">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.93%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0356__p1943193516237">ENI queue settings, the default setting is:</p>
<pre class="screen" id="cce_02_0356__screen620622311237">"[{\"queue\":4}]"</pre>
<ul id="cce_02_0356__ul109mcpsimp"><li id="cce_02_0356__li110mcpsimp"><strong id="cce_02_0356__b197871928171619">queue</strong> indicates the number of ENI queues.</li><li id="cce_02_0356__li111mcpsimp">Supported proportions are {"1":128, "2":92, "4":92, "8":32, "16":16, "28":9}. That is, there is one queue, a maximum of 128 ENIs can be bound. If there are two queues, a maximum of 92 ENIs can be bound.</li><li id="cce_02_0356__li112mcpsimp">A larger number of ENI queues indicates higher performance but fewer ENIs can be bound. The queue settings cannot be changed after the node pool is created.</li></ul>
</td>
</tr>
<tr id="cce_02_0356__row1548836141014"><td class="cellrowborder" valign="top" width="18.45%" headers="mcps1.3.3.10.2.5.1.1 "><p id="cce_02_0356__p4314133518219">nicThreshold</p>
</td>
<td class="cellrowborder" valign="top" width="12.83%" headers="mcps1.3.3.10.2.5.1.2 "><p id="cce_02_0356__p152167692211">No</p>
</td>
<td class="cellrowborder" valign="top" width="23.79%" headers="mcps1.3.3.10.2.5.1.3 "><p id="cce_02_0356__p621612619228">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.93%" headers="mcps1.3.3.10.2.5.1.4 "><p id="cce_02_0356__p3365125792310">ENI pre-binding thresholds, the default setting is:</p>
<pre class="screen" id="cce_02_0356__screen5402015241">"0.3:0.6"</pre>
<ul id="cce_02_0356__ul17897111812248"><li id="cce_02_0356__li14901328141612">The first decimal place indicates the low threshold. Formula: Minimum number of pre-bound ENIs = Min (128 x Low threshold, Maximum number of ENIs that can be bound to the queue)</li><li id="cce_02_0356__li1090162820165">The second decimal place indicates the high threshold. Formula: Maximum number of pre-bound ENIs = Min (128 x High threshold, Maximum number of ENIs that can be bound to the queue)</li><li id="cce_02_0356__li37653543614">The high and low thresholds of the number of pre-bound ENIs are restricted by the maximum number of ENIs that can be bound to a queue.</li><li id="cce_02_0356__li13125145151715">ENIs bound to a BMS node = Number of ENIs currently used by pods + Number of pre-bound ENIs</li><li id="cce_02_0356__li20460418121713">CCE keeps binding ENIs to a BMS node to ensure that the minimum number of ENIs is always reached. (Min. pre-bound ENIs ≤ Number of pre-bound ENIs + Number of ENIs currently used by pods)</li><li id="cce_02_0356__li1379792861712">At every 2 minutes, CCE releases ENIs pre-bound to a BMS node to ensure that the maximum number of ENIs will not be exceeded. (Max. pre-bound ENIs ≥ Number of pre-bound ENIs + Number of ENIs currently used by pods)</li><li id="cce_02_0356__li189032821611">Both the thresholds are one-decimal-place values ranging from 0.0 to 1.0. The low threshold must be smaller than or equal to the high one.</li><li id="cce_02_0356__li490172814167">This field can be configured only for BMS nodes in a CCE Turbo cluster.</li><li id="cce_02_0356__li179022851620">Pre-binding ENIs can speed up workload creation but occupies IP addresses.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="cce_02_0356__request_UserTag"></a><a name="request_UserTag"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__request_UserTag" frame="border" border="1" rules="all"><caption><b>Table 9 </b>UserTag</caption><thead align="left"><tr id="cce_02_0356__row14733164913419"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.11.2.5.1.1"><p id="cce_02_0356__p09271050248">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.11.2.5.1.2"><p id="cce_02_0356__p1592718504412">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.11.2.5.1.3"><p id="cce_02_0356__p192718501420">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.11.2.5.1.4"><p id="cce_02_0356__p14927105016410">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__row14733104917410"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.11.2.5.1.1 "><p id="cce_02_0356__p39274501146">key</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.11.2.5.1.2 "><p id="cce_02_0356__p1992720502418">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.11.2.5.1.3 "><p id="cce_02_0356__p4927450343">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.11.2.5.1.4 "><p id="cce_02_0356__p1392719501444"><strong id="cce_02_0356__b39271850249">Details</strong>:</p>
<p id="cce_02_0356__p11927250947">Key of the cloud server tag</p>
<p id="cce_02_0356__p209271050342"><strong id="cce_02_0356__b169272508415">Constraints</strong>:</p>
<p id="cce_02_0356__p99271950247">The value cannot start with <strong id="cce_02_0356__b7927750347">CCE-</strong>, <strong id="cce_02_0356__b49271750749">__type_baremetal</strong>, or <strong id="cce_02_0356__b39271950744"><em id="cce_02_0356__i924316134210">sys</em></strong>.</p>
<p id="cce_02_0356__p49271150044"><strong id="cce_02_0356__b5927185018417">Options</strong>:</p>
<p id="cce_02_0356__p1392775013412">The value contains a maximum of 128 characters. The tag key must be unique and cannot start or end with a space. It cannot contain non-printable ASCII characters (0–31) or the following special characters: =*&lt;&gt;,|/</p>
<p id="cce_02_0356__p1492785014413"><strong id="cce_02_0356__b1792717501046">Default value</strong>:</p>
<p id="cce_02_0356__p69273501416">N/A</p>
</td>
</tr>
<tr id="cce_02_0356__row107341649244"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.11.2.5.1.1 "><p id="cce_02_0356__p19927125016410">value</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.11.2.5.1.2 "><p id="cce_02_0356__p169271503411">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.11.2.5.1.3 "><p id="cce_02_0356__p492785012412">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.11.2.5.1.4 "><p id="cce_02_0356__p1292713501247"><strong id="cce_02_0356__b292717506414">Details</strong>:</p>
<p id="cce_02_0356__p79275506411">Value of the cloud server tag</p>
<p id="cce_02_0356__p1292717501417"><strong id="cce_02_0356__b1892719501948">Constraints</strong>:</p>
<p id="cce_02_0356__p129277501145">None</p>
<p id="cce_02_0356__p19277502048"><strong id="cce_02_0356__b14927175015411">Options</strong>:</p>
<p id="cce_02_0356__p1792725014413">The value contains a maximum of 255 characters. The tag value cannot start or end with a space. It cannot contain non-printable ASCII characters (0–31) or the following special characters: =*&lt;&gt;,|</p>
<p id="cce_02_0356__p1692775010419"><strong id="cce_02_0356__b392710509413">Default value</strong>:</p>
<p id="cce_02_0356__p12927125019420">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="cce_02_0356__request_Taint"></a><a name="request_Taint"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__request_Taint" frame="border" border="1" rules="all"><caption><b>Table 10 </b>Taint</caption><thead align="left"><tr id="cce_02_0356__row177321149642"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.12.2.5.1.1"><p id="cce_02_0356__p992617501413">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.12.2.5.1.2"><p id="cce_02_0356__p592611501749">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.12.2.5.1.3"><p id="cce_02_0356__p1392625011411">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.12.2.5.1.4"><p id="cce_02_0356__p1292612501445">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__row2732849941"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.1 "><p id="cce_02_0356__p13926155017420">key</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.2 "><p id="cce_02_0356__p179269500413">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.3 "><p id="cce_02_0356__p39268507414">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.12.2.5.1.4 "><p id="cce_02_0356__p59264505413"><strong id="cce_02_0356__b7926205015417">Definition</strong></p>
<p id="cce_02_0356__p1192617503411">Key of a Kubernetes taint</p>
<p id="cce_02_0356__p1392613501441"><strong id="cce_02_0356__b13926950648">Constraints</strong></p>
<p id="cce_02_0356__p189261550843">The value must contain 1 to 63 characters starting and ending with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed.</p>
<p id="cce_02_0356__p69267508418"><strong id="cce_02_0356__b209262501246">Range</strong></p>
<p id="cce_02_0356__p149261750346">N/A</p>
<p id="cce_02_0356__p792617501547"><strong id="cce_02_0356__b1992610506411">Default Value</strong></p>
<p id="cce_02_0356__p7926195010412">N/A</p>
</td>
</tr>
<tr id="cce_02_0356__row2732134919419"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.1 "><p id="cce_02_0356__p1926185013419">value</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.2 "><p id="cce_02_0356__p1092612501344">No</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.3 "><p id="cce_02_0356__p79266503413">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.12.2.5.1.4 "><p id="cce_02_0356__p15926135013419"><strong id="cce_02_0356__b992645012420">Definition</strong></p>
<p id="cce_02_0356__p192655020412">Value of a Kubernetes taint</p>
<p id="cce_02_0356__p1792665014411"><strong id="cce_02_0356__b19926165012420">Constraints</strong></p>
<p id="cce_02_0356__p1392613505415">The value must contain 1 to 63 characters starting and ending with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed.</p>
<p id="cce_02_0356__p16926185020419"><strong id="cce_02_0356__b992625019411">Range</strong></p>
<p id="cce_02_0356__p1292619501946">N/A</p>
<p id="cce_02_0356__p1192675014417"><strong id="cce_02_0356__b1992611507417">Default Value</strong></p>
<p id="cce_02_0356__p292616501949">N/A</p>
</td>
</tr>
<tr id="cce_02_0356__row17328491411"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.1 "><p id="cce_02_0356__p1892665010412">effect</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.2 "><p id="cce_02_0356__p39262502412">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.12.2.5.1.3 "><p id="cce_02_0356__p1792610501646">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.12.2.5.1.4 "><p id="cce_02_0356__p13927750647"><strong id="cce_02_0356__b19927750842">Definition</strong></p>
<p id="cce_02_0356__p392714501049">Effect of a Kubernetes taint</p>
<p id="cce_02_0356__p992716502411"><strong id="cce_02_0356__b492713501446">Constraints</strong></p>
<p id="cce_02_0356__p11927125019411">N/A</p>
<p id="cce_02_0356__p1292710501142"><strong id="cce_02_0356__b1792716502415">Range</strong></p>
<p id="cce_02_0356__p6927450742"><strong id="cce_02_0356__b1092710508412">NoSchedule</strong>, <strong id="cce_02_0356__b1192719501144">PreferNoSchedule</strong>, and <strong id="cce_02_0356__b1392710501542">NoExecute</strong></p>
<p id="cce_02_0356__p1992720505414"><strong id="cce_02_0356__b13927150242">Default Value</strong></p>
<p id="cce_02_0356__p79272050641">N/A</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="cce_02_0356__p1949713104354"><strong id="cce_02_0356__b18637103252113">Example request</strong>:</p>
<pre class="screen" id="cce_02_0356__screen235111314158">{
"metadata" : {
"name" : "nodepool-name-change"
},
"spec" : {
"nodeTemplate" : {
"k8sTags" : {
"cce.cloud.com/cce-nodepool": "nodepool-name-change",
"change-tag": "value2"
},
"taints" : [ {
"key" : "status",
"value" : "unavailable",
"effect" : "NoSchedule"
} ],
},
"autoscaling" : {
"enable" : true,
"minNodeCount" : 2,
"maxNodeCount" : 4,
"scaleDownCooldownTime" : 10,
"priority" : 2
},
"initialNodeCount" : 1
}
}</pre>
</div>
<div class="section" id="cce_02_0356__section61819725020"><h4 class="sectiontitle">Response</h4><p id="cce_02_0356__zh-cn_topic_0079614900_p2018733"><strong id="cce_02_0356__en-us_topic_0079614900_b18168603">Response parameters</strong>:</p>
<p id="cce_02_0356__p16966318249"><a href="cce_02_0354.html#cce_02_0354__table835415466262">Table 26</a> describes the response parameters.</p>
<p id="cce_02_0356__p1055311619571"><strong id="cce_02_0356__b580255393014">Response example</strong>:</p>
<pre class="screen" id="cce_02_0356__screen1778973121718">{
"kind": "NodePool",
"apiVersion": "v3",
"metadata": {
"name": "nodepool-name-change",
"uid": "feec6013-cd7e-11ea-8c7a-0255ac100be7"
},
"spec": {
"initialNodeCount": 0,
"type": "vm",
"nodeTemplate": {
"flavor": "s6.large.2",
"az": "eu-de-01",
"os": "EulerOS 2.5",
"login": {
"sshKey": "KeyPair-nodepool",
"userPassword": {}
},
"rootVolume": {
"volumetype": "SATA",
"size": 40
},
"dataVolumes": [
{
"volumetype": "SATA",
"size": 100,
"extendParam": {
"useType": "docker"
}
}
],
"storage": {
"storageSelectors": [
{
"name": "cceUse",
"storageType": "evs",
"matchLabels": {
"size": "100",
"volumeType": "SAS",
"count": "1"
}
}
],
"storageGroups": [
{
"name": "vgpaas",
"selectorNames": [
"cceUse"
],
"cceManaged": true,
"virtualSpaces": [
{
"name": "runtime",
"size": "90%"
},
{
"name": "kubernetes",
"size": "10%"
}
]
}
]
},
"runtime": {
"name":"docker"
},
"publicIP": {
"eip": {
"bandwidth": {}
}
},
"nodeNicSpec": {
"primaryNic": {
"subnetId": "31be174a-0c7f-4b71-bb0d-d325fecb90ef"
}
},
"billingMode": 0,
"taints": [
{
"key": "change-taints",
"value": "value1",
"effect": "NoExecute"
}
],
"k8sTags": {
"cce.cloud.com/cce-nodepool": "nodepool-name-change",
"change-tag": "value2"
},
"userTags": [
{
"key": "change-resource-tag",
"value": "value3"
}
],
"extendParam": {
"DockerLVMConfigOverride": "dockerThinpool=vgpaas/90%VG;kubernetesLV=vgpaas/10%VG;diskType=evs;lvType=linear",
"alpha.cce/postInstall": "bHMgLWwK",
"alpha.cce/preInstall": "bHMgLWw=",
"maxPods": 110
}
},
"autoscaling": {
"enable": true,
"minNodeCount": 2,
"maxNodeCount": 4,
"scaleDownCooldownTime": 10,
"priority": 2
},
"nodeManagement": {
"serverGroupReference": "2129f95a-f233-4cd8-a1b2-9c0acdf918d3"
}
},
"status": {
"currentNode": 0,
"phase": ""
}
}</pre>
</div>
<div class="section" id="cce_02_0356__s50f1049a6a4d404c895cf636eb8f3bf1"><h4 class="sectiontitle">Status Code</h4><p id="cce_02_0356__zh-cn_topic_0079614900_p21869221"><a href="#cce_02_0356__zh-cn_topic_0079614900_table46761928">Table 11</a> describes the status code of this API.</p>
<div class="tablenoborder"><a name="cce_02_0356__zh-cn_topic_0079614900_table46761928"></a><a name="zh-cn_topic_0079614900_table46761928"></a><table cellpadding="4" cellspacing="0" summary="" id="cce_02_0356__zh-cn_topic_0079614900_table46761928" frame="border" border="1" rules="all"><caption><b>Table 11 </b>Status code</caption><thead align="left"><tr id="cce_02_0356__zh-cn_topic_0079614900_row33254664"><th align="left" class="cellrowborder" valign="top" width="38.93%" id="mcps1.3.5.3.2.3.1.1"><p id="cce_02_0356__p55616028205955">Status Code</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="61.07%" id="mcps1.3.5.3.2.3.1.2"><p id="cce_02_0356__p8604418205955">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="cce_02_0356__zh-cn_topic_0079614900_row41084259"><td class="cellrowborder" valign="top" width="38.93%" headers="mcps1.3.5.3.2.3.1.1 "><p id="cce_02_0356__zh-cn_topic_0079614900_p39490674">200</p>
</td>
<td class="cellrowborder" valign="top" width="61.07%" headers="mcps1.3.5.3.2.3.1.2 "><p id="cce_02_0356__zh-cn_topic_0079614900_p44628050">The specified node pool is updated successfully.</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="cce_02_0356__p347213715512">For details 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>
View Git Blame Copy Permalink