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

查询逻辑集群可用环节点信息

功能介绍

查询逻辑集群可用环节点信息。

调用方法

请参见如何调用API。

URI

GET /v2/{project_id}/clusters/{cluster_id}/logical-clusters/rings

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

cluster_id

是

String

参数解释：

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

约束限制：

必须是有效的dws集群ID。

取值范围：

36位UUID。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

参数解释：

分页偏移量，从0开始，页数减1。

约束限制：

不涉及。

取值范围：

大于等于0。

默认取值：

0

limit

否

Integer

参数解释：

分页单页大小。

约束限制：

不涉及。

取值范围：

大于0。

默认取值：

10

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

cluster_rings

Array of LogicalClusterRingInfo objects

参数解释：

集群环列表信息。

取值范围：

不涉及。

count

Integer

参数解释：

集群环数量。

取值范围：

不涉及。
表4 LogicalClusterRingInfo

参数

参数类型

描述

ring_hosts

Array of RingHost objects

参数解释：

集群实例环信息。

取值范围：

不涉及。
表5 RingHost

参数

参数类型

描述

host_name

String

参数解释：

主机名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

back_ip

String

参数解释：

后端IP地址。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

cpu_cores

Integer

参数解释：

主机CPU核数。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

memory

Double

参数解释：

主机内存。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

disk_size

Double

参数解释：

主机磁盘大小。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求示例

查询逻辑集群可用环节点信息。

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

响应示例

状态码：200

查询逻辑集群可用环节点信息成功。

{
  "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-43-90",
      "back_ip" : "172.16.92.175",
      "cpu_cores" : 8,
      "memory" : 32.0,
      "disk_size" : 800.0
    } ]
  } ],
  "count" : 1
}

状态码

状态码

描述

200

查询逻辑集群可用环节点信息成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

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