全部文档
当前文档

暂无内容

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

文档中心

添加Epc节点

请求参数

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

集群id

NodeInstanceSet Object[]

节点信息

Provider String

实例类型
• EPC 裸金属服务器

示例值:EPC
Components Object[]

组件配置

Type String

核心组件的类型
• APISERVER
• ETCD
• CONTROLLERMANAGER
• EVENTETCD
• SCHEDULER

示例值:APISERVER
BasicSetting Object

节点通用配置

IsNew Boolean

是否为新建节点
true为新建节点
false为已有节点

示例值:false
默认值:false
AvailabilityZone String

可用区信息,示例:cn-beijing-6a(新建必填)

示例值:cn-beijing-6a
ExistedInstances String[]

如果是已有节点,填写已有实例的id
epc已有实例要求:

  1. 跟集群在同一个vpc下
  2. 云主机处于关机状态
  3. 未加入其他集群
Num Int

添加节点的数量(新建节点时必填)

InstanceType String

epc的实例类型 ,示例:CAL-III
具体值参照裸金属文档:https://apiexplorer.ksyun.com/#/document/documentDetail/44/CreateEpc/2015-11-01/1003(新建节点时必填)

ImageID String

镜像id

SystemDisk Object

系统盘信息(新建节点必填)

Type String

系统盘类型
具体值参考云主机文档:https://docs.ksyun.com/documents/1528?type=6

Size String

系统盘大小,单位:G
具体值参考云主机文档:https://docs.ksyun.com/documents/1528?type=6

InstanceName String

实例名称(新建节点必填)
有效值:有效值:2-64个字符,支持中文,英文,数字,以及特殊字符-_

SubnetID String

实例的子网id(新建节点必填),子网id必须为集群vpc下的

NodeNameMode String

节点命名方式
• INTERNAL_IP 以实例ip作为节点名称
• HOST_NAME 以实例hostName作为节点名称

示例值:INTERNAL_IP
DataDisk Object[]

数据盘信息

FileSystem String

epc数据盘类型
• EXT4
• XFS

示例值:EXT4
MountTarget String

epc数据盘目录
• /DATA/disk 在系统的DATA目录下,系统里展示内容如/DATA/disk1,/DATA/disk2
• /data 在系统的根目录下,系统里展示内容从/data1开始,如/data1,/data2
• /ssd

Suffix String

数据盘目录后缀属性
• NoSuffix 不使用后缀
• NaturalNumber:后缀从1底层的整数
• NaturalNumberFromZero:后缀从0递增的整数

LoginSetting Object

节点登录信息(云主机节点为必填字段)
(查询时,该字段为敏感信息,不返回)

Password String

登录密码(明文)跟秘钥二选一
有效值:8-32个字符,必须包含大小写字母和数字

SSHKeyId String

实例登录秘钥Id信息 跟密码二选一

Series String

Epc的类型
• GPU gpu类型
• CAL 计算型

示例值:CAL
ReInstall Boolean

是否重装系统(已有节点时该字段才生效)

SecurityGroupID String

安全组Id,为集群所选vpc下的安全组id(如果为空,则会创建一个新的安全组id)

Raid String

数据盘Raid级别,和数据盘的数量直接相关(新建节点必填)
有效值: Raid1、Raid5、Raid10、Raid50、SRaid0

NetworkInterfaceMode String

网卡模式(新建节点必填)
有效值:
bond4:BOND模式
single:非BOND模式
dual:双网卡模式

BondName String

bond名称
有效值:
• bond0(默认值)
• bond1

示例值:bond0
默认值:bond0
GpuImageDriverId String

gpu的驱动id (为gpu类型才生效)
命名方式为cuda版本+“_” + GPU驱动,示例:12.0_525.105.17
可参考裸金属文档:https://apiexplorer.ksyun.com/#/api/44/DescribeGpuImageDriver/2015-11-01/1003

ChargeType String

计费方式(新建节点时必填)
• monthly 包年包月
• dailysettlement 按量付费(按日月结)

Unit Int

购买时长单位(计费方式为包年包月时必填)
• 2 单位月

PurchaseTime Int

购买时长,当计费方式为包年包月时必填,单位为月
有效值1-36
其他计费类型可不填,若填只能为0

AdvancedSetting Object

k8s节点配置

PostUserScript String

部署前执行脚本(base64编码)

PreUserScript String

部署后执行脚本(base64编码)

Container Object

容器相关信息

Runtime String

容器运行时名称:
• Containerd(默认)

示例值:Containerd
默认值:Containerd
Path String

容器存储目录,默认值为:/data/container

LogMaxSize Int

容器单个日志文件大小 单位:Mi,默认值为100

LogMaxFiles Int

日志文件数量大小,默认值为10

示例值:10
默认值:10
Labels Object[]

标签信息

Key String

key信息

Value String

value信息

Taint Object

污点信息

Key String

key信息

Value String

value信息

Effect String

effect 信息:PreferNoSchedule,NoSchedule,NoExecute

返回参数

参数名称
类型
描述
Data Object
RequestId String
InstanceSet Object[]
KceNodeId String
示例值:3ebe6766-0532-4ade-bc13-0664cd11aa37
Code Int
示例值:200

请求示例

curl -X POST
'http://kce2.api.ksyun.com/?Action=AddEpcNodes&Version=2023-01-01'
-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: kce2.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'
-d 'ClusterId=xxx&NodeInstanceSet[0].Provider=xxx&NodeInstanceSet[0].Components[0].Type=xxx&NodeInstanceSet[0].BasicSetting.IsNew=false&NodeInstanceSet[0].BasicSetting.AvailabilityZone=xxx&NodeInstanceSet[0].BasicSetting.ExistedInstances[0]=xxx&NodeInstanceSet[0].BasicSetting.Num=xxx&NodeInstanceSet[0].BasicSetting.InstanceType=xxx&NodeInstanceSet[0].BasicSetting.ImageID=xxx&NodeInstanceSet[0].BasicSetting.SystemDisk.Type=xxx&NodeInstanceSet[0].BasicSetting.SystemDisk.Size=xxx&NodeInstanceSet[0].BasicSetting.InstanceName=xxx&NodeInstanceSet[0].BasicSetting.SubnetID=xxx&NodeInstanceSet[0].BasicSetting.NodeNameMode=xxx&NodeInstanceSet[0].BasicSetting.DataDisk[0].FileSystem=xxx&NodeInstanceSet[0].BasicSetting.DataDisk[0].MountTarget=xxx&NodeInstanceSet[0].BasicSetting.DataDisk[0].Suffix=xxx&NodeInstanceSet[0].BasicSetting.LoginSetting.Password=xxx&NodeInstanceSet[0].BasicSetting.LoginSetting.SSHKeyId=xxx&NodeInstanceSet[0].BasicSetting.Series=xxx&NodeInstanceSet[0].BasicSetting.ReInstall=xxx&NodeInstanceSet[0].BasicSetting.SecurityGroupID=xxx&NodeInstanceSet[0].BasicSetting.Raid=xxx&NodeInstanceSet[0].BasicSetting.NetworkInterfaceMode=xxx&NodeInstanceSet[0].BasicSetting.BondName=bond0&NodeInstanceSet[0].BasicSetting.GpuImageDriverId=xxx&NodeInstanceSet[0].BasicSetting.ChargeType=xxx&NodeInstanceSet[0].BasicSetting.Unit=xxx&NodeInstanceSet[0].BasicSetting.PurchaseTime=xxx&NodeInstanceSet[0].AdvancedSetting.PostUserScript=xxx&NodeInstanceSet[0].AdvancedSetting.PreUserScript=xxx&NodeInstanceSet[0].AdvancedSetting.Container.Runtime=Containerd&NodeInstanceSet[0].AdvancedSetting.Container.Path=xxx&NodeInstanceSet[0].AdvancedSetting.Container.LogMaxSize=xxx&NodeInstanceSet[0].AdvancedSetting.Container.LogMaxFiles=10&NodeInstanceSet[0].AdvancedSetting.Labels[0].Key=xxx&NodeInstanceSet[0].AdvancedSetting.Labels[0].Value=xxx&NodeInstanceSet[0].AdvancedSetting.Taint.Key=xxx&NodeInstanceSet[0].AdvancedSetting.Taint.Value=xxx&NodeInstanceSet[0].AdvancedSetting.Taint.Effect=xxx'

返回示例

JSON格式

{
"Data":{
"RequestId":"",
"InstanceSet":[
{
"KceNodeId":"3ebe6766-0532-4ade-bc13-0664cd11aa37",
"Code":200
},
{
"KceNodeId":"4ba7d5ec-def1-4a46-8bb5-98a3ea54bbbd",
"Code":200
},
{
"KceNodeId":"b543cc2c-d745-40ab-a04f-981a8cfc8540",
"Code":200
}
]
}
}

错误码

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

纯净模式常规模式

纯净模式

点击可全屏预览文档内容