说明：当前页面接口为旧版 API，未来可能停止维护。容器服务 API 3.0 版本接口定义更加规范，访问时延下降显著，建议使用 容器服务 API 3.0。
接口描述
本接口 ( CreateEmptyCluster ) 用于创建空集群。
接口请求域名：
ccs.api.qcloud.com输入参数
以下请求参数列表仅列出了接口请求参数，其它参数见 公共请求参数。
| 参数名称 | 描述 | 类型 | 必选 |
|---|---|---|---|
| clusterName | 集群名称 | String | 是 |
| clusterCIDR | 用于分配集群容器和服务 IP 的 CIDR，不得与 VPC CIDR 冲突，也不得与同 VPC 内其他集群 CIDR 冲突 | String | 是 |
| clusterDesc | 集群描述 | String | 否 |
| clusterVersion | 集群版本 | String | 否 |
| osName | 系统名。CentOS7.2x86_64 或者 Ubuntu16.04.1 LTSx86_64，集群下所有节点都使用此系统，扩展节点也会自动使用此系统 | String | 否 |
| projectId | 集群所属项目 ID | UInt | 否 |
| ignoreClusterCIDRConflict | 是否忽略 ClusterCIDR 冲突错误，默认为 0 |
Int | 否 |
| masterSubnetId | 集群 Master 会占用一个 VPC 子网的 IP，该参数指定 Master 占用的 IP 所在哪个子网。该子网必须与集群存在同一个 VPC 内。 | String | 否 |
输出参数
| 参数名称 | 描述 | 类型 |
|---|---|---|
| code | 公共错误码。0 表示成功，其他值表示失败。详见 错误返回结果 | Int |
| codeDesc | 业务侧错误码。成功时返回 Success，错误时返回具体业务错误原因 | String |
| message | 模块错误信息描述，与接口相关。详见 错误返回结果 | String |
| requestId | 任务 ID | Int |
| clusterId | 集群 ID | Int |
示例
输入
https://domain/v2/index.php?Action=CreateEmptyCluster
&clusterCIDR=172.21.0.0/16
&clusterName=test
&clusterVersion=1.8.13
&vpcId=vpc-xxxxx
&projectId=0
&subnetId=subnet-3lzrkspo
&其它公共参数输出
{
"data":{
"code":0,
"message":"",
"codeDesc":"Success",
"data":{
"requestId":1174,
"clusterId":"cls-xxxxx"
}
},
"message":"",
"code":0
}