该接口可用于快速查询集群列表，相对2019-08-06版本的接口，这个接口属于轻量级API，速度与效率更高，不会返回EnhanceServiceSet、ManagedClusterControlPlaneLog等控制面信息。需要查询全量集群基本信息，请使用DescribeClusterSummary。
参数名称 | 类型 | 必填 | 描述 |
|---|
| Action | String | 是 | 公共参数，本接口取值：DescribeCluster。 |
| Version | String | 是 | 公共参数，本接口取值：2023-11-15。 |
| ClusterId | String | 否 | |
| Marker | Int | 否 | 默认值：0 |
| MaxResults | Int | 否 | 值范围0-20 默认值：10 |
| Search | String | 否 | 集群名称模糊匹配 |
| Filter.N | Object | 否 | |
| Name | String | 否 | 当前只支持 cluster-manage-mode |
| Value | String[] | 否 |
|
参数名称 | 类型 | 描述 |
|---|
| RequestId | String | 请求ID 示例值：5c4e0a37-e3c6-49e1-a67d-e9775cd592e8 |
| TotalCount | Int | 集群总数量 示例值：5 |
| MaxResults | Int | 单次调用返回的最大记录数 示例值：20 |
| Marker | Int | 分页标识，如果调用未返回全部实例，标记下次调用的返回值的起点，如果已返回全部实例，则其值为0 示例值：0 |
| ClusterSet | Object[] | |
| ClusterId | String | 集群ID 示例值：b12d7079-1e59-4626-90eb-xxxxxx |
| ClusterName | String | 集群名称 示例值：mycluster |
| ClusterType | String | 该字段已废弃 示例值：VirtualMachine |
| ClusterManageMode | String | 集群管理形态
示例值：DedicatedCluster |
| K8sVersion | String | k8s集群版本 示例值：v1.21.3 |
| ClusterDesc | String | 集群描述信息 示例值：this is my k8s cluster |
| PodCidr | String | 集群pod网段 示例值：10.66.0.0/16 |
| ServiceCidr | String | 集群Service网段 示例值：10.254.0.0/16 |
| VpcId | String | 集群VpcId 示例值：31e21dca-c92e-4b06-a8ce-xxxxxxx |
| VpcCidr | String | 集群Vpc网段 示例值：10.0.0.0/16 |
| Status | String | 集群状态
示例值：running |
| NodeNum | Int | Worker节点总数 示例值：5 |
| NormalNodeNum | Int | Worker正常节点数量 示例值：3 |
| NetworkType | String | 集群网络模型
示例值：Flannel |
| MaxPodPerNode | Int | 单个节点上运行的pod数量上限 示例值：128 |
| MasterEtcdSeparate | Boolean | 集群Master与Etcd组件是否分开部署 示例值：false |
| OrderType | Int | 订单类型
示例值：2 |
| ServiceEndTime | String | 服务结束时间，一般预付费包年包月才有该值，格式 yyyy-MM-dd HH:mm:ss 示例值：2026-08-20 20:00:00 |
| EnableKMSE | Boolean | 是否已支持微服务 示例值：false |
| CreateTime | String | 集群创建时间 示例值：2024-07-01T11:29:27+08:00 |
| UpdateTime | String | 更新时间 示例值：2024-07-01T11:52:54+08:00 |
JSON格式
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码
错误码 | 错误信息 | Http状态码 | 描述 |
|---|
| ClusterIdInvalid | ClusterId must match `^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$` | 400 | 集群ID必须满足 `^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$` |
| MarkerInvalid | Marker must be greater or equal to 0 | 400 | Marker必须大于等于0 |
| MaxResultsInvalid | MaxResults must be equal or less than 20 | 400 | MaxResults必须小于等于20 |
| SearchInvalid | the length of Search can't exceed 100 | 400 | Search长度不能超过100个字符 |
| FilterInvalid | unsupported Filter, only supports cluster-manage-mode | 400 | 不支持的filter过滤，仅支持clluster-manage-mode过滤 |
| FilterValueInvalid | FilterValue contains repeat value xx | 400 | 过滤参数包含重复Value值 |
纯净模式
