You need to enable JavaScript to run this app.
文档中心
容器服务

容器服务

复制全文
下载 pdf
节点池管理
UpdateNodePoolConfig - 更新节点池配置
复制全文
下载 pdf
UpdateNodePoolConfig - 更新节点池配置
更新指定集群下的节点池配置。​
请求说明​
VKE 已在全球多个地域部署服务,旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅 服务地址 文档,根据业务所在地域,选择最合适的接入点。​
  • 请求方式:POST​
  • 请求地址:https://vke.cn-beijing.volcengineapi.com?Action=UpdateNodePoolConfig&Version=2022-05-12​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
调用该 API 时的请求参数如下,除此之外还需传入公共请求参数。公共请求参数说明,请参见 公共参数。​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
UpdateNodePoolConfig​
接口名称。当前 API 的名称为 UpdateNodePoolConfig。​
Version​
String​
是​
2022-05-12​
接口版本。当前 API 的版本为 2022-05-12。​
ClientToken​
String​
否​
BC028527-33B9-4990-A633-84E9F9******​
用于保证请求幂等性的字符串。该字符串由调用方传入,需保证不同请求之间唯一。ClientToken 对大小写敏感,且最大值不超过 64 个 ASCII 字符。​
ClusterId​
String​
是​
cc5silu*******​
节点池所在集群的 ID。​
可以调用 ListClusters 接口,获取集群 ID。​
注意​
集群必须处于{Running,[*]}或 {Updating,[Progressing]}状态。可调用 ListClusters 接口获取集群当前的状态。​
Id​
String​
是​
pc51i0*******​
节点池 ID。​
可以调用 ListNodePools 接口,获取节点池 ID。​
注意​
节点池必须处于{Running,[*]}或{Scaling,[Progressing]}状态。可调用 ListNodePools 接口获取节点池当前的状态。​
Name​
String​
否​
test-nodepool​
节点池名称。​
  • 同一个集群下,节点池名称必须唯一。​
  • 支持大小写英文字母、汉字、数字、短划线(-),长度限制为 2~64 个字符。​
注意​
不能使用默认节点池保留名:vke-default-nodepool。​
KubernetesConfig​
否​
-​
节点池 Kubernetes 的配置。​
NodeConfig​
Object of NodeConfigForUpdate​
否​
-​
节点池中云服务器实例配置。​
AutoScaling​
否​
-​
节点池伸缩策略。​
说明​
默认节点池vke-default-nodepool不支持修改节点池伸缩策略。​
Management​
否​
-​
托管节点池配置。​
​
NodePoolKubernetesConfigRequest​
​
参数​
类型​
是否必选​
示例值​
描述​
Labels​
Array of Label​
否​
-​
节点池/节点的 Kubernetes 标签(Labels)信息。最多可传入 20 个标签。​
说明​
节点池会统一管理节点的标签配置信息,因此标签信息会同步到节点池内的所有节点上。当标签发生变更时,会覆盖原有的标签配置信息。​
Taints​
Array of Taint​
否​
-​
节点池/节点的 Kubernetes 污点(Taints)信息。最多可传入 20 个污点。​
说明​
节点池会统一管理节点的污点配置信息,因此污点信息会同步到节点池内的所有节点上。当污点发生变更时,会覆盖原有的污点配置信息。​
Cordon​
Boolean​
否​
false​
封锁节点配置,取值:​
  • false:不封锁​
  • true:封锁​
说明​
更新节点池(UpdateNodePoolConfig)时,若不传入参数值,则保持原有参数配置。​
NamePrefix​
String​
否​
name-prefix​
Kubernetes 中节点对象的元数据名称前缀。前缀校验规则如下:​
  • 支持英文小写字母、数字、中划线(-)和半角句号(.)。​
  • 只能以英文小写字母或者数字开头。​
  • 长度限制为 1~48 个字符。​
KubeletConfig​
否​
-​
节点池中节点的 kubelet 自定义参数配置,用于调整节点行为。​
注意​
默认节点池暂不支持 kubelet 自定义参数配置,相关子参数的传入值不会生效。​
AutoSyncDisabled​
Boolean​
否​
false​
是否禁用自动同步标签污点到存量节点的功能,取值:​
  • true:禁用,即关闭自动同步。​
  • false:不禁用,即开启自动同步。​
Runtime​
否​
-​
容器运行时配置。​
NameSuffix​
String​
否​
-demo​
Kubernetes 中节点对象的元数据名称后缀。​
NameUseHostname​
Boolean​
否​
true​
Kubernetes 中节点对象的元数据名称是否使用 ECS 主机名称,取值:​
  • true:使用 ECS 主机名称作为节点名称。​
  • false:不使用 ECS 主机名称作为节点名称。​
说明​
该配置优先级高于NamePrefix和NameSuffix。​
ContainerdConfig​
否​
-​
节点池 Containerd 相关配置。​
注意​
默认节点池暂不支持 Containerd 配置,相关子参数的传入值不会生效。​
​
Label​
​
参数​
类型​
是否必选​
示例值​
描述​
Key​
String​
是​
label-key​
标签键,要求如下,更多规则,请参见 Kubernetes 标签规则。​
有效的标签键有两个段:<前缀>和<名称>,用斜杠(/)分隔。​
  • <名称>是必须的,支持英文大小写字母、数字、短划线(-)、下划线(_)、英文句号( .),以字母或数字开头和结尾,长度不超过 63 个字符。​
  • <前缀>是可选的。如果指定<前缀>,则必须是 DNS 子域:由英文句号(.)分隔的一系列 DNS 标签,长度不超过 253 个字符。​
  • <前缀>和<名称>总长度不超过 82 个字符。​
Value​
String​
否​
label-value​
标签值,要求如下,更多规则,请参见 Kubernetes 标签规则。​
  • 长度不超过 63 个字符(可以为空)。​
  • 支持以英文大小写字母、数字开头和结尾。​
  • 支持特殊字符:短划线(-)、下划线(_)、英文句号(.)。​
​
Taint​
​
参数​
类型​
是否必选​
示例值​
描述​
Key​
String​
是​
taint-key​
污点键,要求如下,更多规则,请参见 Kubernetes 标签规则。​
有效的污点键有两个段:前缀和名称,用斜杠(/)分隔。​
  • 名称是必须的,支持英文大小写字母、数字、特殊字符- _ .,以字母或数字开头和结尾,长度不超过 63 个字符。​
  • 前缀是可选的。如果指定前缀,则必须是 DNS 子域:特殊字符.分隔的一系列 DNS 标签,长度不超过 253 个字符。​
  • 前缀和名称总长度不超过 82 个字符。​
Value​
String​
否​
taint-value​
污点值,要求如下,更多规则,请参见 Kubernetes 标签规则。​
  • 长度不超过 63 个字符(可以为空)。​
  • 支持以英文大小写字母、数字开头和结尾。​
  • 支持特殊字符:- _ .​
Effect​
String​
否​
NoSchedule​
污点效果,取值:​
  • NoSchedule:不调度。​
  • NoExecute:驱逐没有容忍污点的 Pod。​
  • PreferNoSchedule:尽量避免调度。​
​
NodePoolKubeletConfig​
​
参数​
类型​
是否必选​
示例值​
描述​
FeatureGates​
Object of 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。​
MaxPods​
Integer​
否​
110​
节点支持的最大 Pod 数量。​
KubeApiQps​
Integer​
否​
50​
与 APIServer 通信的每秒查询个数。整数形式,取值范围为 1~500。​
KubeApiBurst​
Integer​
否​
100​
每秒发送到 APIServer 的突发请求数量上限。整数形式,取值范围为 1~1000。​
说明​
该值必须大于等于KubeApiQps参数的值。​
CpuCfsQuota​
Boolean​
否​
false​
是否为设置了 CPU 限制的容器启用 CPU CFS 配额保障。​
  • true:启用​
  • false:不启用​
EvictionHard​
Array of EvictionHard​
否​
-​
触发 Pod 驱逐操作的一组硬性门限。详细参数解释,请参见 官方文档。​
如果希望显式地禁用,可以在任意资源上将其阈值设置为 0% 或 100%。​
KubeReserved​
Array of ComputeResource​
否​
-​
节点预留给 Kubernetes 系统组件的资源。默认按照 节点预留资源策略 中默认值的一半进行资源预留。​
SystemReserved​
Array of ComputeResource​
否​
-​
节点预留给操作系统的资源。默认按照 节点预留资源策略 中默认值的一半进行资源预留。​
RegistryPullQps​
Integer​
否​
5​
集群从镜像仓库拉取镜像的 QPS 阈值。整数形式,取值范围为 1~50。​
RegistryBurst​
Integer​
否​
10​
集群从镜像仓库拉取镜像的突发阈值。整数形式,取值范围为 1~100。​
说明​
仅当RegistryPullQps大于 0 时需要配置,且取值必须大于等于RegistryPullQps参数的值。​
SerializeImagePulls​
Boolean​
否​
true​
是否串行拉取镜像,取值:​
  • true:串行拉取镜像。​
  • false:(默认值)并行拉取镜像,能够提高 Pod 启动速度。​
CpuManagerPolicy​
String​
否​
none​
CPU 管理器策略。取值:​
  • none:默认策略。​
  • static:允许为节点上具有某些资源特征的 Pod 赋予更强的 CPU 亲和性和独占性。​
FailSwapOn​
Boolean​
否​
false​
当节点开启了 Swap 交换分区时,是否允许运行 kubelet。取值:​
  • true:(默认值)禁止节点在开启 Swap 的情况下运行 kubelet。这是 Kubernetes 的默认保护机制。由于 Swap 会干扰内存限制(memory limit)的精确控制,导致容器实际占用的内存超出预期,进而影响 Pod 调度和 OOM 判断的准确性。​
  • false:允许节点在开启 Swap 的情况下运行 kubelet。适用于对内存隔离要求不严格、或需要在已有 Swap 配置的存量节点上运行 Kubernetes 的场景。​
PodPidsLimit​
Integer​
否​
4096​
限制单个 Pod 内所有容器可使用的进程 ID(PID)数量上限,避免单个 Pod 创建过多进程而耗尽节点的 PID 资源。​
  • 整数形式,取值范围为 -1 或正整数。单位为个。​
  • 当取值为 -1 时,表示不限制单个 Pod 可使用的 PID 数量。​
说明​
  • 该配置仅限制单个 Pod 的 PID 使用量,Pod 实际可用的 PID 数量还会受到节点内核 PID 上限及节点上其他进程 PID 使用情况的影响。​
  • 不建议将该参数设置为 -1。建议结合节点的 PID 容量、单个 Pod 的进程规模及节点可运行的 Pod 数量合理设置,避免单个 Pod 耗尽节点 PID 资源;同时避免设置过小,导致 Pod 无法正常创建进程。​
ImageMaximumGcAge​
String​
否​
24h​
未使用镜像被垃圾回收前的最长保留时长。超过该时间未被使用的镜像,在下次垃圾回收时将被清理。​
  • Kubernetes duration 字符串格式,支持时间单位,例如 48h、168h。​
  • 默认值为 0s,表示不按时间限制清理镜像,仅依据磁盘使用率(ImageGcHighThresholdPercent)触发回收。​
注意​
  • 当该参数配置为非 0 取值时,必须大于ImageMinimumGcAge。​
  • 仅 Kubernetes v1.30 及以上版本集群,支持配置该参数。​
ImageMinimumGcAge​
String​
否​
5m​
未使用镜像被垃圾回收前的最短保留时长。在该时间内,镜像不会被垃圾回收,即使磁盘使用率已超过回收阈值。​
  • Kubernetes duration 字符串格式,支持时间单位,例如 2m、30m。​
  • 默认值为 2m。​
  • 该参数可防止刚拉取的镜像被立即回收,保障镜像拉取与容器启动之间的时间窗口。​
说明​
该值不宜设置过大,否则在磁盘紧张时无法及时清理新近下载但短期未使用的镜像,可能加剧磁盘压力。​
ImageGcLowThresholdPercent​
Integer​
否​
80​
镜像垃圾回收停止阈值。在镜像垃圾回收执行过程中,当磁盘使用率降到该百分比以下时,停止回收。​
  • 整数形式,取值范围为 0~100。​
  • 默认值为 80。​
  • 单位为百分比。​
注意​
  • 配置该参数时,需保证ImageGcLowThresholdPercent小于ImageGcHighThresholdPercent。即使仅修改其中一个参数,系统也会结合另一个参数的默认值或原有配置进行校验。​
  • 实际配置时,该参数允许配置为 0,但这意味着系统要把磁盘清理到 0% 才会停止,几乎不可能达到,不具备实际意义。​
ImageGcHighThresholdPercent​
Integer​
否​
85​
镜像垃圾回收触发阈值。当磁盘使用率超过该值时,将触发垃圾回收,清理未使用的镜像以释放磁盘空间。​
  • 整数形式,取值范围为 0~100。​
  • 默认值为 85。​
  • 单位为百分比。​
注意​
  • 配置该参数时,需保证ImageGcLowThresholdPercent小于ImageGcHighThresholdPercent。即使仅修改其中一个参数,系统也会结合另一个参数的默认值或原有配置进行校验。​
  • 实际配置时,该参数允许配置为 100,但这意味着磁盘使用率为 100% 才会触发清理,属于极端保守,生产环境不推荐。​
​
FeatureGates​
​
参数​
类型​
是否必选​
示例值​
描述​
QoSResourceManager​
Boolean​
否​
false​
是否启用 QoS 资源管理器,用于支持微拓扑调度。取值:​
  • true:启用 QoS 资源管理器。​
  • false:不启用 QoS 资源管理器。​
说明​
该配置仅支持在以下版本的集群中使用:​
  • v1.24.15-vke.13 ≤ 集群版本 < v1.26​
  • v1.26.10-vke.13 ≤ 集群版本 < v1.28​
InPlacePodVerticalScaling​
Boolean​
否​
true​
是否开启 Pod 垂直伸缩功能,取值:​
  • true:开启​
  • false:关闭​
注意​
该配置仅支持在如下版本集群中使用,其余版本集群不支持配置,否则报错:​
  • v1.28.3-vke.17 ≤ 集群版本 < v1.36​
​
EvictionHard​
​
参数​
类型​
是否必选​
示例值​
描述​
Key​
String​
是​
memory.available​
硬性门限名称。取值:​
  • memory.available​
  • nodefs.available​
  • nodefs.inodesFree​
  • imagefs.available​
Value​
String​
是​
1Gi​
硬性门限值。支持整数形式或百分比形式:​
  • 整数形式:表示资源的具体门限值,单位为字节,例如 100Mi。​
  • 百分比形式:表示资源的门限值占比,取值范围为 0%~100%,例如 20%。如果希望显式地禁用,可以在任意资源上将其阈值设置为 0% 或 100%。​
​
ComputeResource​
​
参数​
类型​
是否必选​
示例值​
描述​
Name​
String​
是​
cpu​
资源名称,取值为 cpu 或 memory。​
Quantity​
String​
是​
1G​
指定资源的资源量。​
  • 当资源为 cpu 时,取值示例为 200m。​
  • 当资源为 memory 时,取值示例为 1G。​
​
NodePoolRuntimeRequest​
​
参数​
类型​
是否必选​
示例值​
描述​
Type​
String​
否​
containerd​
容器运行时类型,取值:​
  • containerd:containerd 运行时。​
Version​
String​
否​
1.6.38​
容器运行时版本,格式为x.x.x。​
容器服务已发布的 containerd 版本,请参见 containerd 运行时发布记录。​
注意​
更新后的 containerd 版本仅对节点池中新扩容出的节点生效。​
​
NodePoolContainerdConfig​
​
参数​
类型​
是否必选​
示例值​
描述​
ConcurrentLayerFetchBuffer​
Integer​
否​
512​
并发分块拉取单个镜像层时使用的缓冲区大小。正整数形式,单位为 Byte。​
说明​
仅 containerd 为 v2.1.0 及以上版本时,支持配置该参数。​
MaxConcurrentUnpacks​
Integer​
否​
8​
containerd 同时解压镜像层的最大数量。​
  • 正整数形式,默认值为 1。​
  • 仅在UseLocalImagePull配置为false时生效。​
说明​
仅 containerd 为 v2.2.0 及以上版本时,支持配置该参数。​
MaxConcurrentDownloads​
Integer​
否​
10​
containerd 单次拉取镜像时可并发下载的镜像层最大数量。​
  • 正整数形式,默认值为 3。​
  • 未配置时,系统使用默认值。​
说明​
仅 containerd 为 v2.1.0 及以上版本时,支持配置该参数。​
UseLocalImagePull​
Boolean​
否​
true​
containerd 的镜像拉取模式。取值:​
  • true:(默认值)使用本地客户端拉取镜像。​
  • false:使用 Transfer Service 拉取镜像。​
说明​
仅 containerd 为 v2.1.0 及以上版本时,支持配置该参数。​
​
NodeConfigForUpdate​
​
参数​
类型​
是否必选​
示例值​
描述​
InstanceTypeIds​
Array of String​
否​
["ecs.g1ie.large"]​
节点对应的 ECS 实例规格 ID 列表。传入参数值,表示更新节点池的原有规格。更新规格后,支持按照新的规格扩容,存量老规格的节点不受影响。​
调用 ListSupportedResourceTypes 接口查询集群所支持的资源类型和范围。​
注意​
  • 支持最多传入十个数组元素。​
  • 更新节点池规格时,GPU 型规格只能更换为 GPU 型规格,非 GPU 型规格只能更换为非 GPU 型规格。​
  • 不支持更换为云服务器(ECS)已停止售卖的规格。​
SubnetIds​
Array of String​
否​
["subnet-3rf6wbg******"]​
节点网络所属的子网 ID 列表。​
可以调用 私有网络 API 获取子网 ID。​
注意​
  • 必须与集群处于同一个私有网络内。​
  • 若传入该参数,则必须传入全量的子网 ID 列表,且只能在节点池原有子网 ID 基础上新增子网 ID,不能减少。​
  • 单个节点池最多支持关联 8 个子网 ID。​
SystemVolume​
Object of SystemVolume​
否​
-​
节点的系统盘配置。​
调用云服务器的 DescribeInstanceTypes 接口获取云服务器实例规格族与云盘规格的匹配关系。​
DataVolumes​
Array of DataVolume​
否​
-​
节点的数据盘配置。​
调用云服务的 DescribeInstanceTypes 接口获取云服务器实例规格族与云盘规格的匹配关系。​
AdditionalContainerStorageEnabled​
Boolean​
否​
false​
配置节点的第一块数据盘并格式化挂载作为容器镜像和日志的存储目录,取值范围:​
  • false:关闭​
  • true:开启​
InitializeScript​
String​
否​
ZWNoby******​
创建并初始化节点后执行的自定义脚本。​
支持 Shell 格式且需要对脚本内容进行 Base64 编码后传入。​
说明​
Base64 编码后长度不超过 8 KB。若同时传入 InitializeScript 和 PreScript,则两个参数的传入值总长度也不能超过 8 KB。​
Security​
否​
-​
节点安全配置。​
Period​
Integer​
否​
12​
云服务器实例购买时长。取值如下,单位为月:​
1、2、3、4、5、6、7、8、9、12、24、36​
说明​
  • 仅当节点池的InstanceChargeType=PrePaid时才可以修改。​
AutoRenew​
Boolean​
否​
true​
云服务器实例到期后是否自动续费,取值如下:​
  • true:自动续费​
  • false:不自动续费​
说明​
  • 仅当节点池的InstanceChargeType=PrePaid时才可以修改。​
AutoRenewPeriod​
Integer​
否​
1​
云服务器实例每次自动续费时长。取值如下,单位为月:​
1、2、3、6、12​
说明​
  • 仅当节点池的InstanceChargeType=PrePaid时才可以修改,且仅当AutoRenew=true时生效。​
NamePrefix​
String​
否​
prefix-name​
节点名称前缀。取值为空字符串时表示不启用节点命名前缀。前缀校验规则如下:​
  • 支持英文大小写字母、数字和中划线(-)。​
  • 只能以英文字母开头,英文字母或数字结尾。​
  • 不能连续使用中划线(-)。​
  • 长度限制为 2~51 个字符。​
Tags​
Array of Tag​
否​
-​
节点对应 ECS 实例绑定的标签信息,用于搜索、管理 ECS 实例。​
  • Tags 中各个 Key 不可重复。​
  • 资源已有相同 Tags.Key 的情况下,重复绑定 Tags.Key 不会报错,会更新为最新的 Tags.Value。​
  • 单个资源最多支持绑定 20 个 ECS 实例标签。​
  • Tags 中的 Key、Value 不允许在最前或最后输入空格。​
HpcClusterIds​
Array of String​
否​
["hpcCluster-1"]​
高性能计算集群 ID。​
  • 从 GPU 计算型 规格修改为 高性能计算 GPU 型 规格的节点池时,需要指定高性能计算集群ID。在 云服务器控制台 的 实例与镜像 > 高性能计算集群 页面获取 ID。​
说明​
  • 请确保指定的高性能计算集群与 SubnetIds 中指定的子网同属一个可用区。​
  • 从 高性能计算 GPU 型 规格修改为 GPU 计算型 规格的节点池时,需要传入空数组将已有的高性能计算集群 ID 置空。​
InstancesDistribution​
否​
-​
设置抢占式实例和按量实例的混合策略。当SpotStrategy为SpotAsPriceGo时,该策略生效。​
ImageId​
String​
否​
image-kd********​
节点对应的 ECS 实例使用的镜像 ID。​
不同的镜像类型对应的镜像 ID 也不同,详细说明,请参见 容器服务支持的公共镜像。​
注意​
  • 若不传该参数,优先分配 veLinux 2.0 系列的镜像 ID。​
  • 当传入多个规格时,该参数必填。​
ProjectName​
String​
否​
default​
节点池中扩容出来的 ECS 所属的项目名称,一个 ECS 只能归属于一个项目。​
  • 只能包含英文字母、数字、下划线(_)、英文句点(.)和中划线(-)。​
  • 长度限制在 64 个字符以内。​
PublicAccessEnabled​
Boolean​
否​
false​
是否开启节点自动绑定公网 IP(EIP)能力,取值:​
  • true:开启。系统自动为集群下的节点分配 EIP,此时您还需要配置 PublicAccessConfig 参数,自定义 EIP 配置。​
PublicAccessConfig​
Object of EipConfigRequest​
否​
-​
为节点自动绑定 EIP 相关配置。​
Hostname​
String​
否​
test-name​
节点对应的主机名称,支持定义固定增长排序和动态扩展排序,相关定义格式说明,请参见 命名格式。​
PreScript​
String​
否​
ZWNoby******​
部署节点前执行的脚本。输入Base64 编码后的 Shell 格式脚本。​
说明​
Base64 编码后长度不超过 8 KB。若同时传入 InitializeScript 和 PreScript,则两个参数的传入值总长度也不能超过 8 KB。​
InstanceName​
String​
否​
instance-test​
节点(实例)名称,支持定义固定增长排序和动态扩展排序,相关定义格式说明,请参见 命名格式。​
CpuMaxFrequency​
Double​
否​
2.875​
节点 CPU 最大频率。​
  • 最大支持 3 位小数,取值范围为 CPU 主频到 CPU 睿频之间。​
  • 单位为 GHz。​
NetworkTrafficMode​
String​
否​
Standard​
节点间的网络通讯模式,取值如下:​
  • HighPerformance:基于 RDMA 进行数据传输的通讯方式。​
  • Standard:基于 TCP 进行数据传输的通讯方式。​
SpotStrategy​
String​
否​
SpotWithPriceLimit​
按量计费的抢占式策略,当InstanceChargeType=PostPaid时,该参数生效。取值:​
  • NoSpot:正常按量计费实例。​
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。​
  • SpotWithPriceLimit:按实例规格设置价格上限。​
GpuDriverConfig​
Object of GpuDriverConfig​
否​
-​
节点 GPU 驱动配置。该配置的优先级高于GpuDriverVersion字段。​
说明​
若未配置该参数,且节点池中的 ECS 实例为 GPU 机型时,系统会自动配置InstallGpuDriver为true,并填充推荐的 GPU 驱动版本。​
SpotPriceLimits​
否​
-​
抢占式实例的价格上限。​
  • 仅当SpotStrategy为SpotWithPriceLimit时生效。​
  • 数组形式,每项绑定一个实例规格及其价格上限(单位:元/小时)。​
GpuDriverVersion​
String​
否​
550.127.05​
【该参数已废弃,请使用 GpuDriverConfig 代替】指定在节点上安装的 GPU 驱动版本。​
可以调用 ListSupportedGpuDriverVersions 接口,获取镜像支持安装的 GPU 驱动版本列表。​
InstanceChargeType​
String​
否​
PostPaid​
节点池内节点对应 ECS 实例的计费类型,取值:​
  • PostPaid:按量计费​
  • PrePaid:包年包月​
  • 两种计费类型相互变更时,需要注意以下事项:​
  • 包年包月 类型的节点池,可更改为普通 按量计费 节点池。​
  • 按量计费 类型的节点池,满足如下条件时,可更改为 包年包月 节点池:​
  • 未开启抢占式策略,即SpotStrategy为NoSpot。​
  • 未开启弹性伸缩,即AutoScaling·Enabled为false。​
  • 未启用弹性预约扩容规则,即调用ListScalingPolicies 接口查询结果为空,或者不为空但Enabled为false。​
注意​
  • 节点池计费类型从 按量计费 转成 包年包月 后,需要传入 Period、AutoRenew、AutoRenewPeriod 三个参数。​
  • 更新节点池内节点计费类型后,仅对新扩容的节点生效,存量节点请前往 云服务器控制台 手动修改。​
AffinityGroupConfig​
Object of AffinityGroupConfig​
否​
-​
【邀测·申请试用】节点池亲和组配置。​
注意​
使用该功能时,除了获取 VKE 侧功能邀测权限以外,您还需要申请 ECS 侧亲和组相关功能邀测权限。请联系您的火山引擎客户经理咨询。​
​
SystemVolume​
​
参数​
类型​
是否必选​
示例值​
描述​
Type​
String​
否​
ESSD_PL0​
云盘类型:​
  • ESSD_PL0:极速型 SSD 云盘,PL0 规格。​
  • ESSD_FlexPL:极速型 SSD 云盘,FlexPL 规格。​
  • Ultra_Disk:高效型 SSD 云盘。​
  • TSSD_TL0:吞吐型 SSD 云盘,TL0 规格。​
注意​
【邀测】:高效型 SSD 云盘(Ultra_Disk)为 EBS 产品的邀测功能,且仅支持在部分地域和 ECS 实例中使用。如需使用,请联系您的客户经理。​
Size​
Integer​
否​
40​
云盘容量,单位 GiB,取值范围:40~2048。​
BurstEnabled​
Boolean​
否​
true​
是否开启性能突发。取值:​
  • true:开启。​
  • false:关闭。​
说明​
SubgroupNumber​
Integer​
否​
2​
系统盘所属的存储子放置组编号。​
可调用 DescribePlacementGroupDetails 接口获取放置子组编号。​
PlacementGroupId​
String​
否​
pg-bp67*******​
系统盘所属的存储放置组 ID。​
可调用 DescribePlacementGroupDetails 接口获取放置组 ID。​
ExtraPerformanceIops​
Integer​
否​
10​
云盘额外性能的 IOPS,仅当ExtraPerformanceTypeId为IOPS或Balance生效,整数形式,单位为次/秒,取值范围 1~50000。​
ExtraPerformanceTypeId​
String​
否​
Bal****​
云盘额外性能类型。​
  • 当云盘性能规格为ESSD_FlexPL时允许配置。取值:​
  • Balance:均衡型额外性能。​
  • IOPS:IOPS 型额外性能。​
  • Throughput:吞吐量型额外性能。​
  • 当云盘性能规格为TSSD_TL0时允许配置。取值:​
  • Throughput:吞吐量型额外性能。​
ExtraPerformanceThroughputMb​
Integer​
否​
10​
云盘额外性能的吞吐量。仅当ExtraPerformanceTypeId为Throughput时生效,整数形式,单位为 MB/s。​
  • 当云盘性能规格为TSSD_TL0时,说明如下:​
  • 取值范围与云盘容量相关,吞吐量性能计算公式为min {120 + 0.5 × 容量(GiB),1000},最大不能超过云盘的最大吞吐量 1000MB/s。更多详情,请参见 吞吐型 SSD 云盘。​
  • 例如:当云盘容量为 500GiB 时,根据计算公式,基础吞吐量为 120 + 0.5 × 500 = 370MB/s。此时允许配置的额外性能取值范围为 1~630。​
  • 例如:当云盘容量为 2000GiB 时,根据计算公式,基础吞吐量为 120 + 0.5 × 2000 = 1120MB/s。此时已超过允许的最大吞吐量,因此不能再配置额外性能。​
​
DataVolume​
​
参数​
类型​
是否必选​
示例值​
描述​
Type​
String​
否​
ESSD_PL0​
磁盘类型,支持选择云盘和本地盘。​
  • 云盘:​
  • ESSD_PL0:极速型 SSD 云盘,PL0 规格。​
  • ESSD_FlexPL:极速型 SSD 云盘,FlexPL 规格。​
  • Ultra_Disk:高效型 SSD 云盘。​
  • TSSD_TL0:吞吐型 SSD 云盘,TL0 规格。​
  • RSSD_PL0:弹性远程盘,PL0 规格。​
  • 本地盘:​
  • LOCAL_SSD:SSD 类型本地盘。​
  • LOCAL_HDD:HDD 类型本地盘。​
  • LOCAL_LVM_SSD:SSD LVM 逻辑本地盘。​
  • LOCAL_SSD_SRIOV:SSD SRIOV 本地盘。​
注意​
  • 【邀测】:弹性远程盘(RSSD_PL0)、高效型 SSD 云盘(Ultra_Disk)均为 EBS 产品的邀测功能,且仅支持在部分地域和 ECS 实例中使用。如需使用,请联系您的客户经理。​
  • 当配置为本地盘时:​
  • 本地盘随 ECS 实例提供,指定本地盘类型不会创建本地盘。​
  • 请确认节点池配置的实例规格支持对应的本地盘类型。详情请参见 本地盘。​
  • 在节点池中配置的本地盘数量,不能超过 ECS 实例挂载的本地盘的数量。可调用 DescribeInstanceTypes 接口,查询实例挂载的本地盘数量。​
Size​
Integer​
否​
20​
磁盘容量,单位 GiB,取值范围:​
  • 极速型 SSD 云盘(ESSD_PL0,ESSD_FlexPL):取值范围为 20~32768。​
  • 高效型 SSD 云盘(Ultra_Disk):取值范围为 20~32768。​
  • 吞吐型 SSD 云盘(TSSD_TL0):取值范围为 40~32768。​
  • 弹性远程盘(RSSD_PL0):取值范围为 256~16384。​
MountPoint​
String​
否​
/vke​
磁盘格式化后的目标挂载目录,取值要求如下:​
  • 必须以/开头。​
  • 长度限制为 1~255 个字符。​
  • 不同数据盘的挂载目录不允许重复。​
FileSystem​
String​
否​
Ext4​
【邀测·申请试用】节点池数据盘的文件系统,取值:​
  • Ext4​
  • Xfs​
SnapshotId​
String​
否​
snap-31ak********​
使用快照创建数据盘时的快照 ID。您可以调用 DescribeSnapshots 接口查询快照 ID。​
说明​
  • 仅极速型 SSD 和高效性云盘支持通过快照创建云盘。​
  • 仅如下状态的快照,支持创建云盘:​
  • available​
  • creating​
  • rollbacking​
KmsKeyId​
String​
否​
e91b2a39-72********​
配置数据盘加密时使用的 KMS 密钥 ID。仅当Encrypted为true时有效。​
  • 未配置该参数或取值为空时,表示使用默认密钥。​
  • 自定义密钥时必填,指定加密使用的 KMS 密钥 ID。​
Encrypted​
Boolean​
否​
true​
是否开启数据盘加密功能,包括:​
  • true:开启数据盘加密。开启后,数据盘中的文件将以加密形式存储,防止数据在存储层面被未授权访问,满足数据安全合规要求。​
  • false:禁用数据盘加密。​
BurstEnabled​
Boolean​
否​
true​
是否开启性能突发。取值:​
  • true:开启。​
  • false:关闭。​
说明​
SubgroupNumber​
Integer​
否​
2​
数据盘所属的存储子放置组编号。​
可以调用 DescribePlacementGroupDetails 接口查询存储子放置组编号。​
PlacementGroupId​
String​
否​
pg-bp67a********​
数据盘所属的存储放置组 ID。​
可以调用 DescribePlacementGroups 接口查询存储放置组 ID。​
ExtraPerformanceIops​
Integer​
否​
10​
云盘额外性能的 IOPS,仅当ExtraPerformanceTypeId为IOPS或Balance生效,整数形式,单位为次/秒,取值范围 1~50000。​
ExtraPerformanceTypeId​
String​
否​
Bal****​
云盘额外性能类型。​
  • 当云盘性能规格为ESSD_FlexPL时允许配置。取值:​
  • Balance:均衡型额外性能。​
  • IOPS:IOPS 型额外性能。​
  • Throughput:吞吐量型额外性能。​
  • 当云盘性能规格为TSSD_TL0时允许配置。取值:​
  • Throughput:吞吐量型额外性能。​
ExtraPerformanceThroughputMb​
Integer​
否​
10​
云盘额外性能的吞吐量。仅当ExtraPerformanceTypeId为Throughput时生效,整数形式,单位为 MB/s。​
  • 当云盘性能规格为TSSD_TL0时,说明如下:​
  • 取值范围与云盘容量相关,吞吐量性能计算公式为min {120 + 0.5 × 容量(GiB),1000},最大不能超过云盘的最大吞吐量 1000MB/s。更多详情,请参见 吞吐型 SSD 云盘。​
  • 例如:当云盘容量为 500GiB 时,根据计算公式,基础吞吐量为 120 + 0.5 × 500 = 370MB/s。此时允许配置的额外性能取值范围为 1~630。​
  • 例如:当云盘容量为 2000GiB 时,根据计算公式,基础吞吐量为 120 + 0.5 × 2000 = 1120MB/s。此时已超过允许的最大吞吐量,因此不能再配置额外性能。​
​
NodeSecurityForUpdate​
​
参数​
类型​
是否必选​
示例值​
描述​
Login​
Object of NodeLoginRequest​
否​
-​
节点的访问方式配置。​
支持密码方式或密钥对方式。同时传入时,优先使用密钥对。​
SecurityGroupIds​
Array of String​
否​
["sg-2byy13cns******"]​
节点网络所在的安全组 ID 列表。​
调用私有网络的 DescribeSecurityGroups 接口,获取安全组 ID。单次最多填写 100 个安全组 ID。​
注意​
  • 必须与集群处于同一个私有网络内。​
  • 取值为空时,默认使用 集群节点默认安全组(命名格式为<集群ID>-common)。默认安全组相关说明,请参见 安全组设置。​
  • 单个节点池最多支持关联 5 个安全组(含集群节点默认安全组)。​
SecurityStrategies​
Array of String​
否​
["Hids"]​
安全策略,取值:​
  • Hids:HIDS 主机防护​
​
NodeLoginRequest​
​
参数​
类型​
是否必选​
示例值​
描述​
Password​
String​
否​
UHdkM******​
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 个字符。​
​
InstancesDistribution​
​
参数​
类型​
是否必选​
示例值​
描述​
CapacityRebalance​
Boolean​
否​
false​
是否开启按量实例补充抢占式容量能力。取值:​
  • true:开启。抢占式实例即将被回收前,主动创建新的抢占式实例进行补偿。​
  • false:不开启。等到抢占式实例被回收后才会扩容补齐实例数。​
OnDemandBaseCapacity​
Integer​
否​
0​
按量实例基础容量的大小。当节点池中按量实例个数少于该值时,将优先创建按量实例。​
取值范围根据节点池是否开启 弹性伸缩 功能(AutoScaling·Enabled为true),可取值范围也不同,最大取值不超过 500。具体如下:​
  • 未开启弹性伸缩时:0 ~ 节点池的期望节点数量。​
  • 已开启弹性伸缩时:0 ~ 弹性伸缩的节点数量最小范围。​
CompensateWithOnDemand​
Boolean​
否​
false​
是否启用按量实例替补功能。取值:​
  • true:开启。当所有抢占式实例因库存不足等原因全部购买失败后,尝试购买按量实例。​
  • false:不开启。仅在需要扩容抢占式实例时尝试所配置的抢占式实例。​
OnDemandPercentageAboveBaseCapacity​
Integer​
否​
0​
节点池扣除按量实例基础容量后,其余按量实例的百分比。按百分比计算按量实例数时,向上取整。​
  • 取值范围:0~100。​
  • 单位:%。​
  • 100 代表仅生产按量实例。​
​
EipConfigRequest​
​
参数​
类型​
是否必选​
示例值​
描述​
Isp​
String​
否​
BGP​
公网 IP 的线路类型,取值:​
  • BGP:BGP(多线)。​
Bandwidth​
Integer​
否​
100​
公网 IP 的带宽峰值,单位为 Mbps,取值:​
  • BillingType=2时:取值范围 1 ~ 500。​
  • BillingType=3时:取值范围 1 ~ 200。​
BillingType​
Integer​
否​
3​
公网 IP 的计费类型,取值:​
  • 3:按量计费-按实际流量计费,即指定带宽上限后,将按照实际使用的出公网流量计费,与使用时长无关。​
  • 2:按量计费-按带宽上限计费,即指定带宽上限后,将按照使用时长计费,与实际流量无关。​
BandwidthPackageId​
String​
否​
bwp-2zeo********​
共享带宽包的 ID,表示将公网 IP 加入到共享带宽包。​
共享带宽包 ID 请调用 DescribeBandwidthPackages 接口获取。​
注意​
公网 IP 加入到共享带宽包时,必须同时满足如下条件:​
  • 二者的线路类型相同。​
  • 共享带宽包为 IPv4 类型。​
  • 共享带宽包未配置安全防护。​
​
GpuDriverConfig​
​
参数​
类型​
是否必选​
示例值​
描述​
GpuDriverVersion​
String​
否​
580.105.08​
指定节点安装的 GPU 驱动版本号。​
  • 当配置为空时,系统会按照 GPU 机型自动填充推荐的 GPU 驱动版本。​
注意​
当您在节点池中指定多个 ECS 实例规格时,不同实例规格支持的 GPU 驱动可能不同,你需要指定多个实例规格共同支持的 GPU 驱动,否则会报错。​
InstallGpuDriver​
Boolean​
否​
true​
当节点对应的 ECS 实例为 GPU 机型,且使用公共基础镜像(例如 veLinux 1.0、Ubuntu 22.04)时,是否自动安装 GPU 驱动。取值:​
  • true:自动安装 GPU 驱动。配置为该参数时,您可以使用GpuDriverVersion参数指定具体的 GPU 驱动。​
  • false:不自动安装 GPU 驱动。​
说明​
当 ECS 实例为非 GPU 机型时,该配置不生效。​
​
InstanceTypeSpotPriceLimit​
​
参数​
类型​
是否必选​
示例值​
描述​
InstanceTypeId​
String​
是​
ecs.g1i*******​
实例规格 ID,指定的规格必须在节点对应的 ECS 实例规格 ID 列表中。即使用InstanceTypeIds参数指定了该规格。​
SpotPriceLimit​
Double​
是​
0.321​
该实例规格的抢占式价格上限,单位为:元/小时。最多三位小数。​
​
AffinityGroupConfig​
​
参数​
类型​
是否必选​
示例值​
描述​
Size​
Integer​
否​
2​
【邀测·申请试用】节点池使用的亲和组规格。请调用 DescribeInstanceTypes 接口获取亲和组规格。​
Enabled​
Boolean​
否​
false​
【邀测·申请试用】节点池是否开启亲和组配置。取值:​
  • true:开启,即以亲和组方式购买节点池内节点。​
  • false:关闭,按照非亲和组方式购买节点。​
​
NodePoolAutoScalingRequest​
​
参数​
类型​
是否必选​
示例值​
描述​
Enabled​
Boolean​
否​
false​
配置节点池弹性伸缩功能开关,取值:​
  • false:关闭。​
  • true:开启。​
Priority​
Integer​
否​
10​
优先级,取值范围:0~100。​
注意​
仅针对节点池开启弹性伸缩功能且扩容算法为priority时生效。​
MaxReplicas​
Integer​
否​
10​
配置节点池的最大节点数,取值范围:1~2000。​
注意​
仅在节点池开启弹性伸缩功能后,对该节点池生效。​
MinReplicas​
Integer​
否​
0​
配置节点池的最小节点数,取值说明:​
  • 最小值:0​
  • 最大值:小于 MaxReplicas 参数的值​
注意​
仅在节点池开启弹性伸缩功能后,对该节点池生效。​
SubnetPolicy​
String​
否​
ZoneBalance​
节点池的多子网调度策略,用于在 Worker 节点扩容时按照子网优先级顺序进行调度。取值:​
  • ZoneBalance:可用区均衡策略,节点扩容时,新增的节点会分散到多个可用区的子网下,且保证各个可用区中的节点数相对均衡。​
  • Priority:子网优先级策略,按照子网列表的先后顺序调度。如果优先级最高的子网可以创建成功,则总在该子网下新增节点。​
DesiredReplicas​
Integer​
否​
0​
配置节点池的期望节点数,取值范围:0~2000。​
注意​
节点池开启弹性伸缩功能时,DesiredReplicas 需大于等于 MinReplicas 参数的值,小于等于 MaxReplicas 参数的值。​
​
NodePoolManagementRequest​
​
参数​
类型​
是否必选​
示例值​
描述​
Enabled​
Boolean​
否​
false​
节点池是否开启托管模式。取值:​
  • true:开启。​
  • false:关闭。​
说明​
节点池开启托管后,将为新扩容的实例默认安装批量作业 Agent。​
RemedyConfig​
Object of RemedyConfigRequest​
否​
-​
节点池的检查和自愈规则配置。​
​
RemedyConfigRequest​
​
参数​
类型​
是否必选​
示例值​
描述​
Enabled​
Boolean​
否​
false​
节点池开启托管模式后,是否开启节点检查自愈。取值:​
  • true:开启。​
  • false:关闭。​
Id​
String​
否​
R2025091********​
节点池开启检查自愈后,待关联的节点自愈规则 ID。如果未指定,节点池将自动创建并绑定规则。​
在 容器服务控制台 上目标集群的 检查自愈 页面查看检查自愈规则 ID。​
​
请求示例​
​
POST https://vke.cn-beijing.volcengineapi.com?Action=UpdateNodePoolConfig&Version=2022-05-12​
Content-Type: application/json​
{​
"ClientToken": "BC028527-33B9-4990-A633-84E9F9******",​
"ClusterId": "cc5silu*******",​
"Id": "pc51i0*******",​
"Name": "test-nodepool",​
"KubernetesConfig": {​
"Labels": [​
{​
"Key": "label-key",​
"Value": "label-value"​
}​
],​
"Taints": [​
{​
"Key": "taint-key",​
"Value": "taint-value",​
"Effect": "NoSchedule"​
}​
],​
"Cordon": false,​
"NamePrefix": "name-prefix",​
"NameSuffix": "-demo",​
"NameUseHostname": true,​
"AutoSyncDisabled": false​
},​
"NodeConfig": {​
"InstanceTypeIds": [​
"ecs.**.**"​
],​
"SubnetIds": [​
"subnet-3rf6wbg******"​
],​
"SystemVolume": {​
"Type": "ESSD_PL0",​
"Size": 40​
},​
"DataVolumes": [​
{​
"Type": "ESSD_PL0",​
"Size": 20,​
"FileSystem": "Ext4",​
"MountPoint": "/vke"​
}​
],​
"AdditionalContainerStorageEnabled": false,​
"InitializeScript": "ZWNoby******",​
"Security": {​
"SecurityGroupIds": [​
"sg-2byy13cn******"​
],​
"SecurityStrategies": [​
"Hids"​
],​
"Login": {​
"Password": "UHdkM******",​
"SshKeyPairName": "test-key"​
}​
},​
"Period": 12,​
"AutoRenew": true,​
"AutoRenewPeriod": 1,​
"NamePrefix": "prefix-name",​
"Tags": [​
{​
"Key": "key",​
"Value": "value"​
}​
],​
"HpcClusterIds": [​
"hpcCluster-1"​
],​
"ImageId": "image-kd********",​
"ProjectName": "default",​
"PublicAccessEnabled": false,​
"PublicAccessConfig": {​
"Isp": "BGP",​
"Bandwidth": 100,​
"BillingType": 3​
},​
"Hostname": "test-name",​
"PreScript": "ZWNoby******",​
"InstanceName": "instance-test",​
"NetworkTrafficMode": "Standard",​
"GpuDriverConfig": {​
"GpuDriverVersion": "580.105.08",​
"InstallGpuDriver": true​
},​
"InstancesDistribution": {​
"CapacityRebalance": false,​
"OnDemandBaseCapacity": 0,​
"CompensateWithOnDemand": false,​
"OnDemandPercentageAboveBaseCapacity": 0​
}​
},​
"AutoScaling": {​
"Enabled": false,​
"Priority": 10,​
"MaxReplicas": 10,​
"MinReplicas": 0,​
"SubnetPolicy": "ZoneBalance",​
"DesiredReplicas": 0​
},​
"Management": {​
"Enabled": false,​
"RemedyConfig": {​
"Id": "R2025091********",​
"Enabled": false​
}​
}​
}​
​
返回参数​
本接口无专有返回参数,公共返回参数请参见 返回结果。​
返回示例​
​
HTTP/1.1 200 OK​
Content-Type:application/json​
​
{​
"ResponseMetadata": {​
"RequestId": "021635330********",​
"Action": "UpdateNodePoolConfig",​
"Version": "2022-05-12",​
"Service": "vke",​
"Region": "cn-beijing"​
},​
"Result": {}​
}​
​
错误码​
本接口错误码如下表所示,公共错误码请参见 公共错误码。​
​
HTTP 状态码​
错误码​
错误信息​
说明​
409​
Conflict.Name​
The specified name conflicts with existing {{resourceType}}.​
指定地域存在同名资源,请更新资源名称后重试。​
400​
OperationDenied.ClusterStatus​
The action is forbidden due to cluster status {{statusPhase}} and {{statusConditions}}.​
指定集群的当前状态不支持该操作。请确认该接口依赖的集群状态后重试。​
400​
OperationDenied.NodePoolStatus​
The action is forbidden on node pool {{nodePoolId}} due to node pool status {{statusPhase}} and {{statusConditions}}.​
指定节点池的当前状态不支持该操作。请确认该接口依赖的节点池状态后重试。​
400​
ClusterVpcMismatch.{{parameter}}​
The specified {{resourceType}} {{resourceId}} is not in the VPC of cluster.​
指定的子网、安全组、高性能计算集群与集群属于不同私有网络,请确保其与集群处于同一个私有网络内。​
400​
Mismatch.Replicas​
The specified DesiredReplicas, MinReplicas and MaxReplicas are mismatched.​
指定节点池的最小节点数、最大节点数、期望节点数逻辑不匹配。请确认参数后重试。​
400​
QuotaExceeded.Node​
The number of nodes in the cluster has reached the limit.​
您当前集群所要创建的节点数量超出系统限额。您可以选择其他地域,也可以 提交工单申请提高配额。​
400​
LimitExceeded.NodeInCluster​
The number of nodes exceeds the cluster defined pods config limit.​
Flannel 容器网络类型下,节点池设置的期望节点数超出了集群支持的最大节点数。容器服务各资源限制,请参见 使用限制。​
支持的最大节点数取决于 PodsConfig.FlannelConfig.PodCidrs 和 MaxPodsPerNode。集群创建完成后不支持修改,请合理规划集群设置。​
400​
UpdateNotAllowed.{{parameter}}​
The update to the specified parameter {{parameter}} is not allowed due to {{resourceType}}.​
节点池不支持更新:​
  • 当节点池为默认节点池时,Name、AutoScaling、NodeConfig 的部分属性不支持更新。​
  • 当节点池为包年包月节点池时,AutoScaling.Enabled 属性不支持更新。​
  • 当节点池为按量计费节点池时,NodeConfig.Period、NodeConfig.AutoRenew、NodeConfig.AutoRenewPeriod等属性不支持更新。​
400​
LimitExceeded.MaximumVolumes​
You have reached the limit of the number of volumes that you can create.​
云盘数量超过了单台 ECS 实例所能挂载的云盘数量。ECS 使用限制,请参见 约束限制。​
400​
LimitExceeded.DataVolumeSize​
You have reached the limit of the size of data volume that you can create.​
数据盘容量超过上限。ECS 使用限制,请参见 约束限制。​
400​
LimitExceeded.SystemVolumeSize​
You have reached the limit of the size of system volume that you can create.​
系统盘容量超过上限。ECS 使用限制,请参见 约束限制。​
400​
QuotaExceeded.{{ResourceType}}​
The quota of {{ResourceType}} has reached the limit.​
指定资源的配额达到上限,如 EIP、ECS、ECS Tag、EBS 等。请提升相关资源配额,或删除无用资源,预留出配额后重试。​
400​
ZoneMismatch.Subnet​
The specified Subnet {{subnetId}} is not in the cluster defined zones.​
指定的子网所属的可用区不在集群支持的可用区内。请使用匹配集群可用区的子网。​
400​
OutOfRange.DataVolumes​
There is no data volume for additional container storage enabling.​
启用了配置节点的第一块数据盘作为容器镜像和日志的存储目录(即AdditionalContainerStorageEnabled=true),但是 DataVolume 参数中并没有指定任何数据盘。请指定参数值后重试。​
400​
ZoneMismatch.InstanceType​
The specified InstanceType {{instanceType}} and subnet zones are mismatched.​
子网所在的可用区不支持该实例规格。请调用 ECS 的 DescribeAvailableResource 接口获取各可用区支持的实例规格情况,然后更新参数并重试。​
400​
InstanceTypeMismatch.VolumeType​
The specified VolumeType {{volumeType}} and InstanceType {{instanceType}} are mismatched.​
指定的实例规格和云盘规格不匹配。请调用 ECS 的 DescribeInstanceTypes 接口获取云服务器实例规格与云盘规格的匹配关系,然后更新参数并重试。​
400​
NotSupported.{{parameter}}​
The specified {{resourceType}} {{resourceContent}} is not supported.​
指定参数不支持,如 InstanceType、ImageId 等。请确认参数后重试。​
400​
ZoneMismatch.HpcCluster​
The specified HpcCluster {{hpcClusterID}} and subnet zones are mismatched.​
指定的高性能计算集群可用区与节点子网可用区不匹配。请确保两者可用区一致后重试。​
400​
ReplicasMismatch.OnDemandBaseCapacity​
The specified DesiredReplicas, MinReplicas and OnDemandBaseCapacity are mismatched.​
抢占式节点池中,OnDemandBaseCapacity 和 DesiredReplicas、MinReplicas 之间无法匹配。请确认参数后重试。​
400​
SpotStrategyMismatch.InstanceType​
The specified InstanceType {{instanceType}} and SpotStrategy {{spotStrategy}} are mismatched.​
指定的实例规格和抢占式策略不匹配。请重新指定实例规格后重试。​
400​
Insufficient.Balance​
Your account has run out of balance.​
当前账户余额不足。请充值账户后重试。​
400​
InstanceTypeMismatch.ImageId​
The specified ImageId {{imageId}} and InstanceType {{instanceType}} are mismatched.​
指定的镜像 ID(ImageId)与 ECS 实例规格(InstanceTypeIds)不匹配。请根据参数说明,配置准确的参数值后重试。​
400​
ClusterVersionMismatch.ImageId​
The specified ImageId {{imageId}} and KubernetesVersion {{kubernetesVersion}} are mismatched.​
指定的镜像 ID(ImageId)与 集群 Kubernetes 版本不匹配。请根据参数说明,配置准确的参数值后重试。​
400​
IpFamilyMismatch.{{parameter}}​
The specified {{resourceType}} {{resourceContent}} and IpFamily {{ipFamily}} are mismatched.​
指定的资源和网络协议栈不匹配。请确认资源支持的网络协议栈后重试。​
400​
LimitExceeded.LocalVolumes​
You have reached the limit of the number of local volumes that you can use.​
本地盘数量超过限制。请根据参数说明,配置准确的参数值后重试。​
400​
KubernetesVersionMismatch.{{parameter}}​
The specified config and kubernetes version are mismatched.​
指定的配置项和 Kubernetes 版本不匹配。请确认配置项对应支持的 Kubernetes 版本后重试。​
400​
ImageSizeMismatch.SystemVolumeSize​
The specified system volume size and image size are mismatched.​
指定的系统盘大小和镜像大小不匹配,系统盘需要比镜像大 10 GiB 以上。请根据参数说明,配置准确的参数值后重试。​
400​
SnapshotIdMismatch.DataVolumeType​
The specified data volume type {{volumeType}} and SnapshotId are mismatched.​
指定的数据盘类型和 SnapshotId 不匹配。请根据参数说明,配置准确的参数值后重试。​
400​
SnapshotIdMismatch.DataVolumeSize​
The specified data volume size and data SnapshotId are mismatched.​
数据盘指定的磁盘大小必须大于 SnapshotId 对应的云盘磁盘大小。​
400​
PlacementGroupMismatch.SubgroupNumber​
The specified SubgroupNumber {{subgroupNumber}} and PlacementGroup {{placementGroupId}} are mismatched.​
指定的放置子组与放置组不匹配。请根据参数说明,配置准确的参数值后重试。​
400​
InstanceTypeMismatch.HpcCluster​
The specified HpcCluster {{hpcClusterID}} and InstanceType {{instanceType}} are mismatched.​
指定的高性能集群与实例规格不匹配。请根据参数说明,配置准确的参数值后重试。​
400​
Mismatch.InstanceTypeIds​
The specified InstanceTypeIds are mismatched.​
节点池对应 ECS 实例规格不匹配,实例规格不允许跨 CPU、GPU 大类,或者跨不同 GPU 厂商。请根据参数说明,配置准确的参数值后重试。​
400​
DeploymentSetMismatch.InstanceType​
The specified InstanceType {{instanceType}} and DeploymentSet {{deploymentSetId}} are mismatched.​
指定的实例规格与部署集不匹配。请更新参数后重试。​
400​
ZoneMismatch.VolumeType​
The specified volume type {{volumeType}} and subnet zones are mismatched.​
指定的云盘类型与子网的可用区不匹配。请指定与子网可用区匹配的云盘后重试。​
400​
NetworkTrafficModeMismatch.InstanceType​
The specified InstanceType {{instanceType}} and NetworkTrafficMode {{networkTrafficMode}} are mismatched.​
指定的实例规格与网络通讯模式不匹配。请根据参数说明,配置准确的参数值后重试。​
400​
IpFamilyMismatch.PublicAccessEnabled​
The specified Config PublicAccessEnabled and cluster IpFamily {{ipFamily}} are mismatched.​
开启节点自动绑定 EIP 后和集群网络协议栈不匹配。请根据参数说明,配置准确的参数值后重试。​
400​
InstanceChargeTypeMismatch.SpotStrategy​
The specified SpotStrategy {{spotStrategy}} and InstanceChargeType {{instanceChargeType}} are mismatched.​
指定的抢占式策略和计费类型不匹配,包年包月节点池不支持抢占式策略。请重新指定参数后重试。​
400​
InstanceChargeTypeMismatch.AutoScalingEnabled​
The specified AutoScalingEnabled and InstanceChargeType {{instanceChargeType}} are mismatched.​
指定的弹性伸缩开关和计费类型不匹配,包年包月节点池不支持开启弹性伸缩。请重新指定参数后重试。​
400​
NotSupportScalingPolicy.NodePoolConfig​
The specified nodepool config does not support scaling policy.​
指定的节点池配置不支持伸缩规则。请重新指定参数后重试。​
400​
KubernetesVersionMismatch.RuntimeVersion​
The specified runtime version {{runtimeVersion}} and kubernetes version {{kubernetesVersion}} are mismatched.​
指定的容器运行时版本和集群 Kubernetes 版本不匹配。例如 containerd 2.1.x 版本仅支持在 Kubernetes v1.34 及以上版本集群中使用。请重新指定容器运行时版本后重试。更多信息,请参见 containerd 运行时发布记录。​
400​
LimitExceeded.ScriptLength​
The InitializeScript and PreScript total length exceeds maximum allowed length.​
前置脚本与后置脚本总长度超出限制。请根据参数说明,配置准确的参数值后重试。​
400​
PublicAccessConfigMismatch.BandwidthPackageId​
The specified BandwidthPackage {{bandwidthPackageId}} does not match the PublicAccessConfig.​
指定的共享带宽包与公网访问配置不匹配。请根据参数说明,配置准确的参数值后重试。​
400​
UnsupportedVolumeType.BurstEnabled​
The specified VolumeType {{volumeType}} does not support BurstEnabled.​
指定的云盘类型不支持性能突发。请更换云盘类型后重试。​
400​
UnsupportedInstanceChargeType.BurstEnabled​
The specified InstanceChargeType {{instanceChargeType}} does not support BurstEnabled.​
指定的实例计费类型不支持性能突发。请更换云盘的计费类型后重试。更多详情,请参见 突发性能计费 - ESSD FlexPL 云盘。​
​
​
最近更新时间:2026.09.30 16:34:41
这个页面对您有帮助吗?
有用
有用
无用
无用