getNetworkInventoryItems — 2-р хэсэг: Examples (Жишээнүүд)

← Үндсэн хуудас

Жишээнүүд

Хүсэлт (Request)

  {
       "params": {
           "parentId": "23b19c39b1a43d89367b32ce",
           "page": 1,
           "perPage": 1,
           "filters": {
               "type": {
                   "computers": true
               },
               "depth": {
                   "allItemsRecursively": true
               }
           },
           "options": {
               "companies": {
                   "returnAllProducts": true,
                   "includeRiskScore": true
               },
               "endpoints": {
                   "returnProductOutdated": true,
                   "includeScanLogs": true,
                   "includeRiskScore": true
               }
           }
       },
       "jsonrpc": "2.0",
       "method": "getNetworkInventoryItems",
       "id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b"
  }

Хариу (Response):

{
  "id": "103d7b05-ec02-481b-9ed6-c07b97de2b7a",
  "jsonrpc": "2.0",
  "result": {
    "page": 2,
    "pagesCount": 11,
    "perPage": 1,
    "total": 11,
    "items": [
      {
        "id": "21a295eeb1a43d8b497b24b7",
        "name": "Computer",
        "type": 5,
        "parentId": "21a295eeb1a43d8b497b24b7",
        "companyId": "21a295eeb1a43d8b497b24b7",
        "manageAiSpm": true,
        "details": {
          "label": "endpoint 2",
          "fqdn": "endpoint2.local",
          "groupId": "5a5f4d36b1a43d5f097b23bb",
          "isManaged": true,
          "machineType": 2,
          "operatingSystemVersion": "Windows Server",
          "firstSeen": "2026-08-15T10:30:00",
          "isIsolated": false,
          "ip": "60.40.10.220",
          "publicIp": "198.51.100.42",
          "macs": [
            "324935237346"
          ],
          "modules": {
            "advancedThreatControl": false,
            "antimalware": true,
            "contentControl": false,
            "deviceControl": false,
            "firewall": false,
            "powerUser": false,
            "networkAttackDefense": false
          },
          "ssid": ""
        }
      }
    ]
  }
}

{
  "result": {
    "page": 2,
    "perPage": 3,
    "hasMoreRecords": true,
    "items": [
      "...": "..."
    ]
}

AD хавтасны ID-г олоод, дараа нь тэр ID-г parentId болгон хоёр дахь дуудлагад ашиглаж хавтас доторх бодит компьютеруудыг авна.

1. 1Active Directory хавтасны ID-г олно.

> Тэмдэглэл: Энэ алхамд манай компанийн дээд түвшний контейнеруудыг шүүж, Active Directory интеграцийг төлөөлөх контейнерийг олно. Бид AD-д харгалзах type: 4 (Group) төрлийн элементийг хайж байна.

Хүсэлт (Request)

```
{
"jsonrpc": "2.0",
"id": "step1-find-ad-folder",
"method": "getNetworkInventoryItems",
"params": {
"parentId": "6221f9582dab425234613c82",
"filters": {
"details": {
"name": "Active Directory"
}
}
}
}
```

Хариу (Response)

```
{
"id": "step1-find-ad-folder",
"jsonrpc": "2.0",
"result": {
"total": 1,
"page": 1,
"perPage": 100,
"pagesCount": 1,
"hasMoreRecords": false,
"items": [
{
"id": "64a1bc2e8f3d4a001e5c7890",
"name": "Active Directory",
"type": 4,
"parentId": "6221f9592dab425234613c88",
"companyId": "6221f9582dab425234613c82"
}
]
}
}
```

2. 2Active Directory хавтас доторх бүх компьютерийг авна.

> Тэмдэглэл: Өмнөх алхамд олсон AD хавтасны ID-г parentId болгон ашиглаж, хавтас доторх бүх компьютерийг дэд түвшин хүртэл нь, бүх дэлгэрэнгүй сонголтыг идэвхжүүлсэн байдлаар авна.
>
> Энэ жишээнд AD хавтасны ID нь 64a1bc2e8f3d4a001e5c7890 байна.

Хүсэлт (Request)

```
{
"jsonrpc": "2.0",
"method": "getNetworkInventoryItems",
"id": "step2-get-ad-computers",
"params": {
"parentId": "64a1bc2e8f3d4a001e5c7890",
"filters": {
"type": {
"computers": true
},
"depth": {
"allItemsRecursively": true
},
"security": {
"management": {
"managedWithBest": true
}
}
},
"options": {
"companies": {
"returnAllProducts": true,
"includeRiskScore": true
},
"endpoints": {
"returnProductOutdated": true,
"includeScanLogs": true,
"includeRiskScore": true
}
}
}
}
```

```
{
"jsonrpc": "2.0",
"method": "getNetworkInventoryItems",
"id": "step2-get-ad-computers",
"params": {
"parentId": "64a1bc2e8f3d4a001e5c7890",
"filters": {
"type": {
"computers": true
},
"depth": {
"allItemsRecursively": true
},
"security": {
"management": {
"managedWithBest": true
}
}
},
"options": {
"endpoints": {
"returnProductOutdated": true,
"includeScanLogs": true,
"includeRiskScore": true
}
}
}
}
```

Хариу (Response)

```
{
"id": "step2-get-ad-computers",
"jsonrpc": "2.0",
"result": {
"total": 3,
"page": 1,
"perPage": 100,
"pagesCount": 1,
"hasMoreRecords": false,
"items": [
{
"id": "63a1795cdf372f0e7f84a3f2",
"name": "WIN-C6UPHBAQKMP",
"type": 5,
"parentId": "64a1bc2e8f3d4a001e5c7890",
"companyId": "6221f9582dab425234613c82",
"details": {
"label": "",
"fqdn": "win-c6uphbaqkmp",
"groupId": "6221f9592dab425234613c88",
"isManaged": true,
"machineType": 2,
"operatingSystemVersion": "Windows Server 2019 Standard",
"ip": "10.18.156.11",
"publicIp": "198.51.100.42",
"macs": [
"005056962842"
],
"ssid": "S-1-5-21-3623811015-3361044348-30300820-1013",
"managedWithBest": true,
"policy": {
"id": "5121da426803fa2d0e000017",
"name": "Default policy",
"applied": true
},
"modules": {
"antimalware": true,
"firewall": false,
"contentControl": true,
"powerUser": false,
"deviceControl": false,
"advancedThreatControl": true,
"applicationControl": false,
"encryption": false,
"networkAttackDefense": true,
"advancedAntiExploit": true,
"edrSensor": true,
"hyperDetect": true,
"remoteEnginesScanning": false,
"sandboxAnalyzer": false,
"riskManagement": false
},
"productOutdated": true
}
},
{
"id": "639a4a79962c330620b393a9",
"name": "WIN-01M8RUNUG5I",
"type": 5,
"parentId": "64a1bc2e8f3d4a001e5c7891",
"companyId": "6221f9582dab425234613c82",
"details": {
"label": "",
"fqdn": "win-01m8runug5i",
"groupId": "6221f9592dab425234613c88",
"isManaged": true,
"machineType": 2,
"operatingSystemVersion": "Windows Server 2016 Standard",
"ip": "10.18.149.152",
"publicIp": "198.51.100.42",
"macs": [
"005056968ff0"
],
"ssid": "S-1-5-21-3623811015-3361044348-30300820-1045",
"managedWithBest": true,
"policy": {
"id": "63a181f6a1f3bb1a850dc372",
"name": "no-update",
"applied": true
},
"modules": {
"antimalware": true,
"firewall": false,
"contentControl": true,
"powerUser": false,
"deviceControl": false,
"advancedThreatControl": true,
"applicationControl": false,
"encryption": false,
"networkAttackDefense": true,
"advancedAntiExploit": true,
"edrSensor": true,
"hyperDetect": true,
"remoteEnginesScanning": false,
"sandboxAnalyzer": false,
"riskManagement": false
},
"productOutdated": false
}
},
{
"id": "639b23b624956ebb5dd2b2f3",
"name": "UBUNTU-HELIX",
"type": 5,
"parentId": "64a1bc2e8f3d4a001e5c7890",
"companyId": "6221f9582dab425234613c82",
"details": {
"label": "",
"fqdn": "ubuntu-helix",
"groupId": "6221f9592dab425234613c88",
"isManaged": true,
"machineType": 2,
"operatingSystemVersion": "Linux Ubuntu 20.04.3 LTS",
"ip": "10.18.155.140",
"publicIp": "198.51.100.44",
"macs": [
"005056962499"
],
"ssid": "",
"managedWithBest": true,
"policy": {
"id": "5121da426803fa2d0e000017",
"name": "Default policy",
"applied": true
},
"modules": {
"antimalware": true,
"firewall": false,
"contentControl": false,
"powerUser": false,
"deviceControl": false,
"advancedThreatControl": false,
"applicationControl": false,
"encryption": false,
"networkAttackDefense": true,
"advancedAntiExploit": true,
"hyperDetect": true,
"riskManagement": false
},
"productOutdated": false
}
}
]
}
}
```

Version 1.0

Параметрүүд

• parentId — String; заавал биш: Тийм; зорилтот компани эсвэл бүлгийн ID. Заагаагүй бол API түлхүүртэй холбогдсон компанийн зорилтот объектууд дахь элементүүдийг буцаана.
• filters — Object; заавал биш: Тийм; төгсгөлийн төхөөрөмжүүдийн жагсаалтыг лавлах үед хэрэглэх шүүлтүүрүүд. Боломжит шүүлтүүр болон хэрэглэх талаар Available filters хэсгээс харна уу.
• page — Number; заавал биш: Тийм; үр дүнгийн хуудасны дугаар. Анхдагч утга нь 1.
• perPage — Number; заавал биш: Тийм; нэг хуудсанд буцаах элементийн тоо. Дээд хязгаар нь нэг хуудсанд 100 элемент. Анхдагч утга: нэг хуудсанд 30 элемент.
• options — Object; заавал биш: Тийм; хариунд ямар мэдээлэл орохыг удирдах сонголтуудын багц. Боломжит сонголт болон хэрэглэх талаар Available options хэсгээс харна уу.

Available options (Боломжит сонголтууд)

Хариунд ямар өгөгдөл буцахыг options параметрээр удирдана.

• `companies` — returnAllProducts: true бол өгөгдсөн компанийн бүх бүтээгдэхүүний мэдээлэл хариунд орно. Энэ параметр заавал биш. Анхдагч утга: false.
• `endpoints` — returnProductOutdated: true бол өгөгдсөн компанийн бүх төгсгөлийн төхөөрөмжийн шинэчлэлтийн төлвийн мэдээлэл хариунд орно. Энэ параметр заавал биш. Анхдагч утга: false. includeScanLogs: true бол lastSuccessfulScan шинж чанар API хариунд орно. Энэ параметр заавал биш. Анхдагч утга: false.

Available filters (Боломжит шүүлтүүрүүд)

• `type` — groups: төгсгөлийн төхөөрөмжүүдийн бүх тусгай бүлгийг шүүх Boolean. Анхдагч утга: false. ec2Instances: Amazon EC2 бүх instance-г шүүх Boolean. Анхдагч утга: false. computers: бүх компьютерийг шүүх Boolean. Анхдагч утга: false. virtualMachines: бүх виртуал машиныг шүүх Boolean. Анхдагч утга: false.
• `security` (management) — managedWithBest: аюулгүй байдлын агент суулгасан бүх төгсгөлийн төхөөрөмжийг шүүх Boolean. Анхдагч утга: false. isContainerHost: контейнер хостын хамгаалалт суулгасан бүх төгсгөлийн төхөөрөмжийг шүүх Boolean. Анхдагч утга: false. Энэ шүүлтүүр computers болон virtualmachines үйлчилгээнд боломжтой. managedExchangeServers: хамгаалагдсан бүх Exchange серверийг шүүх Boolean. Анхдагч утга: false. Энэ шүүлтүүр нь аюулгүй байдлын үйлчилгээг хамарсан хүчинтэй лицензийн түлхүүр шаардана. managedRelays: Relay үүрэгтэй бүх төгсгөлийн төхөөрөмжийг шүүх Boolean. Анхдагч утга: false. securityServers: бүх Security Server-ийг шүүх Boolean. Анхдагч утга: false.
• `depth` — allItemsRecursively: компанийн Network Inventory доторх бүх төгсгөлийн төхөөрөмжийг дэд түвшин хүртэл нь шүүх Boolean. Анхдагч утга: false.
• `details` — ssid: string, төгсгөлийн төхөөрөмжийн SSID (Active Directory SID); хамгаалалтын төлвөөс үл хамааран төгсгөлийн төхөөрөмжүүдийг шүүхэд хэрэглэнэ. macs: array, MAC хаягуудын жагсаалт; хамгаалалтын төлвөөс үл хамааран төгсгөлийн төхөөрөмжүүдийг шүүхэд хэрэглэнэ. name: элементүүдийг нэрээр нь шүүх String. Хамгийн багадаа гурван тэмдэгт байх ёстой.