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

搜索节点列表

集群过滤IP角色状态标签。

GET/api/v1/zaku/nodes

操作 ID

SearchNodes

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

查询参数

  • clusterUuid
    String

    集群UUID。

  • platformId
    String

    平台ID。

  • ipContains
    String

    IP包含。

  • roles
    List

    角色列表。

  • statuses
    List

    状态。

响应状态

200 OK
200 OK

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

  • items
    List

    条目列表。

    示例： (nested array)

    • 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

  • total
    Integer

    返回结果总数。

    示例： 45

  • limit
    Integer

    最大返回条目数。

    示例： 20

  • offset
    Integer

    查询起始偏移量。

    示例： 20