Skip to main content
ZStack
Monitoring & Collection/Zaku

GetNodeTopology

Get topology of pods and associations for a specific node

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

Operation ID

GetNodeTopology

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Path Parameters

  • nodeUuid
    StringRequired

    UUID of the node to retrieve topology for

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • node
    Object

    The node value

    • uuid
      String

      Unique identifier of the node

      Example: node-xyz789

    • platformId
      String

      Platform ID this node belongs to

      Example: plat-001

    • clusterUuid
      String

      UUID of the cluster this node belongs to

      Example: cluster-abc123

    • name
      String

      Hostname of the Kubernetes node

      Example: k8s-node-01

    • nodeIp
      String

      Primary IP address of the node

      Example: 10.0.1.25

    • role
      String

      Role of the node within the cluster (master or worker)

      Example: worker

    • status
      String

      Current node status (Ready, NotReady, etc.)

      Example: Ready

    • cpuCapacity
      Integer

      Total CPU capacity in millicores

      Example: 32000

    • memoryCapacity
      String

      Total memory capacity in bytes

      Example: 137438953472

    • labelsRaw
      String

      Raw JSON string of Kubernetes node labels

      Example: {"kubernetes.io/role":"worker"}

    • createDate
      String

      Timestamp when the node was registered

      Example: 2026-01-15T08:00:00Z

    • lastSyncAt
      String

      Timestamp of the last sync for this node

      Example: 2026-01-15T08:00:00Z

  • pods
    List

    The pods value

    Example: (nested array)

    • uuid
      String

      Unique identifier of the pod

      Example: pod-001

    • name
      String

      Name of the pod

      Example: nginx-deployment-abc123

    • namespace
      String

      Kubernetes namespace of the pod

      Example: default

    • status
      String

      Current status phase of the pod

      Example: Running

    • workloadName
      String

      Name of the parent workload managing this pod

      Example: nginx-deployment

    • workloadKind
      String

      Kind of the parent workload (Deployment, StatefulSet, etc.)

      Example: Deployment

    • gpuUuids
      List

      UUIDs of GPU cards assigned to this pod

      Example: item1,item2

  • associations
    List

    Associations for this resource

    Example: (nested array)

    • assocType
      String

      Type of the cross-platform association

      Example: VirtualMachine

    • assocPlatformId
      String

      Platform ID of the associated resource

      Example: plat-002

    • assocUuid
      String

      UUID of the associated resource in the other platform

      Example: vm-001

    • assocName
      String

      Name of the associated resource

      Example: worker-vm-01

    • businessIpv4
      String

      Business IPv4 address of the associated resource

      Example: 192.168.1.10