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

获取资源层级

获取全量命名空间工作负载层级集群。

调试可用性

在线调试

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

路径参数

请求参数

路径参数

  • clusterUuidString必填

    集群UUID。

响应状态

200 OK

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

  • 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

  • namespacesList

    资源。

    示例： (nested array)

    • uuidString

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

      示例： ns-001

    • nameString

      资源名称。

      示例： production

    • statusString

      状态信息。

      示例： Active

    • workloadsList

      资源。

      示例： (nested array)

      • uuidString

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

        示例： wl-001

      • nameString

        资源名称。

        示例： nginx-deployment

      • namespaceString

        命名空间。

        示例： default

      • kindString

        类型。

        示例： Deployment

      • statusString

        状态信息。

        示例： Running

      • podSpecString

        序列化Pod模板规格。

        示例： {}

    • podCountInteger

      Pod数量。

      示例： 18

  • nodeCountInteger

    节点数量。

    示例： 12

  • podCountInteger

    Pod数量。

    示例： 120

请求地址

GET/api/v1/zaku/clusters/{clusterUuid}/hierarchy

/api/v1/zaku/clusters/{clusterUuid}/hierarchy

操作 ID

GetResourceHierarchy

永久链接

请求示例

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

响应示例

200
{
  "cluster": {},
  "namespaces": [
    {}
  ],
  "nodeCount": 12,
  "podCount": 120
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史