这是本节的多页打印视图。 点击此处打印.

返回本页常规视图.

节点相关接口

节点相关接口

1 - /host/info

获取单个节点的基本信息

参数

  1. id: 机器ID

返回值

{
  "code": 0,
  "payload": {
    "hostname": 主机名,
    "os": linux或windows
  }
}

2 - /host/list

查询节点列表

参数

  1. ids: 需获取主机ID列表,可选,csv

返回值

{
  "code": 0,
  "payload": [
    {
      "id": 机器ID,
      "version": agent版本号,
      "ip": ip地址,
      "mac": mac地址,
      "os": 操作系统(windows或linux),
      "platform": 操作系统名称(centos或debian),
      "arch": 操作系统位数(amd64或i386
    }, ...
  ]
}

说明

  1. 当不传ids参数时表示获取所有主机列表,否则获取给定ID的列表,若给定ID不存在则忽略

3 - /host/search

根据IP地址或MAC地址查找节点

参数

  1. keyword: IP地址或MAC地址

返回值

{
  "code": 0,
  "payload": 主机ID
}

错误,未找到

{
  "code": 404,
  "msg": "client not found"
}