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

获取节点拓扑

获取拓扑Pod关联特定节点。

GET/api/v1/zaku/nodes/{nodeUuid}/topology

操作 ID

GetNodeTopology

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

路径参数

  • nodeUuid
    String必填

    节点UUID。

响应状态

200 OK
200 OK

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

  • node
    Object

    节点。

    • uuid
      String

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

      示例： node-xyz789

    • platformId
      String

      平台ID。

      示例： plat-001

    • clusterUuid
      String

      集群UUID。

      示例： cluster-abc123

    • name
      String

      资源名称。

      示例： k8s-node-01

    • nodeIp
      String

      主IP地址节点。

      示例： 10.0.1.25

    • role
      String

      角色信息。

      示例： worker

    • status
      String

      状态信息。

      示例： Ready

    • cpuCapacity
      Integer

      总CPU容量毫核。

      示例： 32000

    • memoryCapacity
      String

      总内存容量字节。

      示例： 137438953472

    • labelsRaw
      String

      原始JSON字符串kubernetes节点标签。

      示例： {"kubernetes.io/role":"worker"}

    • createDate
      String

      创建时间。

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

    • lastSyncAt
      String

      最近一次同步时间。

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

  • pods
    List

    Pod。

    示例： (nested array)

    • uuid
      String

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

      示例： pod-001

    • name
      String

      资源名称。

      示例： nginx-deployment-abc123

    • namespace
      String

      命名空间。

      示例： default

    • status
      String

      状态信息。

      示例： Running

    • workloadName
      String

      工作负载名称。

      示例： nginx-deployment

    • workloadKind
      String

      工作负载类型。

      示例： Deployment

    • gpuUuids
      List

      GPU UUID。

      示例： item1,item2

  • associations
    List

    资源。

    示例： (nested array)

    • assocType
      String

      类型跨平台关联。

      示例： VirtualMachine

    • assocPlatformId
      String

      平台ID关联资源。

      示例： plat-002

    • assocUuid
      String

      关联UUID。

      示例： vm-001

    • assocName
      String

      名称关联资源。

      示例： worker-vm-01

    • businessIpv4
      String

      业务I PV 4地址关联资源。

      示例： 192.168.1.10