ListClusters
获取当前用户所有已纳管的集群
服务地址:
华东1(杭州)
输入参数
只看必填
current当前页数(从第1页开始)
pageSize每页大小
name通过插件的名字过滤插件
cluster_id通过集群 ID 过滤
cluster_status- Running : 集群纳管正常;
cluster_type- ACK: ACK 集群
id本字段已废弃
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

请求语法

GET /api/v1/am/cluster/list_clusters HTTP/1.1

请求参数

字段名称字段详情
currentinteger<int64>

当前页数(从第 1 页开始)

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:1
pageSizeinteger<int64>

每页大小

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:10
namestring

通过插件的名字过滤插件

示例值:proxy-next-upstream
cluster_idstring

通过集群 ID 过滤展开详情

示例值:cb7d4cc26c8f845fb8a8255ffd394820e参考取值来源:
    ListClusterAgentInstallRecords
cluster_statusstring
示例值:Running枚举值:RunningInstallingUninstallingUpgradingOffline
cluster_typestring
示例值:ACK枚举值:ACKCUSTOM
idstring

本字段已废弃,请使用 cluster_id 字段过滤

示例值:cb7d4cc26c8f845fb8a8255ffd394820e

返回参数

字段名称字段详情
codestring

状态码展开详情

示例值:Success
messagestring

错误信息展开详情

示例值:success
RequestIdstring

请求 ID,可用于全链路诊断

示例值:B149FD9C-ED5C-5765-B3AD-05AA4A4D64D7
totalinteger<int64>

总记录数

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:64
dataarray<object>

返回数据

变更历史
变更时间变更内容概要操作
2024-12-27
新增OpenAPI,获取当前用户纳管集群列表