跳转到主要内容
API Explorer|API Explorer
监控与采集相关接口/Zaku
GETZaku起始版本 1.0同步需要认证

查询集群列表

列表kubernetes集群已注册平台。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

查询参数

请求参数

查询参数

  • platformIdString

    平台ID。

  • limitInteger

    最多返回的记录数。

    示例： 0

  • offsetInteger

    查询起始偏移量。

    示例： 0

响应状态

200 OK

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

  • itemsList

    条目列表。

    示例： (nested array)

    • clusterObject

      集群信息。

      • uuidString

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

        示例： cluster-abc123

      • platformIdString

        平台ID。

        示例： plat-001

      • zakuIdString

        内部Zaku数值标识符。

        示例： 42

      • nameString

        资源名称。

        示例： prod-k8s-cluster-01

      • statusString

        状态信息。

        示例： Running

      • descriptionString

        资源的详细描述。

        示例： Production Kubernetes cluster for AI workloads

      • nodeCountInteger

        节点数量。

        示例： 12

      • createDateString

        创建时间。

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

      • lastSyncAtString

        最近一次同步时间。

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

      • syncStatusString

        同步状态。

        示例： Success

      • lastSyncErrorString

        最近一次同步错误。

        示例： connection refused

      • syncDurationMsString

        同步耗时，单位为毫秒。

        示例： 350

    • gpuPoolCountInteger

      GPU池数量。

      示例： 3

  • totalInteger

    返回结果总数。

    示例： 5

  • limitInteger

    最大返回条目数。

    示例： 20

  • offsetInteger

    查询起始偏移量。

    示例： 20

请求地址

GET/api/v1/zaku/clusters

/api/v1/zaku/clusters

操作 ID

ListClusters

永久链接

请求示例

curl -X GET '{host}/api/v1/zaku/clusters' -H 'Authorization: Bearer {token}'

响应示例

200
{
  "items": [
    {}
  ],
  "total": 5,
  "limit": 20,
  "offset": 20
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史