文档首页/ 数据仓库服务 DWS/ 更多文档/ API参考（吉隆坡区域）/ API说明/ 逻辑集群管理/ 创建逻辑集群
更新时间：2025-09-18 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建逻辑集群

功能介绍

创建逻辑集群。

调用方法

请参见如何调用API。

URI

POST /v2/{project_id}/clusters/{cluster_id}/logical-clusters

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

cluster_id

是

String

参数解释：

集群ID。获取方法请参见获取集群ID。

约束限制：

必须是有效的dws集群ID。

取值范围：

36位UUID。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

logical_cluster

是

CreateLogicalClusterInfo object

参数解释：

创建逻辑集群信息。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 CreateLogicalClusterInfo

参数

是否必选

参数类型

描述

logical_cluster_name

是

String

参数解释：

逻辑集群名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

cluster_rings

是

Array of ClusterRing objects

参数解释：

逻辑集群环信息。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表4 ClusterRing

参数

是否必选

参数类型

描述

ring_hosts

是

Array of RingHost objects

参数解释：

集群主机信息。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

un_shrinkable_cluster_ring

否

Boolean

参数解释：

是否可以缩容。

约束限制：

不涉及。

取值范围：

false|true。

默认取值：

不涉及。
表5 RingHost

参数

是否必选

参数类型

描述

host_name

是

String

参数解释：

主机名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

back_ip

是

String

参数解释：

后端IP地址。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

cpu_cores

是

Integer

参数解释：

主机CPU核数。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

memory

是

Double

参数解释：

主机内存。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

disk_size

是

Double

参数解释：

主机磁盘大小。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

请求示例

创建逻辑集群。

POST https://{Endpoint}/v2/9b06d044ea4f49f1a58b2bed2b0084bd/clusters/9b7ff56b-47b3-4d00-a1fd-4c023d34404b/logical-clusters

{
  "logical_cluster" : {
    "logical_cluster_name" : "v3_logical",
    "cluster_rings" : [ {
      "ring_hosts" : [ {
        "host_name" : "host-172-16-20-246",
        "back_ip" : "172.16.73.90",
        "cpu_cores" : 8,
        "memory" : 32.0,
        "disk_size" : 800.0
      }, {
        "host_name" : "host-172-16-4-26",
        "back_ip" : "172.16.123.5",
        "cpu_cores" : 8,
        "memory" : 32.0,
        "disk_size" : 800.0
      }, {
        "host_name" : "host-172-16-4-26",
        "back_ip" : "172.16.123.5",
        "cpu_cores" : 8,
        "memory" : 32.0,
        "disk_size" : 800.0
      } ]
    } ]
  }
}

响应示例

状态码：200

创建逻辑集群请求提交成功。

{
  "error_code" : "DWS.0000",
  "error_msg" : null
}

状态码

状态码

描述

200

创建逻辑集群请求提交成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

500

服务内部错误。

503

服务不可用。
父主题： 逻辑集群管理