文档首页/ 表格存储服务 CloudTable/ API参考/ CloudTable集群管理接口V2/ 创建CloudTable集群
更新时间：2023-12-04 GMT+08:00
查看PDF
分享

创建CloudTable集群

功能介绍

创建一个CloudTable集群。 使用接口前，您需要先获取如下资源信息。

  • 通过VPC创建或查询VPC、子网。
  • 通过安全组创建或查询可用的security_group_id。

本接口是一个同步接口，当创建CloudTable集群成功后会返回集群id。

调试

您可以在API Explorer中调试该接口。

URI

POST /v2/{project_id}/clusters

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法，请参见获取项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Language

是

String

语言类型。
表3 请求Body参数

参数

是否必选

参数类型

描述

cluster

是

Cluster object

创建集群参数对象实体。
表4 Cluster

参数

是否必选

参数类型

描述

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

创建集群数据库参数。
表5 Instance

参数

是否必选

参数类型

描述

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。

备注：此字段废弃。
表6 Nics

参数

是否必选

参数类型

描述

net_id

是

String

CloudTable集群所在网络ID。

security_group_id

是

String

CloudTable所在安全组对应的ID。
表7 Datastore

参数

是否必选

参数类型

描述

version

是

String

controller版本号，默认1.0.6。

type

是

String

集群数据库类型。

响应参数

状态码： 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

创建集群请求已成功处理。

相关文档