请求数据结构

Labels

Array of Label

否

-

节点池/节点的 Kubernetes 标签（Labels）信息。最多可传入 20 个标签。

Taints

Array of Taint

否

-

节点池/节点的 Kubernetes 污点（Taints）信息。最多可传入 20 个污点。

Cordon

Boolean

否

false

封锁节点配置，取值：

• false：（默认值）不封锁
• true：封锁

NamePrefix

String

否

name-prefix

Kubernetes 中节点对象的元数据名称前缀。默认不启用，若设置表示启用，并将影响 Kubernetes Node Manifest 文件中展示的metadata.name前缀信息。前缀校验规则如下：

• 支持英文小写字母、数字、中划线(-)和半角句号(.)。
• 只能以英文小写字母或者数字开头。
• 长度限制为 1~48 个字符。

Enabled

Boolean

否

false

配置节点池弹性伸缩功能开关，取值：

• false：（默认值）关闭。
• true：开启。

MaxReplicas

Integer

否

10

配置节点池的最大节点数，取值说明：

• 默认值：10
• 取值范围：1~2000

MinReplicas

Integer

否

0

配置节点池的最小节点数，取值说明：

• 默认值：0
• 最小值：0
• 最大值：小于 MaxReplicas 参数的值

DesiredReplicas

Integer

否

0

配置节点池的期望节点数，取值说明：

• 默认值：0
• 取值范围：0~2000

Priority

Integer

否

10

优先级，取值说明：

• 默认值：10
• 取值范围：0~100

SubnetPolicy

String

否

ZoneBalance

节点池的多子网调度策略，用于在 Worker 节点扩容时按照子网优先级顺序进行调度。取值：

• ZoneBalance：（默认值）可用区均衡策略，节点扩容时，新增的节点会分散到多个可用区的子网下，且保证各个可用区中的节点数相对均衡。
• Priority：子网优先级策略，按照子网列表的先后顺序调度。如果优先级最高的子网可以创建成功，则总在该子网下新增节点。

Password

String

否

UHdkMTIz****

Root 用户登录密码，使用 Base64 编码格式。
请遵循云服务器对于实例密码的要求规范：

• 长度为 8～30 个字符
• 不能以/和$6$开头
• 支持以下几项字符，且至少包含三项
  • 小写字母a~z
  • 大写字母A~Z
  • 数字0~9
  • 特殊字符( ) ` ~ ! @ # $ % ^ & * _ - + = | { } [ ] : ; ' < > , . ? /

SshKeyPairName

String

否

test-key

SSH 密钥对名称。
请确保该密钥对已在云服务器中创建或托管。

Type

String

否

ESSD_PL0

云盘类型：

• ESSD_PL0：（默认值）性能级别为 PL0 的极速型 SSD 云盘。
• ESSD_FlexPL：性能级别为 PL1 的极速型 SSD 云盘。
• Ultra_Disk：高效型云盘。
• PTSSD：性能型 SSD 云盘（即将下线该类型云盘，当前仅华北 2（北京）cn-beijing地域支持）。

Size

Integer

否

40

云盘容量，单位 GiB，取值说明：

• 默认值：40
• 性能型 SSD（PTSSD）：40～500
• 极速型 SSD（ESSD_PL0，ESSD_FlexPL）、高效型云盘（Ultra_Disk）：40～2048

Type

String

否

ESSD_PL0

磁盘类型：

• ESSD_PL0：（默认值）性能级别为 PL0 的极速型 SSD 云盘。
• ESSD_FlexPL：性能级别为 PL1 的极速型 SSD 云盘。
• Ultra_Disk：高效型云盘。
• PTSSD：性能型 SSD 云盘（即将下线该类型云盘，当前仅华北 2（北京）cn-beijing地域支持）。

Size

Integer

否

20

磁盘容量，单位 GiB，数据云盘数值范围：

• 默认值：20
• 性能型 SSD（PTSSD）：20～8192
• 极速型 SSD（ESSD_PL0，ESSD_FlexPL）：20～32768
• 高效型云盘（Ultra_Disk）：20～32768

MountPoint

String

否

/vke

磁盘格式化后的目标挂载目录，取值要求如下：

• 必须以/开头。
• 长度限制为 1～255 个字符。
• 不同数据盘的挂载目录不允许重复。

Key

String

是

lable-key/os

标签键，要求如下，更多规则，请参见 Kubernetes 标签规则。
有效的标签键有两个段：<前缀>和<名称>，用斜杠（/）分隔。

• <名称>是必须的，支持英文大小写字母、数字、短划线（-）、下划线（_）、英文句号（ .），以字母或数字开头和结尾，长度不超过 63 个字符。
• <前缀>是可选的。如果指定<前缀>，则必须是 DNS 子域：由英文句号（.）分隔的一系列 DNS 标签，长度不超过 253 个字符。
• <前缀>和<名称>总长度不超过 82 个字符。

Value

String

否

linux

标签值，要求如下，更多规则，请参见 Kubernetes 标签规则。

• 长度不超过 63 个字符（可以为空）。
• 支持以英文大小写字母、数字开头和结尾。
• 支持特殊字符：短划线（-）、下划线（_）、英文句号（.）。

Effect

String

否

NoSchedule

污点效果，取值：

• NoSchedule：（默认值）不调度。
• NoExecute：驱逐没有容忍污点的 Pod。
• PreferNoSchedule：尽量避免调度。

Key

String

是

taint-key/node-type

污点键，要求如下，更多规则，请参见 Kubernetes 标签规则。
有效的污点键有两个段：<前缀>和<名称>，用斜杠（/）分隔。

• <名称>是必须的，支持英文大小写字母、数字、短划线（-）、下划线（_）、英文句号（ .），以字母或数字开头和结尾，长度不超过 63 个字符。
• <前缀>是可选的。如果指定<前缀>，则必须是 DNS 子域：由英文句号（.）分隔的一系列 DNS 标签，长度不超过 253 个字符。
• <前缀>和<名称>总长度不超过 82 个字符。

Value

String

否

vci

污点值，要求如下，更多规则，请参见 Kubernetes 标签规则。

• 长度不超过 63 个字符（可以为空）。
• 支持以英文大小写字母、数字开头和结尾。
• 支持特殊字符：短划线（-）、下划线（_）、英文句号（.）。

Key

String

是

key

标签键。

• 不能以任何大小写形式的volc:开头。
• 只能包含语言字符、数字、空格和特殊符号_.:/=+-@。
• 长度限制为 1～128 个字符。

Value

String

否

value

标签值，可以为空。

• 只能包含语言字符、数字、空格和特殊符号_.:/=+-@。
• 长度不超过 256 个字符。

LogSetups

Array of
LogSetupRequest

否

-

集群的日志选项信息。

• 空数组代表不开启任何日志。
• 首次开启日志时，日志主题（Log Topic）自动生成。
• 多个日志选项时，LogType 不允许重复。

LogProjectId

String

否

b68324a0-2680-48c7-a42e-8d78********

集群的日志项目（Log Project）ID。

LogType

String

是

Audit

当前开启的日志类型，取值：

• Audit：集群审计日志
• KubeApiServer：kube-apiserver 组件日志
• KubeScheduler：kube-scheduler 组件日志
• KubeControllerManager：kube-controller-manager 组件日志

LogTtl

Integer

否

30

日志在日志服务中的保存时间，超过指定的日志存储时长后，此日志主题中的过期日志会被自动清除。

• 取值范围：1～3650
• 单位：天
• 默认值：30 天
  指定为 3650 天表示永久存储。

Enabled

Boolean

否

false

是否开启该日志选项，取值：

• false：（默认值）不开启
• true：开启