# 查询集群详情 - ShowCluster #### 功能介绍 查询集群详情接口。 #### URI GET /v1/clusters/{cluster_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | cluster_id | 是 | String | **参数解释** EMS集群的id。 **约束限制** 不涉及。 **取值范围** 必须为UUID格式。 **默认取值** 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | cluster_metadata | [ClusterMetadata] object | **参数解释** 集群基本信息。 **取值范围** 不涉及。 | | cluster_specification | [ClusterSpecification] object | **参数解释** 创建时指定的集群配置信息。 **取值范围** 不涉及。 | 表3ClusterMetadata | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释** 集群ID，资源唯一标识，创建后自动生成。 **取值范围** 不涉及。 | | status | String | **参数解释** 集群状态。 **取值范围** - CREATING：创建中。 - RUNNING：运行中。 - FREEZE：已冻结。 - UPGRADING：升级中。 - EXPANDING：扩容中。 - SHRINKING：缩容中 - DELETING：删除中。 - DELETED：已删除。 | | reason | String | **参数解释** 集群变为当前状态的原因，在集群在非"Available"状态下时，会返回此参数。 **取值范围** 不涉及。 | | project_id | String | **参数解释** 所属租户项目ID。 **取值范围** 不涉及。 | | created_at | String | **参数解释** 集群创建时间。 **取值范围** 不涉及。 | | updated_at | String | **参数解释** 集群信息更新时间。 **取值范围** 不涉及。 | | k8s_name | String | **参数解释** 关联的CCE集群名称。 **取值范围** 不涉及。 | | available_node_count | Integer | **参数解释** 业务集群当前可用节点数。 **取值范围** 3-512 | 表4ClusterSpecification | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释** 集群名称。 **取值范围** 以小写字母开头，由字母、数字、中划线(-)组成，长度范围4-128位，且不能以中划线(-)结尾。 | | description | String | **参数解释** 集群描述。 **取值范围** 不涉及。 | | charge_mode | Integer | **参数解释** 付费模式。 **取值范围** 0：按需付费。 | | k8s_cluster_specification | [K8sClusterSpecification] object | **参数解释** 业务k8s集群部署配置。 **取值范围** 不涉及。 | | memory_specification | [MemorySpecification] object | **参数解释** EMS集群内存配置。 **取值范围** 不涉及。 | 表5K8sClusterSpecification | 参数 | 参数类型 | 描述 | |:---|:---|:---| | k8s_cluster_id | String | **参数解释** CCE集群ID。 **约束限制** 必须为UUID格式。 **取值范围** 不涉及。 **默认取值** 不涉及。 | | namespace | String | **参数解释** CCE集群中部署ems服务的命名空间。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 | | label | [K8sLabel] object | **参数解释** 指定CCE集群中的安装范围，当前支持指定标签。Map对象，key为标签名，value为标签值。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 | | node_count | Integer | **参数解释** CCE集群节点数。 **约束限制** 不涉及。 **取值范围** 3-512。 **默认取值** 不涉及。 | | flavor | String | **参数解释** 集群实例规格。 **约束限制** 不涉及。 **取值范围** 由一个或多个字母开始，后面跟随一个或多个由点分隔的字母段的字符串组成。且长度为1-64个字符。 **默认取值** 不涉及。 | | version | String | **参数解释** 集群版本，发放的集群版本。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值空** | | lts_enable | Boolean | **参数解释** 是否安装云原生日志采集插件用LTS采集日志，安装前请提前创建LTS的转储委托。 **约束限制** 不涉及。 **取值范围** - true: 开启日志采集。 - false: 关闭日志采集。 **默认取值** true。 | | lts_connect_type | Integer | **参数解释** 日志接入方式。 **约束限制** 不涉及。 **取值范围** - 0: logagent。 - 1: icagent。 **默认取值** 0。 | | monitor_enable | Boolean | **参数解释** 是否安装云原生监控插件。 **约束限制** 不涉及。 **取值范围** - true: 已安装云原生监控插件。 - false: 未安装云原生监控插件。 **默认取值** true。 | | node_type | Integer | **参数解释** 节点类型。 **约束限制** 不涉及。 **取值范围** - 0: 自动检测。 - 1: A3节点。 - 2: 其他。 **默认取值** 0。 | | node_list | Array of [NodeInfo] objects | **参数解释** 集群节点信息列表，包含每个节点上运行的Pod信息，仅在查询集群详情响应体中出现。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 | 表6K8sLabel | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释** 标签的键。 **约束限制** 不涉及。 **取值范围** 以字母或者数字开头和结尾，由字母、数字、连接符(-)、下划线(_)、点号(.)组成，且长度范围不超过63个字符。 **默认取值** ems。 | | value | String | **参数解释** 标签的值。 **约束限制** 不涉及。 **取值范围** 以字母或者数字开头和结尾，由字母、数字、连接符(-)、下划线(_)、点号(.)组成，且长度范围不超过63个字符。 **默认取值** true。 | 表7NodeInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | node_name | String | **参数解释** 主机名称，即为节点的IP地址。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 | | pod_list | Array of [PodInfo] objects | **参数解释** 该节点上运行的Pod信息列表。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 | 表8PodInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | pod_type | String | **参数解释** Pod类型，用于标识Pod的用途。 **约束限制** 不涉及。 **取值范围** - ems-zookeeper：ems-zookeeper - ems-controller：ems-controller - ems-server：ems-server - ems-agent：ems-agent **默认取值** 不涉及。 | | pod_name | String | **参数解释** Pod名称，Kubernetes中Pod的资源名称。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 | 表9MemorySpecification | 参数 | 参数类型 | 描述 | |:---|:---|:---| | huge_page_num | Integer | **参数解释** 大页数。 **约束限制** 不涉及。 **取值范围** 131072-2147483647。 **默认取值** 默认256GB，对应数量是131072。 | | huge_page_flavor | Integer | **参数解释** 大页规格（即大页大小，单位MB）。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 默认2MB。 | **状态码：400** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 错误码，用于标识具体的错误类型。 **取值范围** 不涉及。 | | error_msg | String | **参数解释** 错误描述，用于说明具体的错误信息。 **取值范围** 不涉及。 | #### 请求示例 查询ID为"4f4b3dfa-eb70-47cf-a60a-998a53bd598a"的集群详情。 ``` GET https://{endpoint}/v1/clusters/d25cd468-f6c6-43ec-bd13-591958e3d044 ``` #### 响应示例 **状态码：200** **参数解释** 查询集群详情成功返回响应体。 **取值范围** 不涉及。 ``` { "cluster_metadata" : { "id" : "d25cd468-f6c6-43ec-bd13-591958e3d044", "status" : "RUNNING", "reason" : null, "project_id" : "2d29ce239ba24d759bb37e624b0a6e06", "created_at" : "2026-04-07 19:21:01", "updated_at" : "2026-04-21 06:58:18", "k8s_name" : null, "available_node_count" : null }, "cluster_specification" : { "name" : "test-alpha-ems-demo-cluster-6ahdul", "description" : null, "charge_mode" : "0", "k8s_cluster_specification" : { "k8s_cluster_id" : "2036b058-03c0-11f0-b46a-0255ac1001b2", "namespace" : "ems-d25cd468-f6c6-43ec-bd13-591958e3d044", "label" : { "key" : "ems2", "value" : "true" }, "node_count" : 0, "flavor" : "xms.storage.pro.nodeCount", "version" : "v1.0", "lts_enable" : true, "lts_connect_type" : "0", "monitor_enable" : true, "node_type" : "0", "node_list" : [ { "node_name" : "192.168.1.1", "pod_list" : [ { "pod_type" : "ems-server", "pod_name" : "ems-server-95kkm" }, { "pod_type" : "EMS-Agent", "pod_name" : "ems-agent-6485fb8c97-65988" } ] }, { "node_name" : "192.168.1.2", "pod_list" : [ { "pod_type" : "ems-controller", "pod_name" : "ems-controller-f5bbb797b-bgqc7" }, { "pod_type" : "ems-server", "pod_name" : "ems-server-gqdjm" } ] }, { "node_name" : "192.168.1.3", "pod_list" : [ { "pod_type" : "ems-zookeeper", "pod_name" : "ems-zookeeper-1" }, { "pod_type" : "ems-server", "pod_name" : "ems-server-c4czc" } ] } ] }, "memory_specification" : { "huge_page_num" : 512, "huge_page_flavor" : 2 } } } ``` **状态码：400** **参数解释** 错误响应体。 **取值范围** 不涉及。 ``` { "error_code" : "EMS.00004000", "error_msg" : "invalid parameter" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | **参数解释** 查询集群详情成功返回响应体。 **取值范围** 不涉及。 | | 400 | **参数解释** 错误响应体。 **取值范围** 不涉及。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ems/ems_04_0031.html)。