跳转到主要内容
ZStack
监控与采集相关接口/Zaku

查询集群列表

列表kubernetes集群已注册平台。

GET/api/v1/zaku/clusters

操作 ID

ListClusters

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

查询参数

  • platformId
    String

    平台ID。

  • limit
    Integer

    最多返回的记录数。

    示例： 0

  • offset
    Integer

    查询起始偏移量。

    示例： 0

响应状态

200 OK
200 OK

该 API 成功时返回以下响应结构。

  • items
    List

    条目列表。

    示例： (nested array)

    • cluster
      Object

      集群信息。

      • uuid
        String

        资源的UUID，唯一标识该资源。

        示例： cluster-abc123

      • platformId
        String

        平台ID。

        示例： plat-001

      • zakuId
        String

        内部Zaku数值标识符。

        示例： 42

      • name
        String

        资源名称。

        示例： prod-k8s-cluster-01

      • status
        String

        状态信息。

        示例： Running

      • description
        String

        资源的详细描述。

        示例： Production Kubernetes cluster for AI workloads

      • nodeCount
        Integer

        节点数量。

        示例： 12

      • createDate
        String

        创建时间。

        示例： 2026-01-15T08:00:00Z

      • lastSyncAt
        String

        最近一次同步时间。

        示例： 2026-01-15T08:00:00Z

      • syncStatus
        String

        同步状态。

        示例： Success

      • lastSyncError
        String

        最近一次同步错误。

        示例： connection refused

      • syncDurationMs
        String

        同步耗时，单位为毫秒。

        示例： 350

    • gpuPoolCount
      Integer

      GPU池数量。

      示例： 3

  • total
    Integer

    返回结果总数。

    示例： 5

  • limit
    Integer

    最大返回条目数。

    示例： 20

  • offset
    Integer

    查询起始偏移量。

    示例： 20