更新时间:2026-09-03 GMT+08:00

查询集群详情

功能介绍

该接口用于查询并显示单个集群详情,可以得到集群数据搜索类型、节点对象列表、网络信息、集群名称、集群ID、集群状态等,以便客户检查创建的集群是否符合预期。客户也可以进入CSS服务,在集群的概览信息页面,可以获取集群的内网访问地址、公网访问地址、版本、节点等信息。

调用方法

请参见如何调用API。

URI

GET /v1.0/{project_id}/clusters/{cluster_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。获取方法请参见获取项目ID和名称。

约束限制:

不涉及

取值范围:

账户的项目ID。

默认取值:

不涉及

cluster_id

是

String

参数解释:

指定查询的集群ID。获取方法请参见获取集群ID。

约束限制:

不涉及

取值范围:

集群ID。

默认取值:

不涉及

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

datastore

ClusterDetailDatastore object

参数解释:

集群数据搜索引擎类型。

取值范围:

不涉及

instances

Array of ClusterDetailInstances objects

参数解释:

节点对象列表。

取值范围:

不涉及

publicKibanaResp

publicKibanaRespBody object

参数解释:

Kibana/Dashboards公网访问信息,包括IP地址、白名单、宽带信息等。

取值范围:

不涉及

elbWhiteList

elbWhiteListResp object

参数解释:

公网访问控制信息。

取值范围:

不涉及

updated

String

参数解释:

集群上次修改时间。

取值范围:

格式为ISO8601:CCYY-MM-DDThh:mm:ss。

name

String

参数解释:

集群名称。

取值范围:

不涉及

publicIp

String

参数解释:

公网IP和端口信息。

取值范围:

不涉及

snapshotPolicy

SnapshotPolicyResp object

参数解释:

集群自动快照策略相关信息。

取值范围:

不涉及

created

String

参数解释:

集群创建时间。

取值范围:

格式为ISO8601:CCYY-MM-DDThh:mm:ss。

id

String

参数解释:

集群ID。

取值范围:

不涉及

status

String

参数解释:

集群状态值。

取值范围:

  • 100:操作进行中,如创建中。

  • 200:可用。

  • 300:不可用。

  • 303:创建失败。

endpoint

String

参数解释:

集群内网访问IPv4地址和端口号。当集群类型为kooSearch集群时,该字段表示集群内网访问知识管理地址和端口号。

取值范围:

不涉及

vpcId

String

参数解释:

VPC ID,即虚拟私有云ID。

取值范围:

不涉及

subnetId

String

参数解释:

集群当前的子网。此子网用于新增节点,包括扩容、添加独立Master/Client节点、开启终端节点服务,新增节点将通过当前子网申请IP并绑定。

取值范围:

不涉及

securityGroupId

String

参数解释:

安全组ID。

取值范围:

不涉及

vpcepIp

String

参数解释:

终端节点IP。

取值范围:

不涉及

vpcepIpv6Address

String

参数解释:

终端节点IPv6。

取值范围:

不涉及

bandwidthSize

Integer

参数解释:

公网带宽大小,单位:Mbit/s。

取值范围:

不涉及

httpsEnable

Boolean

参数解释:

通信加密状态。

取值范围:

  • false:未设置通信加密。

  • true:已设置通信加密。

diskEncrypted

Boolean

参数解释:

磁盘是否加密。

取值范围:

  • true : 磁盘已加密。

  • false : 磁盘未加密。

authorityEnable

Boolean

参数解释:

集群是否开启安全模式认证。

取值范围:

  • true:表示集群开启安全模式认证。

  • false:表示集群不开启安全模式认证。

backupAvailable

Boolean

参数解释:

是否开启快照。

取值范围:

  • true: 快照开启状态。

  • false: 快照关闭状态。

actionProgress

Object

参数解释:

集群行为进度,显示创建或扩容进度的百分比。

取值范围:

不涉及

actions

Array of strings

参数解释:

集群当前正在进行的任务列表。

取值范围:

  • REBOOTING:重启中。

  • GROWING:扩容中。

  • RESTORING:集群恢复中。

  • SNAPSHOTTING:创建快照中。

  • BIND_FAILURE:绑定公网失败。

  • SHRINKING : 缩容中。

  • REPLACE_NODE : 节点替换中。

  • AZ_MIGRATION : 可用区切换中。

  • RESIZING_FLAVOR : 变更规格中。

  • MODE_CHANGING : 安全模式修改中。

  • SG_CHANGING : 安全组更改中。

  • UPGRADING : 版本升级中。

  • RESETING_PASSWORD : 重置密码中。

  • CONFIGURED : 配置已更新待重启。

enterpriseProjectId

String

参数解释:

集群所属的企业项目ID。如果集群所属用户没有开通企业项目,则不会返回该参数。

取值范围:

不涉及

tags

Array of ClusterDetailTags objects

参数解释:

集群标签。

取值范围:

不涉及

failedReason

ClusterDetailFailedReasons object

参数解释:

集群变更任务的失败原因。如果集群处于正常状态,则不返回该参数。

取值范围:

不涉及

bandwidthResourceId

String

参数解释:

公网访问的资源ID。

取值范围:

不涉及

ipv6Endpoint

String

参数解释:

集群内网访问IPv6地址和端口号。

取值范围:

不涉及

supportVpcep

Boolean

参数解释:

当前集群是否支持开启终端节点服务。

取值范围:

  • true:支持。

  • false:不支持。

cmkId

String

参数解释:

当前集群使用的磁盘加密密钥ID。

取值范围:

不涉及

currentSubnetIds

String

参数解释:

集群当前所有节点用到的子网,如果存在多个(最多支持两个),使用英文逗号隔开。

取值范围:

不涉及

desc

String

参数解释:

集群描述。

取值范围:

长度不超过128个字符。

表3 ClusterDetailDatastore

参数

参数类型

描述

type

String

参数解释:

引擎类型。

取值范围:

  • elasticsearch:基于开源Elasticsearch提供在线分布式搜索、日志统计报表、语义搜索等功能。

  • logstash:基于开源OpenSearch提供分布式搜索、日志统计报表、语义搜索等功能。

  • opensearch:基于开源Logstash提供数据收集、转换、清洗、解析等功能。

version

String

参数解释:

集群引擎版本号。详细请参考CSS使用前必读中支持的版本。

取值范围:

不涉及

subVersion

String

参数解释:

集群发布版本号。

取值范围:

不涉及

isEosCluster

Boolean

参数解释:

表示集群发布版本是否EOS。

取值范围:

  • true:表示过期。

  • false:表示未过期。

supportSecuritymode

Boolean

'参数解释:

集群认证是否支持安全模式。

取值范围:

  • true:支持。

  • false:不支持。

表4 ClusterDetailInstances

参数

参数类型

描述

status

String

参数解释:

节点状态值。

取值范围:

  • 100:创建中。

  • 200:可用。

  • 300:不可用。

  • 303:创建失败。

resourceId

String

参数解释:

该实例对应的计费资源ID。

取值范围:

不涉及

type

String

参数解释:

当前节点类型。

取值范围:

  • ess:数据节点。

  • ess-cold:冷数据节点。

  • ess-client:Client节点。

  • ess-master:Master节点。

  • lgs:LogStash节点。

id

String

参数解释:

实例ID。

取值范围:

不涉及

name

String

参数解释:

实例名字。

取值范围:

不涉及

specCode

String

参数解释:

节点规格名称。

取值范围:

不涉及

azCode

String

参数解释:

节点所属可用区信息。

取值范围:

不涉及

ip

String

参数解释:

实例IP信息。

取值范围:

不涉及

volume

ShowClusterVolumeRsp object

参数解释:

实例磁盘信息。

取值范围:

不涉及

subnetId

String

参数解释:

当前节点所属子网ID。

取值范围:

不涉及

表5 ShowClusterVolumeRsp

参数

参数类型

描述

type

String

参数解释:

实例磁盘类型。

取值范围:

  • COMMON:普通I/O

  • HIGH:高I/O

  • ULTRAHIGH:超高I/O

  • ESSD:极速SSD

size

Integer

参数解释:

实例磁盘大小。

取值范围:

不涉及

resourceIds

Array of strings

参数解释:

该实例拥有的磁盘对应的计费资源ID。

取值范围:

不涉及

表6 publicKibanaRespBody

参数

参数类型

描述

eipSize

Integer

参数解释:

Kibana公网访问或Dashboards公网访问的带宽大小,单位:Mbit/s。

取值范围:

不涉及

elbWhiteListResp

kibanaElbWhiteListResp object

参数解释:

kibana公网访问或Dashboards公网访问控制信息。

取值范围:

不涉及

publicKibanaIp

String

参数解释:

kibana公网访问或Dashboards公网访问IP地址。

取值范围:

不涉及

bandwidthResourceId

String

参数解释:

当前kibana公网或Dashboards公网对应的资源ID。

取值范围:

不涉及

表7 kibanaElbWhiteListResp

参数

参数类型

描述

enableWhiteList

Boolean

参数解释:

是否开启kibana公网访问或Dashboards公网访问控制白名单。

取值范围:

  • true: 开启访问控制白名单。

  • false: 关闭访问控制白名单。

whiteList

String

参数解释:

kibana公网访问或Dashboards公网访问白名单。

取值范围:

IP地址。

表8 elbWhiteListResp

参数

参数类型

描述

enableWhiteList

Boolean

参数解释:

是否开启公网访问控制。设置访问白名单,表示只允许白名单列表中的IP地址访问集群;不设置白名单,所有的IP地址都可以访问集群。

取值范围:

  • true: 开启公网访问控制。

  • false: 关闭公网访问控制。

whiteList

String

参数解释:

公网访问白名单。

取值范围:

IP地址。

表9 SnapshotPolicyResp

参数

参数类型

描述

backupEnable

Boolean

参数解释:

集群是否开启自动快照。

取值范围:

  • true:开启

  • false:未开启

bakPeriod

String

参数解释:

快照备份时间。

取值范围:

不涉及

bakFrequency

String

参数解释:

快照备份间隔。

取值范围:

  • DAY每天

  • MON每周一

  • TUE每周二

  • WED每周三

  • THU每周四

  • FRI每周五

  • SAT每周六

  • SUN每周日

  • HOUR每小时

bakKeepDay

Integer

参数解释:

快照备份保留个数。

取值范围:

不涉及

表10 ClusterDetailTags

参数

参数类型

描述

key

String

参数解释:

集群标签的key值。

取值范围:

不涉及

value

String

参数解释:

集群标签的value值。

取值范围:

不涉及

表11 ClusterDetailFailedReasons

参数

参数类型

描述

errorCode

String

参数解释:

错误码。

取值范围:

  • CSS.6000:表示集群创建失败。

  • CSS.6001:表示集群扩容失败。

  • CSS.6002:表示集群重启失败。

  • CSS.6004:表示集群节点创建失败。

  • CSS.6005:表示服务初始化失败。

errorMsg

String

参数解释:

详细错误信息。

取值范围:

不涉及

请求示例

查询集群详细信息。

GET https://{Endpoint}/v1.0/{project_id}/clusters/5c2bab0d-ec5f-491f-9418-b8da38a26760

响应示例

状态码:200

请求成功。

{
  "datastore": {
    "type": "elasticsearch",
    "version": "7.10.2",
    "subVersion": "7.10.2_24.3.0_0827",
    "isEosCluster": false,
    "supportSecuritymode": false
  },
  "instances": [
    {
      "status": "200",
      "type": "ess",
      "id": "{INSTANCE_ID}",
      "name": "css-8bc5-ess-esn-1-1",
      "specCode": "ess.spec-4u8g",
      "azCode": "{AZ_CODE}",
      "volume": {
        "type": "ULTRAHIGH",
        "size": 40,
        "resourceIds": [
          "{RESOURCE_ID}"
        ]
      },
      "ip": "192.168.0.122",
      "resourceId": "{RESOURCE_ID}",
      "subnetId": "{SUBNET_ID}"
    }
  ],
  "publicKibanaResp": {
    "eipSize": 10,
    "publicKibanaIp": "100.95.152.28",
    "elbWhiteListResp": null,
    "bandwidthResourceId": "18bec13f-5cc1-4631-867f-33505d15be12"
  },
  "elbWhiteList": {
    "whiteList": "",
    "enableWhiteList": false
  },
  "updated": "2023-10-09T02:07:13",
  "name": "css-8bc5",
  "desc": "csscluster"
  "snapshotPolicy": {
    "backupEnable": false,
    "bakPeriod": "",
    "bakFrequency": "",
    "bakKeepDay": 1
  },
  "publicIp": "100.85.222.202",
  "created": "2023-10-09T02:07:13",
  "id": "{CLUSTER_ID}",
  "status": "200",
  "endpoint": "192.168.0.122:9200",
  "vpcId": "{VPC_ID}",
  "subnetId": "{SUBNET_ID}",
  "securityGroupId": "{SECURITY_GROUP_ID}",
  "bandwidthResourceId": "{BANDWIDTH_RESOURCE_ID}",
  "bandwidthSize": 3,
  "httpsEnable": true,
  "authorityEnable": true,
  "diskEncrypted": false,
  "backupAvailable": false,
  "actionProgress": {},
  "actions": [],
  "enterpriseProjectId": "0",
  "tags": [],
  "period": true,
  "supportVpcep": true,
  "currentSubnetIds": "{SUBNET_ID}"
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

404

所请求的资源不存在。

建议直接修改该请求,不要重试该请求。

错误码

请参见错误码。