获取终端列表

此方法返回终端列表。

重要提示

此方法已更新至1.1版本。如需1.0版本相关信息，请参阅本节内容 .

参数

参数	类型	可选	描述
`parentId`	字符串	是	目标公司或组的ID。若未指定，则该方法返回与API密钥关联公司目标内的条目。注意要获取Active Directory终端信息，请使用 getNetworkInventoryItems 方法。
`isManaged`	布尔值	是	列出受管或非受管终端的标志。默认未设置该参数，方法返回所有受管与非受管终端。若设置为 `True` ，则方法仅返回受管终端。
`page`	数字	是	结果页码。默认值： `1` .
`perPage`	数字	是	每页返回的条目数量。可选值： `1` - `1000` . 默认值：30。
`筛选器`	对象	是	用于自定义要检索的端点类型的参数。关于可用筛选器及其使用方法的详细信息，请参阅“可用筛选器”部分。
`选项`	对象	是	一组控制响应中包含哪些信息的选项。

可用筛选器

您可以使用 筛选器 参数根据特定属性查询端点。筛选器按章节和子章节结构组织，具体如下所述

查询结果是匹配所有章节及子章节中任意选定筛选器的端点列表。

以下是可用的筛选选项：

章节	子章节	筛选选项
`安全`	管理	`托管最佳方案` - 布尔值，用于筛选所有安装了安全代理的端点。默认值： `False` . `managedExchangeServers` - 布尔值，用于筛选所有受保护的Exchange服务器。默认值： `False` . 该筛选器需要覆盖安全服务的有效许可证密钥。 `managedRelays` - 布尔值，用于筛选所有具有Relay角色的端点。默认值： `False` . `securityServers` - 布尔值，用于筛选所有安全服务器。默认值： `False` .
`depth`		`allItemsRecursively` - 布尔值，用于递归筛选公司网络清单中的所有端点。默认值： `False` .
`details`		`ssid` - 字符串，用于通过SSID（端点的Active Directory SID）筛选端点，无论其保护状态如何。 `macs` - 数组，用于通过MAC地址列表筛选端点，无论其保护状态如何。 `name` - 字符串，用于通过名称筛选端点，无论其保护状态如何。最小字符串长度为三个字符。

重要

部分筛选器需要激活特定许可证，否则将被忽略，导致API响应不准确。

字段 name 支持部分匹配。

该筛选器返回名称完全匹配或以指定值开头的终端节点。若要将指定值用作后缀，请使用星号符号(*)。

例如：

如果 名称 为 computer ，则API返回所有名称以 computer .

如果 名称 为 *puter ，则API返回名称中包含 puter 的所有终端节点列表。

可用选项

您可以使用 options 参数自定义API响应中包含的信息。选项按章节和子章节组织，具体说明如下。

以下是可用选项：

章节	描述
`returnProductOutdated`	布尔值。若为 `true` ，则API响应中包含 `productOutdated` 属性。
`includeScanLogs`	布尔值。若为true，则 `lastSuccessfulScan` 属性将包含在API响应中。默认值： `false` .

返回值

此方法返回一个包含端点信息的对象。返回对象包含以下字段：

page - 当前显示页面的页码。
pagesCount - 总页数。

注意

该属性仅在第一页显示。
perPage - 每页显示的项目总数。
total - 请求返回的项目总数。

注意

该属性仅在第一页显示。
hasMoreRecords - 布尔值，表示下一页是否还有更多记录。
items - 包含端点列表的数组。列表中每个条目包含以下字段：
- id ，受管端点的ID，
- name ，端点名称，
- label ，为此端点设置的标签，
- fqdn ，该端点的完全限定域名（FQDN），
- groupId ，该端点的组ID，
- isManaged ，布尔值 True ，若该端点受管理，
- machineType ，机器类型：（1 - 计算机，2 - 虚拟机，3 - EC2实例，0 - 其他），
- operatingSystemVersion ，该端点的操作系统版本，
- ip ，该端点的IP地址，
- macs ，该端点的MAC地址，
- ssid ，该端点的SSID（Active Directory SID），
- managedWithBest ，布尔值 True ，若 BEST 已安装在此端点上，
- isContainerHost ，布尔值 True ，若该端点为容器主机，
- managedExchangeServer ，布尔值 True ，若此终端为Exchange服务器，
- managedRelay ，布尔值 True ，若此终端具有中继角色，
- securityServer ，布尔值 True ，若此终端为安全服务器，
- policy ，包含终端生效策略信息的对象。该对象包含以下字段：
  - id - 唯一标识生效策略的字符串，
  - name - 策略名称，
  - applied - 布尔值，若策略当前应用于终端则设为True，
movingInfo ，包含终端从一家公司转移至另一家公司信息的对象。该对象包含：
- state - 终端迁移状态（0-进行中，1-已完成），
- destinationCompanyName - 终端迁移至的目标公司名称。
productOutdated ，布尔值 True ，若终端缺少一个或多个代理更新。
lastSuccessfulScan ，对象。包含以下详细信息：
- name - 扫描名称。
- 日期 - 执行扫描的日期。

示例

请求 :

{
      "params": {
           "parentId": "63c6bb02e3cb799758020b99",
           "page": 1,
           "perPage": 3,
           "filters": {
                   "security": {
                            "management": {
                                "managedWithBest": true,
                                "managedRelays": true
				}
                   }
		},
           "options": {
                   "returnProductOutdated": true,
                   "includeScanLogs": true
           }
      },
      "jsonrpc": "2.0",
      "method": "getEndpointsList",
      "id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b"
}

响应 :

{
  "result": {
    "total": 8,
    "page": 1,
    "perPage": 3,
    "pagesCount": 3,
    "hasMoreRecords": true,
    "items": [
      {
        "id": "64b7625d3c11463ef77e5d6d",
        "name": "string00:16:3e:7f:d3:2e",
        "label": "",
        "fqdn": "s0lc5.wkorh.dsd.ro",
        "groupId": "64b503c21ecee42e130a7bc9",
        "isManaged": true,"machineType": 1,"operatingSystemVersion": "Windows 7 专业版",
        "ip": "231.180.244.114",
        "macs": [
          "00:16:3e:7f:d3:2e"
        ],
        "ssid": "","managedWithBest": true,
        "policy": {
          "id": "64b76bed92f0176fa203b64c",
          "name": "新策略",
          "applied": false
        },"productOutdated": false,
        "lastSuccessfulScan": {
          "name": "72OHI5dnIH",
          "date": "2023-07-19T04:09:29+00:00"
        }
      }
    ]
  },
  "jsonrpc": "2.0",
  "id": "5986",
  "error": null
}

{
  "result": {
    "page": 2,
    "perPage": 3,
    "hasMoreRecords": true,
    "items": [
      {
       ...
      }
    ]
  },
  "jsonrpc": "2.0",
  "id": "5986",
  "error": null
}

版本 1.0

参数

参数	类型	可选	描述
`parentId`	字符串	是	目标公司或组的ID。如果未指定或设置为公司ID，则该方法仅返回计算机和组 . 注意要获取Active Directory终端信息，请使用 getNetworkInventoryItems 方法。
`isManaged`	布尔值	是	用于列出受管或非受管终端的标志。默认情况下未设置该参数，方法将返回所有受管和非受管终端。若设置为 `True` ，则方法仅返回受管终端。
`page`	数字	是	结果页码。默认页码为1。
`perPage`	数字	是	每页返回的条目数。上限为每页100条。默认值：每页30条。
`filters`	对象	是	查询终端列表时使用的过滤器。关于可用过滤器及其使用方法，请参阅“可用过滤器”部分。
`options`	数组	是	一组控制响应中包含哪些信息的选项。

可用过滤器

您可以使用 filters 通过特定属性查询终端的参数。筛选器按章节和子章节进行组织，具体说明如下

查询结果是匹配所有章节及子章节中任意选定筛选条件的终端列表。

以下是可用的筛选选项：

章节	子章节	筛选选项
`安全`	管理	`managedWithBest` - 布尔值，用于筛选安装了安全代理的所有终端。默认值： `否` . `managedExchangeServers` - 布尔值，用于筛选所有受保护的Exchange服务器。默认值： `否` . 该筛选器需要覆盖安全服务的有效许可证密钥。 `managedRelays` - 布尔值，用于筛选具有Relay角色的所有终端。默认值： `否` . `securityServers` - 布尔值，用于筛选所有安全服务器。默认值： `否` .
`depth`		`allItemsRecursively` - 布尔值，用于递归筛选公司网络清单中的所有终端。默认值： `否` .
`详细信息`		`SSID` - 字符串，用于通过SSID（端点的Active Directory SID）筛选端点，无论其保护状态如何。 `MAC地址` - 数组，用于通过MAC地址列表筛选端点，无论其保护状态如何。 `名称` - 字符串，用于通过名称筛选端点，无论其保护状态如何。最小字符串长度为3个字符。

重要提示

部分筛选条件需激活特定许可证，否则将被忽略，导致API返回结果不准确。

字段 名称 支持部分匹配。

该筛选器返回名称完全匹配或以指定值开头的端点。若需将指定值作为后缀，请使用星号(*)。

例如：

若 名称 为 computer ，则API返回所有名称以 computer .

若 名称 为 *puter ，则API返回名称中包含 puter 的所有端点列表。

可用选项

可通过 选项 参数用于自定义API响应中包含的信息。选项按章节和子章节组织，具体说明如下。

以下是可用选项：

章节	描述
`returnProductOutdated`	布尔值。若为 `true` ，则API响应中会包含 `productOutdated` 属性。
`includeScanLogs`	布尔值。若为true，则API响应中会包含 `lastSuccessfulScan` 属性。默认值： `false` .

返回值

此方法返回一个包含端点信息的对象。返回对象包含以下内容：

page 当前页码
pagesCount 总页数
perPage 每页返回条目总数
total 条目总数
items 包含端点列表的数组。列表中每个条目包含以下字段：
- id ，受管端点的ID，
- name ，端点的名称，
- label ，为此端点设置的标签，
- fqdn ，端点的完全限定域名，
- groupId ，端点的组ID，
- isManaged ，布尔值 True ，如果此端点受管理，
- machineType ，机器类型：（1 - 计算机，2 - 虚拟机，3 - EC2实例，0 - 其他），
- operatingSystemVersion ，端点的操作系统版本，
- ip ，端点的IP地址，
- macs ，端点的MAC地址，
- ssid ，端点的SSID（Active Directory SID），
- managedWithBest ，布尔值 True ，如果 BEST 安装在此端点上，
- isContainerHost ，布尔值 真 ，如果此终端是容器主机，
- 受管理的Exchange服务器 ，布尔值 真 ，如果此终端是Exchange服务器，
- 受管理中继 ，布尔值 真 ，如果此终端具有中继角色，
- 安全服务器 ，布尔值 真 ，如果此终端是安全服务器，
- 策略 ，一个对象，用于告知终端上活动的策略。该对象包含以下字段：
  - ID - 唯一标识活动策略的字符串，
  - 名称 - 策略的名称，
  - 已应用 - 布尔值，如果策略当前已应用于终端，则设置为真，
移动信息 ，一个对象，用于告知终端从一个公司转移到另一个公司的情况。该对象包含：
- 状态 - 终端移动状态（0 - 进行中，1 - 已移动），
- 目标公司名称 - 终端被移动到的公司的名称。
产品过时 ，布尔值 真 ，表示终端缺少一个或多个代理更新。
lastSuccessfulScan ，对象。包含以下详细信息：
- name - 扫描的名称。
- date - 执行扫描的日期。

示例

请求 :

{
      "params": {
           "parentId": "63c6bb02e3cb799758020b99",
           "page": 1,
           "perPage": 10,
           "filters": {
                   "security": {
                            "management": {
                                "managedWithBest": true,
                                "managedRelays": true
				}
                   }
		},
           "options": {
                   "returnProductOutdated": true,
                   "includeScanLogs": true
           }
      },
      "jsonrpc": "2.0",
      "method": "getEndpointsList",
      "id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b"
}

响应 :

{
  "result": {
    "total": 1,
    "page": 1,
    "perPage": 30,
    "pagesCount": 1,
    "items": [
      {
        "id": "64b7625d3c11463ef77e5d6d",
        "name": "string00:16:3e:7f:d3:2e",
        "label": "",
        "fqdn": "s0lc5.wkorh.dsd.ro",
        "groupId": "64b503c21ecee42e130a7bc9",
        "isManaged": true,"machineType": 1,"operatingSystemVersion": "Windows 7 专业版",
        "ip": "231.180.244.114",
        "macs": [
          "00:16:3e:7f:d3:2e"
        ],
        "ssid": "","managedWithBest": true,
        "policy": {
          "id": "64b76bed92f0176fa203b64c",
          "name": "新策略",
          "applied": false
        },"productOutdated": false,
        "lastSuccessfulScan": {
          "name": "72OHI5dnIH",
          "date": "2023-07-19T04:09:29+00:00"
        }
      }
    ]
  },
  "jsonrpc": "2.0",
  "id": "5986",
  "error": null
}

本节内容 :

获取终端列表

重要提示

参数

注意

可用筛选器

重要

可用选项

返回值

注意

注意

示例

版本 1.0

参数

注意

可用过滤器

重要提示

可用选项

返回值

示例

搜索结果