查看集群列表
更新时间：2025-04-01
接口说明
查看集群列表，优化集群状态
请求URI
POST /api/bes/cluster/v2/list
请求头参数
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| x-Region | String | 否 | 区域 | bd |
请求体参数
请求体字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| pageNo | Integer | 是 | 页数（从1开始取值） | 1 |
| pageSize | Integer | 是 | 页大小 | 10 |
响应体参数
响应体字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| success | Boolean | 操作是否成功 | true |
| status | Integer | 状态码 | 200 |
| page | Page | 集群信息列表 |
Page字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| pageNo | Integer | 页数 | 0 |
| pageSize | Integer | 页大小 | 10 |
| totalCount | Integer | 集群个数 | 1 |
ResultItem字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| clusterId | String | 集群ID | 572979545519558656 |
| clusterName | String | 集群名称 | postpaynew1 |
| createTime | String | 创建时间 | 2021-10-26 10:56:12 |
| actualStatus | String | 状态,active：正常，activating：生效中，invalid：失效 | active |
| runningTime | String | 运行时间 | 12 小时23 分钟 |
| region | String | 区域 | bj |
| version | String | 版本 | 7.10.2 |
| clusterHealth | ClusterHealth | ||
| billing | Billing | 集群计费信息 | |
| tags | List |
标签信息 | |
| resGroupList | List |
资源分组 | |
| innerAccessIp | String | 内部访问ip | 1.1.1.1 |
| accessEip | String | 访问的eip | 1.1.1.1 |
| vpcId | String | vpcId | xxx-xxx-xxx-xxx |
| subnet | List |
子网信息 | |
| network | List |
网络信息 |
ClusterHealth字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| status | String | 健康状态 | GREEN(健康)、YELLOW(亚健康)、RED(不健康) |
Billing字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| paymentType | String | 计费类型 | postpay |
TagsItem字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| tagKey | String | 标签key | test |
| tagValue | String | 标签value | 111 |
ResGroupListItem字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| groupId | String | 资源分组id | RESG-44pvmsruNiy |
| groupName | String | 资源分组名称 | 默认分组 |
SubnetItem字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| availableZone | String | 可用区名称 | zoneA |
| subnetName | String | 字网名称 | 系统预定义子网 |
NetworkItem字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| subnetId | String | 子网id | xxx-xxx-xxx-xxx-xxx |
请求示例
POST /api/bes/cluster/v2/list
<公共请求头>
x-Region: bd
{
"pageNo" : 1,
"pageSize" : 10
}响应示例
HTTP/1.1 200 OK
<公共响应头>
{
"success" : true,
"page" : {
"result" : [ {
"resGroupList" : [ {
"groupName" : "默认分组",
"groupId" : "RESG-44pvmsruNiy"
}, {
"groupName" : "默认分组",
"groupId" : "RESG-44pvmsruNiy"
} ],
"subnet" : [ {
"availableZone" : "zoneA",
"subnetName" : "系统预定义子网"
}, {
"availableZone" : "zoneA",
"subnetName" : "系统预定义子网"
} ],
"accessEip" : "1.1.1.1",
"clusterId" : "572979545519558656",
"runningTime" : "12 小时23 分钟",
"clusterHealth" : {
"status" : "GREEN(健康)、YELLOW(亚健康)、RED(不健康)"
},
"version" : "7.10.2",
"billing" : {
"paymentType" : "postpay"
},
"tags" : [ {
"tagValue" : "111",
"tagKey" : "test"
}, {
"tagValue" : "111",
"tagKey" : "test"
} ],
"network" : [ {
"subnetId" : "xxx-xxx-xxx-xxx-xxx"
}, {
"subnetId" : "xxx-xxx-xxx-xxx-xxx"
} ],
"actualStatus" : "active",
"createTime" : "2021-10-26 10:56:12",
"innerAccessIp" : "1.1.1.1",
"clusterName" : "postpaynew1",
"vpcId" : "xxx-xxx-xxx-xxx",
"region" : "bj"
}, {
"resGroupList" : [ {
"groupName" : "默认分组",
"groupId" : "RESG-44pvmsruNiy"
}, {
"groupName" : "默认分组",
"groupId" : "RESG-44pvmsruNiy"
} ],
"subnet" : [ {
"availableZone" : "zoneA",
"subnetName" : "系统预定义子网"
}, {
"availableZone" : "zoneA",
"subnetName" : "系统预定义子网"
} ],
"accessEip" : "1.1.1.1",
"clusterId" : "572979545519558656",
"runningTime" : "12 小时23 分钟",
"clusterHealth" : {
"status" : "GREEN(健康)、YELLOW(亚健康)、RED(不健康)"
},
"version" : "7.10.2",
"billing" : {
"paymentType" : "postpay"
},
"tags" : [ {
"tagValue" : "111",
"tagKey" : "test"
}, {
"tagValue" : "111",
"tagKey" : "test"
} ],
"network" : [ {
"subnetId" : "xxx-xxx-xxx-xxx-xxx"
}, {
"subnetId" : "xxx-xxx-xxx-xxx-xxx"
} ],
"actualStatus" : "active",
"createTime" : "2021-10-26 10:56:12",
"innerAccessIp" : "1.1.1.1",
"clusterName" : "postpaynew1",
"vpcId" : "xxx-xxx-xxx-xxx",
"region" : "bj"
} ],
"pageNo" : 0,
"pageSize" : 10,
"totalCount" : 1
},
"status" : 200
}错误码
请参考通用错误码