参数名称 | 类型 | 必填 | 描述 |
---|
Action | String | 是 | 公共参数,本接口取值:CreateNodePool。 |
Version | String | 是 | 公共参数,本接口取值:2019-08-06。 |
NodePoolName | String | 是 | 节点池名称 |
ClusterId | String | 是 | 集群id |
EnableAutoScale | Boolean | 否 | 是否开启弹性伸缩,有效值: |
NodeTemplate | Object | 是 | 节点模板信息 |
ChargeType | String | 是 | 计费方式,有效值:
|
InstanceType | String | 是 | 实例类型,详情请见创建实例中InstanceType具体参数 |
SystemDisk | Object | 否 | 系统盘信息 |
DiskType | String | 否 | 系统盘类型 |
DiskSize | Int | 否 | 系统盘大小 |
DataDiskGb | Int | 否 | 本地数据盘大小 |
DataDisk.N | Object | 否 | 第n个数据盘(云盘) |
Type | String | 否 | 第n个数据盘(云盘)的类型,仅支持一块数据盘 |
Size | Int | 否 | 第n个数据盘(云盘)的容量大小,范围[1-32000] |
DeleteWithInstance | Boolean | 否 | 数据盘是否随实例删除,有效值:
|
ImageId | String | 是 | 镜像id |
VpcId | String | 是 | 节点池所在vpc的id |
SubnetId.N | String | 是 | 子网id |
SubnetStrategy | String | 否 | 多子网扩展策略,有效值:
|
SecurityGroupId | String | 是 | 安全组id |
ProjectId | String | 否 | 节点池所属项目 |
Password | String | 否 | 实例密码 |
AdvancedSetting | Object | 否 | 节点高级设置 |
DataDisk | Object | 否 | 数据盘挂载设置,仅针对于第一块数据盘生效 |
AutoFormatAndMount | Boolean | 否 | 是否对数据盘格式化并挂载,默认值;true。若此字段填写false,则 FileSystem 和 MountTarget字段不生效 |
FileSystem | String | 否 | 数据盘的文件系统,可选值:ext3,ext4,xfs,默认值ext4。若磁盘已有文件系统,则不进行处理,若没有文件系统,则按照用户的定义进行格式化,仅对第一块磁盘生效 |
MountTarget | String | 否 | 数据盘挂载点,并挂载,仅对第一块盘生效。 |
ContainerRuntime | String | 否 | 容器运行时,根据集群版本和需求选择
|
ContainerPath | String | 否 | 容器的存储路径,不填写的话默认为/data/container |
UserScript | String | 否 | base64 编码的用户脚本, 此脚本会在 节点上k8s 组件运行后执行, 需要用户保证脚本的可重入及重试逻辑,脚本和生成的日志的文件可在录/usr/local/ksyun/kce/userscript路径查看 |
PreUserScript | String | 否 | base64 编码的用户脚本, 此脚本会在节点上 k8s 组件运行前执行, 需要用户保证脚本的可重入及重试逻辑,脚本和生成的日志的文件可在录/usr/local/ksyun/kce/pre_userscript路径查看 |
Schedulable | Boolean | 否 | 节点加入集群后是否可以正常调度,默认值:true |
ExtraArg | Object | 否 | 自定义节点上k8s组件的参数 |
Kubelet.N | Object | 否 | 用户自定义kubelet的参数 |
CustomArg | String | 否 | 用户自定义kubelet的参数,格式k1=v1,如: --feature-gates=EphemeralContainers=true |
ContainerLogMaxSize | Int | 否 | 自定义容器日志采集文件大小,超出此大小日志将滚动写入下一文件,默认值为100m |
ContainerLogMaxFiles | Int | 否 | 自定义容器日志采集文件最大数量,默认值为10个 |
EbsTag.N | Object | 否 | 云盘标签,N取值范围[1-10] |
Key | String | 否 | 标签键,校验规则:支持1-128个字符,仅支持中英文字符、数字及±=._/@: |
Value | String | 否 | 标签值,校验规则:256个字符内,仅支持中英文字符、数字及±=._/@()()【】: |
InstanceTag.N | Object | 否 | 实例标签,N取值范围[1-10] |
Key | String | 否 | 标签键,校验规则:支持1-128个字符,仅支持中英文字符、数字及±=._/@: |
Value | String | 否 | 标签值,校验规则:256个字符内,仅支持中英文字符、数字及±=._/@()()【】: |
Cpu | String | 否 | Cpu核数 |
Mem | String | 否 | 内存 |
KeyId.N | String | 否 | 密钥ID |
InstanceName | String | 否 | 实例名称 |
InstanceNameSuffix | Int | 否 | 实例名称后缀 |
DeleteDataDisk | Boolean | 否 | 是否删除数据盘 |
DeleteInstanceTag | Boolean | 否 | 是否删除实例tag |
DeleteEbsTag | Boolean | 否 | 是否删除EbsTag |
Label.N | Object | 否 | 节点标签 |
Key | String | 否 | 标签键,校验规则:不超过63个字符,只能包含字母、数字及分隔符("-"、"_"、"."、"/"),且必须以字母、数字开头和结尾 |
Value | String | 否 | 标签值,校验规则:不超过63个字符,只能包含字母、数字及分隔符("-"、"_"、"."),且必须以字母、数字开头和结尾 |
Taint.N | Object | 否 | 节点污点 |
Key | String | 否 | 污点键,校验规则:污点名不超过253个字符,只能包含字母、数字及分隔符("-"、"_"、"."、"/"),且必须以字母、数字开头和结尾 |
Value | String | 否 | 污点值,校验规则:不超过63个字符,只能包含字母、数字及分隔符("-"、"_"、"."),且必须以字母、数字开头和结尾 |
Effect | String | 否 | 有效值:NoSchedule、PreferNoSchedule、NoExecute |
MinSize | Int | 是 | 最小节点数量,即为最小能缩容的实例数量,范围[0-50],不大于maxSize |
MaxSize | Int | 是 | 最大节点数量,即为最大能扩容的实例数量,范围[0-50],不小于minSize |
DesiredCapacity | Int | 是 | 期望节点数量,即节点池刚创建时的实例数量,必须在最小节点数量与最大节点数量之间 |
EnableDelProtection | Boolean | 否 | 开启删除保护 默认值:true |
参数名称 | 类型 | 描述 |
---|
RequestId | String | 请求ID 示例值:bb2fd0a6-d009-b5f6-8c35-0f9b6cb8713e |
NodePoolId | String | 节点池id 示例值:573e7229-f7ef-a23a-2d44-d8a55923059d |
JSON格式
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码
错误码 | 错误信息 | Http状态码 | 描述 |
---|
ClusterIdRequired | ClusterId is required | 400 | 集群ID必须填写 |
NodePoolNameRequired | NodePoolName is Required | 400 | 节点池名称必须填写 |
NodeTemplateRequired | NodeTemplate is required | 400 | 节点池模板必须填写 |
ClusterNotFound | cluster xx is not found | 400 | 集群不存在 |
GetClusterError | failed to get cluster | 400 | 获取集群信息失败 |
ContainerRuntimeInvalid | docker is unsupported when k8s version > 1.24 | 400 | 当集群版本大于1.24时不支持docker运行时 |
ChargeTypeInvalid | when enable auto scale, only supports Daily or HourlyInstantSettlement | 400 | 节点池开启弹性伸缩时计费方式只支持Daily、HourlyInstantSettlement |
MaxSizeInvalid | MaxSize can't be less than MinSize | 400 | 节点池最大实例数量不能小于最小实例数量 |
DesiredCapacityInvalid | the value of DesiredCapacity can't be less than MinSize, and can't be greater than MaxSize | 400 | 期望实例数量不能小于实例最小范围,不能大于实例最大范围 |
ClusterNodeQuotaExceed | the sum of existed node and desiredCapacity exceeds quota_kce_node | 400 | 集群已有节点与期望实例数量总和超过quota限额 |
KecSecurityGroupExceed | the number of securityGroup exceeds quota_kec_secgroup | 400 | 安全组数量超过了主机安全组quota限额 |
SubnetIdRequired | SubnetId is required | 400 | 子网必须填写 |
SubnetIdInvalid | SubnetId contains repeat value | 400 | 子网ID列表包含重复值 |
UserScriptLengthExceed | the length of UserScript can't exceed 16*1024 | 400 | 用户脚本长度不能超过16*1024个字符 |
PreUserScriptLengthExceed | the length of PreUserScript can't exceed 16*1024 | 400 | 用户前置脚本字符长度不能超过16*1024 |
FileSystemInvalid | FileSystem is invalid | 400 | 文件系统无效,仅支持ext3、ext4、xfs |
LabelKeyInvalid | label value must match(^[a-z0-9A-Z]([-_.a-zA-Z0-9]){0,61}[a-z0-9A-Z]$)|([a-zA-Z0-9])? | 400 | 标签值格式必须满足 (^[a-z0-9A-Z]([-_.a-zA-Z0-9]){0,61}[a-z0-9A-Z]$)|([a-zA-Z0-9])? |
LabelValueInvalid | label value must match(^[a-z0-9A-Z]([-_.a-zA-Z0-9]){0,61}[a-z0-9A-Z]$)|([a-zA-Z0-9])? | 400 | 标签值格式必须满足 (^[a-z0-9A-Z]([-_.a-zA-Z0-9]){0,61}[a-z0-9A-Z]$)|([a-zA-Z0-9])? |
TaintInvalid | taint key must match ((^[A-Za-z0-9]([-_./A-Za-z0-9]){0,251}[A-Za-z0-9]$)|^[A-Za-z0-9]$) | 400 | 污点key格式必须满足 ((^[A-Za-z0-9]([-_./A-Za-z0-9]){0,251}[A-Za-z0-9]$)|^[A-Za-z0-9]$) |
InstanceNotFound | instance is not found | 400 | 实例不存在 |
KeyIdInvalid | KeyId contains repeat value | 400 | KeyId包含重复值 |
PasswordOrKeyIdRequired | Password and KeyId can't be empty at the same time | 400 | 密码与密钥不能同时为空 |
InstanceTypeInvalid | instanceType xx sellout | 400 | 机型套餐已售罄 |
SystemDiskTypeInvalid | system disk type xx sellout | 400 | 系统盘已售罄 |
DataDiskTypeInvalid | data disk type xx sellout | 400 | 数据盘已售罄 |
SubnetStrategyInvalid | the value only supports balanced-distribution,choice-first | 400 | 子网策略仅支持balanced-distribution,choice-first |
EbsTagInvalid | EbsTag key and value must be a pair | 400 | ebs标签键与值必须成对 |
InstanceTagInvalid | InstanceTag key and value must be a pair | 400 | 主机实例标签键与值必须成对 |
纯净模式