
# 创建CloudTable集群 - CreateCluster（废弃）
#### 功能介绍
创建一个CloudTable集群。 使用接口前，您需要先获取如下资源信息。
- 通过VPC创建或查询VPC、子网。
- 通过安全组创建或查询可用的security_group_id。
本接口是一个同步接口，当创建CloudTable集群成功后会返回集群id。
![](https://support.huaweicloud.com/api-cloudtable/public_sys-resources/note_3.0-zh-cn.png)
当前接口已废弃，不推荐使用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CloudTable&api=CreateCluster)中调试该接口。
#### URI
POST /v2/{project_id}/clusters
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                              |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-cloudtable/cloudtable_api_0013.html)。 |
   
#### 请求参数
表2请求Header参数 
| 参数         | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| X-Language | 是    | String | 语言类型。 |
   
表3请求Body参数 
| 参数      | 是否必选 | 参数类型                                              | 描述          |
|:---|:---|:---|:---|
| cluster | 是    | [Cluster] object | 创建集群参数对象实体。 |
   
 表4Cluster 
| 参数              | 是否必选 | 参数类型                                                  | 描述                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| auth_mode       | 否    | String                                                | 是否开启IAM权限认证。 - false：不开启  - true：开启 备注：此字段废弃。               |
| enable_lemon    | 否    | Boolean                                               | 是否开启Lemon(目前已关闭该参数，填false即可) - false：不开启  - true：开启 备注：此字段废弃。         |
| enable_openTSDB | 否    | Boolean                                               | 是否开启OpenTSDB。 - false：不开启  - true：开启 备注：此字段只适用HBase1.3.1版本。    |
| instance        | 是    | [Instance] object   | 集群的实例对象。                                                                                                                                                                                                                                                                                                            |
| name            | 是    | String                                                | CloudTable集群的名称。                                                                                                                                                                                                                                                                                                    |
| storage_size    | 否    | Integer                                               | 存储值的大小。 HBase取值范围: 800GB-10TB。                                                                                                                                                                                                                                                      |
| storage_type    | 是    | String                                                | 存储类型： - ULTRAHIGH：超高IO  - COMMON：普通IO                                                                         |
| vpc_id          | 是    | String                                                | 集群所在的（虚拟网络私有云）VPC。                                                                                                                                                                                                                                                                                                  |
| datastore       | 是    | [Datastore] object | 创建集群数据库参数。                                                                                                                                                                                                                                                                                                          |
   
 表5Instance 
| 参数                | 是否必选 | 参数类型                                                  | 描述                                                                 |
|:---|:---|:---|:---|
| availability_zone | 是    | String                                                | 集群所在可用区的ID。                                                        |
| cu_num            | 是    | Integer                                               | CloudTable集群计算单元节点数目，至少为2。                                         |
| lemon_num         | 否    | Integer                                               | CloudTable集群Lemon节点数目。 备注：此字段废弃。  |
| nics              | 是    | Array of [Nics] objects | 集群所在网络信息。                                                          |
| tsd_num           | 是    | Integer                                               | CloudTable集群TSD节点数目，至少为2。 备注：此字段废弃。 |
   
 表6Nics 
| 参数                | 是否必选 | 参数类型   | 描述                    |
|:---|:---|:---|:---|
| net_id            | 是    | String | CloudTable集群所在网络ID。   |
| security_group_id | 是    | String | CloudTable所在安全组对应的ID。 |
   
 表7Datastore 
| 参数      | 是否必选 | 参数类型   | 描述                     |
|:---|:---|:---|:---|
| version | 是    | String | controller版本号，默认1.0.6。 |
| type    | 是    | String | 集群数据库类型，hbase、doris。   |
   
#### 响应参数
**状态码： 200**
表8响应Body参数 
| 参数         | 参数类型   | 描述              |
|:---|:---|:---|
| cluster_id | String | 集群唯一标识，新建集群的ID。 |
   
#### 请求示例
创建超高IO集群请求样例（enable_openTSDB字段只适用HBase1.3.1版本，enable_lemon字段废弃）。
```
POST/v2/{project_id}/clusters/
{
  "cluster" : {
    "name" : "cloudtable-interfacetest1",
    "datastore" : {
      "version" : "1.0.6",
      "type" : "hbase"
    },
    "vpc_id" : "23af42c2-f57f-499f-8a2f-a934bd05b8b3",
    "storage_type" : "ULTRAHIGH",
    "enable_openTSDB" : false,
    "auth_mode" : false,
    "enable_lemon" : false,
    "instance" : {
      "nics" : [ {
        "net_id" : "8e8b7b75-5e55-4948-907e-79d06e18c516",
        "security_group_id" : "57c6e2a1-857c-4504-92b2-24e95bd587cc"
      } ],
      "availability_zone" : "cn-north-1a",
      "cu_num" : 2,
      "tsd_num" : 0,
      "lemon_num" : 0
    }
  }
}
```
#### 响应示例
**状态码： 200**
创建集群请求已成功处理。
```
{
  "cluster_id" : "e194bbd6-e1a4-4ab6-b6ea-3d75db6316da"
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | 创建集群请求已成功处理。 |
   
