在指定集群下创建默认节点池。 ## 使用说明 * 除标准的自定义节点池外，容器服务支持 **默认节点池**（固定名称`vke-default-nodepool`）能力，用来纳管已有云服务器（ECS）实例。创建默认节点池后，通过调用 [CreateNodes](https://www.volcengine.com/docs/6460/115198) 接口为默认节点池添加已有 ECS 实例。 * 调用该接口前，请调用 [ListSupportedResourceTypes](https://www.volcengine.com/docs/6460/115192) 接口，确认创建默认节点池时需要用到的资源是否在指定的地域和可用区中支持。 * 此接口为异步接口，当此接口返回成功时，会返回默认节点池的 ID 信息，此时节点池将进入`{Creating, [Progressing]}`状态，直到创建执行成功。请调用 [ListNodePools](https://www.volcengine.com/docs/6460/115197) 接口获取该节点池当前的状态，查看节点池是否创建成功。 * 默认节点池不会占用您的节点池配额。配额详情，请参见 [使用限制](https://www.volcengine.com/docs/6460/79642)。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com/?Action=CreateDefaultNodePool&Version=2022\-05\-12 ## 调试 ## 请求参数调用该 API 时的请求参数如下，除此之外还需传入公共请求参数。公共请求参数说明，请参见 [公共参数](https://www.volcengine.com/docs/6460/70904)。 |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Action |String |是 |CreateDefaultNodePool |接口名称。当前 API 的名称为 `CreateDefaultNodePool`。 | |Version |String |是 |2022\-05\-12 |接口版本。当前 API 的版本为 `2022-05-12`。 | |ClientToken |String |否 |BC028527\-33B9\-4990\-A633\-84E9F9\*\*\*\*\*\* |用于保证请求幂等性的字符串。该字符串由调用方传入，需保证不同请求之间唯一。ClientToken 对大小写敏感，且最大值不超过 64 个 ASCII 字符。 | |ClusterId |String |是 |cc5silum\*\*\*\*\*\*\*\* |默认节点池所在集群的 ID。|\ | | | | |可以调用 [ListClusters](https://www.volcengine.com/docs/6460/115190) 接口，获取集群 ID。|\ | | | | |:::warning|\ | | | | |集群必须处于`{Running,[Ok]}`或`{Updating,[Progressing]}`状态。可调用 [ListClusters](https://www.volcengine.com/docs/6460/115190) 接口获取集群当前的状态。|\ | | | | ||\ | | | | |:::| |KubernetesConfig |Object of [NodePoolKubernetesConfigRequest](https://www.volcengine.com/docs/6460/130708#nodepoolkubernetesconfigrequest) |否 |\- |默认节点池 Kubernetes 配置。 | |NodeConfig |Object of [DefaultNodePoolNodeConfigRequest](https://www.volcengine.com/docs/6460/130708#defaultnodepoolnodeconfigrequest) |是 |\- |默认节点池中云服务器（ECS）实例配置。 | |Tags |Array of [Tag](https://www.volcengine.com/docs/6460/130708#tag) |否 |\- |默认节点池标签信息，用于从不同维度对具有相同特征的节点池进行分类、搜索和聚合，能够灵活管理节点池。|\ | | | | ||\ | | | | |* **Tags** 中各个 **Key** 不可重复。|\ | | | | |* 资源已有相同 **Tags.Key** 的情况下，重复绑定 **Tags.Key** 不会报错，会更新为最新的 **Tags.Value**。|\ | | | | |* 单个资源最多支持绑定50个 **Tags**。|\ | | | | |* **Tags** 中的 **Key**、**Value** 不允许在最前或最后输入空格。 | ### NodePoolKubernetesConfigRequest |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Labels |Array of [Label](https://www.volcengine.com/docs/6460/130708#label) |否 |\- |节点池/节点的 Kubernetes 标签（Labels）信息。最多可传入 20 个标签。|\ | | | | |:::tip|\ | | | | |节点池会统一管理节点的标签配置信息，因此标签信息会同步到节点池内的所有节点上。当标签发生变更时，会覆盖原有的标签配置信息。|\ | | | | ||\ | | | | |:::| |Taints |Array of [Taint](https://www.volcengine.com/docs/6460/130708#taint) |否 |\- |节点池/节点的 Kubernetes 污点（Taints）信息。最多可传入 20 个污点。|\ | | | | |:::tip|\ | | | | |节点池会统一管理节点的污点配置信息，因此污点信息会同步到节点池内的所有节点上。当污点发生变更时，会覆盖原有的污点配置信息。|\ | | | | ||\ | | | | |:::| |Cordon |Boolean |否 |false |封锁节点配置，取值：|\ | | | | ||\ | | | | |* **false**：（默认值）不封锁|\ | | | | |* **true**：封锁|\ | | | | ||\ | | | | |:::tip|\ | | | | |更新节点池（UpdateNodePoolConfig）时，若不传入参数值，则保持原有参数配置。|\ | | | | ||\ | | | | |:::| |NamePrefix |String |否 |name\-prefix |Kubernetes 中节点对象的元数据名称前缀。默认不启用，若设置表示启用，并将影响 Kubernetes Node Manifest 文件中展示的`metadata.name`前缀信息。前缀校验规则如下：|\ | | | | ||\ | | | | |* 支持英文小写字母、数字、中划线(`-`)和半角句号(`.`)。|\ | | | | |* 只能以英文小写字母或者数字开头。|\ | | | | |* 长度限制为 1~48 个字符。 | |KubeletConfig |Object of [NodePoolKubeletConfig](https://www.volcengine.com/docs/6460/130708#nodepoolkubeletconfig) |否 |\- |节点池中节点的 kubelet 自定义参数配置，用于调整节点行为。 | |AutoSyncDisabled |Boolean |否 |false |是否禁用自动同步标签污点到存量节点的功能，取值：|\ | | | | ||\ | | | | |* **true**：禁用，即关闭自动同步。|\ | | | | |* **false**：（默认值）不禁用，即开启自动同步。 | ### Label |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Key |String |是 |label\-key |标签键，要求如下，更多规则，请参见 [Kubernetes 标签规则](https://kubernetes.io/zh/docs/concepts/overview/working-with-objects/labels/#%E8%AF%AD%E6%B3%95%E5%92%8C%E5%AD%97%E7%AC%A6%E9%9B%86)。|\ | | | | |有效的标签键有两个段：<前缀\>和<名称\>，用斜杠（`/`）分隔。|\ | | | | ||\ | | | | |* <名称\>是必须的，支持英文大小写字母、数字、短划线（`-`）、下划线（`_`）、英文句号（ `.`），以字母或数字开头和结尾，长度不超过 63 个字符。|\ | | | | |* <前缀\>是可选的。如果指定<前缀\>，则必须是 DNS 子域：由英文句号（`.`）分隔的一系列 DNS 标签，长度不超过 253 个字符。|\ | | | | |* <前缀\>和<名称\>总长度不超过 82 个字符。 | |Value |String |否 |label\-value |标签值，要求如下，更多规则，请参见 [Kubernetes 标签规则](https://kubernetes.io/zh/docs/concepts/overview/working-with-objects/labels/#%E8%AF%AD%E6%B3%95%E5%92%8C%E5%AD%97%E7%AC%A6%E9%9B%86)。|\ | | | | ||\ | | | | |* 长度不超过 63 个字符（可以为空）。|\ | | | | |* 支持以英文大小写字母、数字开头和结尾。|\ | | | | |* 支持特殊字符：短划线（`-`）、下划线（`_`）、英文句号（`.`）。 | ### Taint |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Effect |String |否 |NoSchedule |污点效果，取值：|\ | | | | ||\ | | | | |* **NoSchedule**：（默认值）不调度。|\ | | | | |* **NoExecute**：驱逐没有容忍污点的 Pod。|\ | | | | |* **PreferNoSchedule**：尽量避免调度。 | |Key |String |是 |taint\-key |污点键，要求如下，更多规则，请参见 [Kubernetes 标签规则](https://kubernetes.io/zh/docs/concepts/overview/working-with-objects/labels/#%E8%AF%AD%E6%B3%95%E5%92%8C%E5%AD%97%E7%AC%A6%E9%9B%86)。|\ | | | | |有效的污点键有两个段：<前缀\>和<名称\>，用斜杠（`/`）分隔。|\ | | | | ||\ | | | | |* <名称\>是必须的，支持英文大小写字母、数字、短划线（`-`）、下划线（`_`）、英文句号（ `.`），以字母或数字开头和结尾，长度不超过 63 个字符。|\ | | | | |* <前缀\>是可选的。如果指定<前缀\>，则必须是 DNS 子域：由英文句号（`.`）分隔的一系列 DNS 标签，长度不超过 253 个字符。|\ | | | | |* <前缀\>和<名称\>总长度不超过 82 个字符。 | |Value |String |否 |taint\-value |污点值，要求如下，更多规则，请参见 [Kubernetes 标签规则](https://kubernetes.io/zh/docs/concepts/overview/working-with-objects/labels/#%E8%AF%AD%E6%B3%95%E5%92%8C%E5%AD%97%E7%AC%A6%E9%9B%86)。|\ | | | | ||\ | | | | |* 长度不超过 63 个字符（可以为空）。|\ | | | | |* 支持以英文大小写字母、数字开头和结尾。|\ | | | | |* 支持特殊字符：短划线（`-`）、下划线（`_`）、英文句号（`.`）。 | ### NodePoolKubeletConfig |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |FeatureGates |Object of [FeatureGates](https://www.volcengine.com/docs/6460/130708#featuregates) |否 |\- |特性门控，即描述 Kubernetes 特性的一组键值对。 | |TopologyManagerScope |String |否 |container |拓扑管理策略的资源粒度，取值：|\ | | | | ||\ | | | | |* **container**：表示资源对齐粒度为容器级。 | |TopologyManagerPolicy |String |否 |none |拓扑管理策略，取值：|\ | | | | ||\ | | | | |* **none**：（默认）禁用拓扑管理策略。|\ | | | | |* **restricted**：kubelet 仅接受在所请求资源上实现最佳 NUMA（Non\-Uniform Memory Access，非一致存储访问结构）的 Pod。|\ | | | | |* **best\-effort**：kubelet 会优先选择在 CPU 和设备资源上实现 NUMA 的 Pod。|\ | | | | |* **single\-numa\-node**：kubelet 仅允许在同一个节点的 CPU 和设备资源上实现 NUMA 的 Pod。 | ### FeatureGates |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |QoSResourceManager |Boolean |否 |false |是否启用 QoS 资源管理器，用于支持微拓扑调度。取值：|\ | | | | ||\ | | | | |* **true**：启用 QoS 资源管理器。|\ | | | | |* **false**：（默认）不启用 QoS 资源管理器。|\ | | | | ||\ | | | | |:::tip|\ | | | | |目前该特性门控仅支持在 Kubernetes v1.24（且 VKE 版本 ≥ v1.24.15\-vke.13）及以上版本的集群中使用。|\ | | | | ||\ | | | | |:::| ### DefaultNodePoolNodeConfigRequest |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |InitializeScript |String |否 |ZWNobyAidG\*\*\*\*\*\* |创建并初始化节点后执行的自定义脚本。支持 Shell 格式，Base64 编码后长度不超过 1 KB。 | |Security |Object of [NodeSecurityRequest](https://www.volcengine.com/docs/6460/130708#nodesecurityrequest) |是 |\- |节点安全配置。 | |NamePrefix |String |否 |prefix\-name |节点名称前缀。取值为空字符串时表示不启用节点命名前缀，默认不启用。前缀校验规则如下：|\ | | | | ||\ | | | | |* 支持英文大小写字母、数字和中划线(\-)。|\ | | | | |* 只能以英文字母开头，英文字母或数字结尾。|\ | | | | |* 不能连续使用中划线(\-)。|\ | | | | |* 长度限制为 2～51 个字符。 | |Tags |Array of [Tag](https://www.volcengine.com/docs/6460/130708#tag) |否 |\- |节点对应 ECS 实例绑定的标签信息，用于搜索、管理 ECS 实例。|\ | | | | ||\ | | | | |* **Tags** 中各个 **Key** 不可重复。|\ | | | | |* 资源已有相同 **Tags.Key** 的情况下，重复绑定 **Tags.Key** 不会报错，会更新为最新的 **Tags.Value**。|\ | | | | |* 单个资源最多支持绑定 20 个 ECS 实例标签。|\ | | | | |* **Tags** 中的 **Key**、**Value** 不允许在最前或最后输入空格。 | ### NodeSecurityRequest |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |SecurityGroupIds |Array of String |否 |["sg\-2byy13cnsc\*\*\*\*\*\*"] |节点网络所在的安全组 ID 列表。|\ | | | | |调用私有网络的 [DescribeSecurityGroups](https://www.volcengine.com/docs/6401/70753) 接口，获取安全组 ID。|\ | | | | |:::warning|\ | | | | ||\ | | | | |* 必须与集群处于同一个私有网络内。|\ | | | | |* 取值为空时，默认使用 **集群节点默认安全组**（命名格式为`<集群ID>-common`）。默认安全组相关说明，请参见 [安全组设置](https://www.volcengine.com/docs/6460/97726)。|\ | | | | |* 单个节点池最多支持关联 5 个安全组（含集群节点默认安全组）。|\ | | | | ||\ | | | | |:::| |SecurityStrategies |Array of String |否 |["Hids"] |节点的安全策略，取值：|\ | | | | ||\ | | | | |* 取值为空：表示节点不开启安全加固。|\ | | | | |* **Hids**：主机安全加固。 | |Login |Object of [NodeLoginRequest](https://www.volcengine.com/docs/6460/130708#nodeloginrequest) |是 |\- |节点的访问方式配置。|\ | | | | |支持密码方式或密钥对方式。同时传入时，优先使用密钥对。 | ### NodeLoginRequest |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Password |String |否 |UHdkMT\*\*\*\*\*\* |Root 用户登录密码，使用 Base64 编码格式。|\ | | | | |请遵循云服务器对于实例密码的要求规范：|\ | | | | ||\ | | | | |* 长度为 8～30 个字符|\ | | | | |* 不能以`/`和`$6$`开头|\ | | | | |* 支持以下几项字符，且至少包含三项|\ | | | | | * 小写字母`a`~`z`|\ | | | | | * 大写字母`A`~`Z`|\ | | | | | * 数字`0`~`9`|\ | | | | | * 特殊字符`( ) ` ~ ! @ # $ % ^ & * _ - + = \| { } [ ] : ; ' < > , . ? /` \| | |SshKeyPairName |String |否 |test\-key |SSH 密钥对名称。请确保该密钥对已在云服务器中创建或托管。 | ### Tag |参数 |类型 |是否必选 |示例值 |描述 | |---|---|---|---|---| |Key |String |是 |key |标签键。|\ | | | | ||\ | | | | |* 不能以任何大小写形式的`volc:`开头。|\ | | | | |* 只能包含语言字符、数字、空格和特殊符号`_.:/=+-@`。|\ | | | | |* 长度限制为 1～128 个字符。 | |Value |String |否 |value |标签值，可以为空。|\ | | | | ||\ | | | | |* 只能包含语言字符、数字、空格和特殊符号`_.:/=+-@`。|\ | | | | |* 长度不超过 256 个字符。 | ## 请求示例 ```json POST https://open.volcengineapi.com/?Action=CreateDefaultNodePool&Version=2022-05-12 HTTP/1.1 Content-Type:application/json { "ClusterId": "cc5silum********", "KubernetesConfig": { "Labels": [ { "Key": "label-key", "Value": "label-value" } ], "Taints": [ { "Key": "taint-key", "Value": "taint-value", "Effect": "NoSchedule" } ], "Cordon": false }, "NodeConfig": { "InitializeScript": "ZWNobyAidG******", "Security": { "SecurityGroupIds": [ "sg-2byy13cnsc******" ], "SecurityStrategies": [ "Hids" ], "Login": { "Password": "UHdkM******" } }, "NamePrefix": "name-prefix", "Tags": [ { "Key": "key", "Value": "value" } ] }, "Tags": [ { "Key": "key", "Value": "value" } ], "ClientToken": "BC028527-33B9-4990-A633-84E9F9******" } ``` ## 返回参数本接口返回参数如下表所示，公共返回参数请参见 [返回结果](https://www.volcengine.com/docs/6460/79674)。 |参数 |类型 |示例值 |描述 | |---|---|---|---| |Id |String |pc51i0m6\*\*\*\*\*\*\*\* |默认节点池 ID。 | ## 返回示例 ```json HTTP/1.1 200 OK Content-Type:application/json { "ResponseMetadata": { "RequestId": "021635330********", "Action": "CreateDefaultNodePool", "Version": "2022-05-12", "Service": "vke", "Region": "cn-beijing" }, "Result": { "Id": "pc51i0m6********" } } ``` ## 错误码本接口错误码如下表所示，公共错误码请参见 [公共错误码](https://www.volcengine.com/docs/6460/118978)。 |HTTP 状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |409 |AlreadyExists.DefaultNodePool |The default node pool already exists. |默认节点池已存在，无需创建。 | |400 |ClusterVpcMismatch.{{parameter}} |The specified {{resourceType}} {{resourceId}} is not in the VPC of cluster. |指定的子网、安全组、高性能计算集群与集群属于不同私有网络，请确保其与集群处于同一个私有网络内。 | |400 |OperationDenied.ClusterStatus |The action has been denied due to wrong cluster status {{statusPhase}} and [{{statusConditions}}]. |指定集群的当前状态不支持该操作。请确认该接口依赖的集群状态后重试。 | |400 |QuotaExceeded.{{ResourceType}} |The quota of {{ResourceType}} has reached the limit. |指定资源的配额达到上限，如 Tag、ECS Tag 等。请提升相关资源配额，或删除无用资源，预留出配额后重试。 | |400 |NotSupported.{{parameter}} |The specified {{resourceType}} {{resourceContent}} is not supported. |指定参数不支持，例如 **SecurityGroupIds** 等。请确认参数后重试 |