CreateCluster
最近更新时间: 2025-10-20 17:05:58
1. 接口描述
接口请求域名： tke.api3.fincloud.tencent.cn。
创建集群
默认接口请求频率限制：20次/秒。
接口更新时间：2020-09-03 19:31:05。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：CreateCluster |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-05-25 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| RunInstancesForNode | 否 | 否 | Array of RunInstancesForNode | CVM创建透传参数，json化字符串格式，详见RunInstances接口。总机型(包括地域)数量不超过10个，相同机型(地域)购买多台机器可以通过设置参数中RunInstances中InstanceCount来实现。 |
| ClusterCIDRSettings | 是 | 否 | ClusterCIDRSettings | 集群容器网络配置信息 |
| ClusterBasicSettings | 否 | 否 | ClusterBasicSettings | 集群的基本配置信息 |
| ClusterAdvancedSettings | 否 | 否 | ClusterAdvancedSettings | 集群高级配置信息 |
| InstanceAdvancedSettings | 否 | 否 | InstanceAdvancedSettings | 节点高级配置信息 |
| ClusterType | 是 | 否 | String | 集群类型，托管集群：MANAGED_CLUSTER，独立集群：INDEPENDENT_CLUSTER。 |
| ExistedInstancesForNode | 否 | 否 | Array of ExistedInstancesForNode | 已存在实例的配置信息。所有实例必须在同一个VPC中，最大数量不超过100。 |
| InstanceDataDiskMountSettings | 否 | 否 | Array of InstanceDataDiskMountSetting | CVM类型和其对应的数据盘挂载配置信息 |
| ClusterArch | 否 | 否 | String | 集群的cpu架构，取值: x86/arm |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| ClusterId | String | 集群ID |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError.DfwGetUSGCount | 获得当前安全组总数失败。 |
| InternalError.InitMasterFailed | 初始化master失败。 |
| InternalError.QuotaMaxClsLimit | 超过配额限制。 |
| InternalError.CidrInvali | CIDR无效。 |
| InternalError.AsCommon | 伸缩组资源创建报错。 |
| InternalError.Db | db错误。 |
| InternalError.UnexceptedInternal | 内部错误 |
| InvalidParameter | 参数错误 |
| InternalError.CidrConflictWithVpcGlobalRoute | CIDR和全局路由冲突。 |
| InternalError.InvalidPrivateNetworkCidr | 无效CIDR。 |
| InternalError.CidrConflictWithOtherRoute | CIDR和其他路由冲突。 |
| InternalError.QuotaMaxNodLimit | 超过配额限制。 |
| InternalError.VpcRecodrNotFound | 未发现vpc记录。 |
| InternalError.AccountUserNotAuthenticated | 账户未通过认证。 |
| InternalError.CvmCommon | cvm创建节点报错。 |
| InternalError.VpcCommon | VPC报错。 |
| LimitExceeded | 超过配额限制 |
| InternalError.QuotaUSGLimit | 安全组配额不足。 |
| InternalError.DbAffectivedRows | DB错误 |
| InternalError.CidrMaskSizeOutOfRange | CIDR掩码无效。 |
| InternalError.CidrConflictWithOtherCluster | CIDR和其他集群CIDR冲突。 |
| InternalError.CreateMasterFailed | 创建集群失败。 |
| InternalError.Param | Param。 |
| InternalError.CidrConflictWithVpcCidr | CIDR和vpc冲突。 |
| InternalError.PublicClusterOpNotSupport | 集群不支持当前操作。 |
| InternalError.DfwGetUSGQuota | 获得安全组配额失败。 |
| InternalError | 内部错误 |