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

获取资源层级

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

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

操作 ID

GetResourceHierarchy

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

路径参数

  • clusterUuid
    String必填

    集群UUID。

响应状态

200 OK
200 OK

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

  • 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

  • namespaces
    List

    资源。

    示例： (nested array)

    • uuid
      String

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

      示例： ns-001

    • name
      String

      资源名称。

      示例： production

    • status
      String

      状态信息。

      示例： Active

    • workloads
      List

      资源。

      示例： (nested array)

      • uuid
        String

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

        示例： wl-001

      • name
        String

        资源名称。

        示例： nginx-deployment

      • namespace
        String

        命名空间。

        示例： default

      • kind
        String

        类型。

        示例： Deployment

      • status
        String

        状态信息。

        示例： Running

      • podSpec
        String

        序列化Pod模板规格。

        示例： {}

    • podCount
      Integer

      Pod数量。

      示例： 18

  • nodeCount
    Integer

    节点数量。

    示例： 12

  • podCount
    Integer

    Pod数量。

    示例： 120