全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

修改节点池模板

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数
参数名称
类型
必填
描述
Action String
公共参数,本接口取值:ModifyNodeTemplate。
Version String
公共参数,本接口取值:2019-08-06。
ClusterId String

集群id

NodePoolId String

节点池id

NodeTemplate Object

节点模板信息
注:不可修改计费方式、节点池所在vpc

ChargeType String

计费方式,有效值:

  • Daily:按量付费(按日月结)
  • HourlyInstantSettlement:按量付费
    注:当参数EnableAutoScale设置为False时,计费方式可选Daily、HourlyInstantSettlement;当参数EnableAutoScale设置为True时,计费方式可选HourlyInstantSettlement
InstanceType String

实例类型,详情请见创建实例中InstanceType具体参数

InstanceName String

实例名称
注:若不指定该参数,名称则为:AS-节点池名称-Worker

InstanceNameSuffix Int

实例名称后缀

SystemDisk Object

系统盘信息
注:若不指定该参数,则按照系统默认值进行分配

DiskType String

系统盘类型

DiskSize Int

系统盘大小

DataDiskGb Int

本地数据盘大小

DataDisk.N Object
Type String

第n个数据盘(云盘)的类型,仅支持一块数据盘

Size Int

第n个数据盘(云盘)的容量大小,范围[1-32000]

DeleteWithInstance Boolean

数据盘是否随实例删除,有效值:

  • True:是
  • False:否
    默认值:False
ImageId String

镜像id

VpcId String

节点池所在vpc的id

SubnetId.N String

子网id

SubnetStrategy String

多子网扩展策略,有效值:

  • balanced-distribution:均衡分布
  • choice-first:选择优先
    默认值:balanced-distribution
    注:当绑定多个子网时,该项必填
SecurityGroupId String

安全组id

ProjectId String

节点池所属项目

Password String

实例密码
校验规则:8-32个字符,必须包含大小写字母和数字,支持英文特殊字符!$%()*+,-./:;<=>?@[]^_`{

KeyId.N String

密钥id
校验规则:请填写有效的keyId,若填写此参数,则Password参数无效
注:参数KeyId.N和Password必须填写一个

AdvancedSetting Object

节点高级设置

DataDisk Object

数据盘挂载设置,仅针对于第一块数据盘生效

AutoFormatAndMount Boolean

是否对数据盘格式化并挂载,默认值;true。若此字段填写false,则 FileSystem 和 MountTarget字段不生效

FileSystem String

数据盘的文件系统,可选值:ext3,ext4,xfs,默认值ext4。若磁盘已有文件系统,则不进行处理,若没有文件系统,则按照用户的定义进行格式化,仅对第一块磁盘生效

MountTarget String

数据盘挂载点,并挂载,仅对第一块盘生效。

ContainerRuntime String

容器运行时,根据集群版本和需求选择
Kubernetes版本<1.24时,有效值:

  • docker
  • containerd
    Kubernetes版本≥1.24时,有效值:
  • contained
    默认值:docker
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

Label.N Object

节点加入集群时预置的标签

Key String

标签键,校验规则:不超过63个字符,只能包含字母、数字及分隔符("-"、"_"、"."、"/"),且必须以字母、数字开头和结尾

Value String

标签值,校验规则:不超过63个字符,只能包含字母、数字及分隔符("-"、"_"、"."),且必须以字母、数字开头和结尾

ExtraArg Object

自定义节点上k8s组件的参数

Kubelet.N Object

用户自定义kubelet的参数

CustomArg String

用户自定义kubelet的参数,格式k1=v1,如: --feature-gates=EphemeralContainers=true

ContainerLogMaxSize Int

自定义容器日志采集文件大小,超出此大小日志将滚动写入下一文件,默认值为100m

ContainerLogMaxFiles Int

自定义容器日志采集文件最大数量,默认值为10个

Taints.N Object

节点加入集群时预置污点,匹配污点容忍进行调度

Key String

污点名称,校验规则:不超过253个字符,只能包含字母、数字及分隔符("-"、"_"、"."、"/"),且必须以字母、数字开头和结尾

Value String

污点值,校验规则:不超过63个字符,只能包含字母、数字及分隔符("-"、"_"、"."、"/"),且必须以字母、数字开头和结尾

Effect String

污点效果,有效值为NoSchedule、PreferNoSchedule、NoExecute

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个字符内,仅支持中英文字符、数字及±=._/@()()【】:

DeleteDataDisk Boolean

是否删除数据盘

DeleteInstanceTag Boolean

是否删除实例tag

DeleteEbsTag Boolean

是否删除EbsTag

Cpu String

CPU核数

Mem String

内存大小

返回参数

参数名称
类型
描述
RequestId String

请求id

示例值:7a62c49f-347e-4fc4-9331-6e8e

请求示例

curl -X GET|POST
'http://kce.api.ksyun.com/?Action=ModifyNodeTemplate&Version=2019-08-06'
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx'
-H 'cache-control: no-cache'
-H 'content-type: application/x-www-form-urlencoded'
-H 'host: kce.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'
-d 'ClusterId=xxx&NodePoolId=xxx&NodeTemplate.ChargeType=xxx&NodeTemplate.InstanceType=xxx&NodeTemplate.InstanceName=xxx&NodeTemplate.InstanceNameSuffix=xxx&NodeTemplate.SystemDisk.DiskType=xxx&NodeTemplate.SystemDisk.DiskSize=xxx&NodeTemplate.DataDiskGb=xxx&NodeTemplate.DataDisk.N.Type=xxx&NodeTemplate.DataDisk.N.Size=xxx&NodeTemplate.DataDisk.N.DeleteWithInstance=xxx&NodeTemplate.ImageId=xxx&NodeTemplate.VpcId=xxx&NodeTemplate.SubnetId.N=xxx&NodeTemplate.SubnetStrategy=xxx&NodeTemplate.SecurityGroupId=xxx&NodeTemplate.ProjectId=xxx&NodeTemplate.Password=xxx&NodeTemplate.KeyId.N=xxx&NodeTemplate.AdvancedSetting.DataDisk.AutoFormatAndMount=xxx&NodeTemplate.AdvancedSetting.DataDisk.FileSystem=xxx&NodeTemplate.AdvancedSetting.DataDisk.MountTarget=xxx&NodeTemplate.AdvancedSetting.ContainerRuntime=xxx&NodeTemplate.AdvancedSetting.ContainerPath=xxx&NodeTemplate.AdvancedSetting.UserScript=xxx&NodeTemplate.AdvancedSetting.PreUserScript=xxx&NodeTemplate.AdvancedSetting.Schedulable=xxx&NodeTemplate.AdvancedSetting.Label.N.Key=xxx&NodeTemplate.AdvancedSetting.Label.N.Value=xxx&NodeTemplate.AdvancedSetting.ExtraArg.Kubelet.N.CustomArg=xxx&NodeTemplate.AdvancedSetting.ContainerLogMaxSize=xxx&NodeTemplate.AdvancedSetting.ContainerLogMaxFiles=xxx&NodeTemplate.AdvancedSetting.Taints.N.Key=xxx&NodeTemplate.AdvancedSetting.Taints.N.Value=xxx&NodeTemplate.AdvancedSetting.Taints.N.Effect=xxx&NodeTemplate.EbsTag.N.Key=xxx&NodeTemplate.EbsTag.N.Value=xxx&NodeTemplate.InstanceTag.N.Key=xxx&NodeTemplate.InstanceTag.N.Value=xxx&NodeTemplate.DeleteDataDisk=xxx&NodeTemplate.DeleteInstanceTag=xxx&NodeTemplate.DeleteEbsTag=xxx&NodeTemplate.Cpu=xxx&NodeTemplate.Mem=xxx'

返回示例

JSON格式

{
"RequestId":"7a62c49f-347e-4fc4-9331-6e8e"
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码
错误信息
Http状态码
描述
ClusterIdRequiredClusterId is required400集群ID必须填写
ClusterIdInvalidClusterId must match `^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$`400集群ID必须满足 `^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$`
NodePoolIdRequiredNodePoolId is required400节点池ID必须填写
SubnetIdInvalidSubnetId contains repeat value400子网ID列表包含重复值
NodePoolNotFoundnode pool is not found400节点池不存在
ClusterNotFoundcluster xx is not found400集群不存在
GetClusterErrorfailed to get cluster400获取集群信息失败
ContainerRuntimeInvaliddocker is unsupported when k8s version > 1.24400当集群版本大于1.24时不支持docker运行时
NodeTemplateModifyFailedvpc can't be changed400修改失败,VPC不可变更
KecSecurityGroupExceedthe number of securityGroup exceeds quota_kec_secgroup400安全组数量超过了主机安全组quota限额
NodePoolConfigurationNotFoundscaling configuration is not found in kec400伸缩配置信息不存在
SubnetNotFoundsubnets must in vpc xx400子网必须属于VPC
InstanceTypeInvalidinstanceType is unavailable400机型套餐在指定可用区无效
DataDiskParseErrorget data disk error400获取数据盘信息错误
InstanceTypeSelloutinstanceType xx sellout400机型套餐已售罄
EbsSelloutebs type sellout400数据盘类型已售罄
UserScriptLengthExceedthe length of UserScript can't exceed 16*1024400用户脚本长度不能超过16*1024个字符
PreUserScriptLengthExceedthe length of PreUserScript can't exceed 16*1024400用户前置脚本字符长度不能超过16*1024
FileSystemInvalidFileSystem is invalid400文件系统无效,仅支持ext3、ext4、xfs
LabelKeyInvalidlabel 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])?
LabelValueInvalidlabel 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])?
TaintInvalidtaint 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]$)
EbsTagInvalidEbsTag key and value must be a pair400ebs标签键与值必须成对
InstanceTagInvalidInstanceTag key and value must be a pair400主机实例标签键与值必须成对
纯净模式常规模式

纯净模式

点击可全屏预览文档内容