AddClusterInstances
最近更新时间: 2025-10-20 17:05:58
1. 接口描述
接口请求域名： tke.api3.fincloud.tencent.cn。
扩展集群节点，API 3.0
默认接口请求频率限制：20次/秒。
接口更新时间：2021-04-09 10:59:35。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：AddClusterInstances |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-05-25 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| ClusterId | 是 | 否 | String | 集群 ID，请填写 查询集群列表 接口中返回的 clusterId 字段 |
| MountTarget | 否 | 否 | Array of String | 数据盘挂载点, 默认不挂载数据盘. 已格式化的 ext3，ext4，xfs 文件系统的数据盘将直接挂载，其他文件系统或未格式化的数据盘将自动格式化为ext4 并挂载，请注意备份数据! 无数据盘或有多块数据盘的云主机此设置不生效。 |
| DockerGraphPath | 否 | 否 | Array of String | dockerd --graph 指定值, 默认为 /var/lib/docker |
| UserScript | 否 | 否 | Array of String | base64 编码的用户脚本, 此脚本会在 k8s 组件运行后执行, 需要用户保证脚本的可重入及重试逻辑, 脚本及其生成的日志文件可在节点的 /data/ccs_userscript/ 路径查看, 如果要求节点需要在进行初始化完成后才可加入调度, 可配合 unschedulable 参数使用, 在 userScript 最后初始化完成后, 添加 kubectl uncordon nodename --kubeconfig=/root/.kube/config 命令使节点加入调度 |
| OsName | 否 | 否 | String | 系统名。centos7.2x86_64 或者 ubuntu16.04.1 LTSx86_64，仅当新建集群为空集群, 第一次向空集群添加节点时需要指定. 当集群系统确定后, 后续添加的节点都是集群系统 |
| Unschedulable | 否 | 否 | Int64 | 设置加入的节点是否参与调度，默认值为0，表示参与调度；非0表示不参与调度, 待节点初始化完成之后, 可执行kubectl uncordon nodename使node加入调度. |
| CvmRunInstances | 是 | 否 | String | cvm创建透传参数，json化字符串格式 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| InstanceIdSet | String | 节点实例id |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError.CreateMasterFailed | 创建集群失败。 |
| InternalError.Db | db错误。 |
| InternalError.AccountUserNotAuthenticated | 账户未通过认证。 |
| InternalError.PublicClusterOpNotSupport | 集群不支持当前操作。 |