getNetworkInventoryItems method: сүлжээний нэгжүүдийн жагсаалтыг хэрхэн авах вэ? — 3-р хэсэг: Return value

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

Буцаах утга (Return value)

Энэ method нь сүлжээний нэгжүүдийн мэдээллийг агуулсан Object буцаана. Буцаах object дараах талбаруудтай:

• page - одоогийн хуудас
• pagesCount - нийт хуудасны тоо
• perPage - нэг хуудаст буцаасан нэгжийн тоо
• total - нийт нэгжийн тоо
• items - нэгжүүдийн жагсаалт агуулсан массив. Жагсаалтын бичлэг бүр дараах талбаруудтай:

- id, сүлжээний нэгжийн ID,
- name, сүлжээний нэгжийн нэр,
- parentId, эцэг контейнерийн ID,
- companyId, эцэг компанийн ID,
- type, сүлжээний нэгжийн төрөл: 1 - Company (компани), 2 - Root Container (Companies болон Network контейнерууд), 3 - Company Folder (компанийн хавтас), 4 - Group (бүлэг), 5 - Computer (компьютер), 6 - Virtual Machine (виртуал машин), 7 - EC2 Instance, 14 - Containers Group, 15 - Container Host Folder, 16 - Container.
- details, нэгжийн талаарх нэмэлт мэдээлэл. Энэ талбар нь 1 - Company, 5 - Computer, 6 - Virtual Machine, 7 - EC2 Instance болон 16 - Container төрлүүдэд байна. details гишүүний агуулгыг details гишүүн хэсгээс үзнэ үү.

details гишүүн (The details member)

Сүлжээний зарим нэгж details гишүүнтэй байдаг. Энэ гишүүн нэгжийн талаарх нэмэлт мэдээллийг харуулна. Мэдээлэл нь нэгжийн төрлөөс хамаарна.

• `5(computer), 6(virtual machine) and 7(EC2 Instance)` — дараах талбарууд:

- label, endpoint-д оноосон шошго
- fqdn, endpoint-ийн FQDN
- groupId, endpoint-ийн бүлгийн ID
- isManaged, boolean, endpoint удирдлагад байвал True
- machineType, машины төрөл: (1 - компьютер, 2 - виртуал машин, 3 - EC2 Instance, 0 - бусад)
- operatingSystemVersion, endpoint-ийн үйлдлийн системийн хувилбар
- firstSeen - endpoint GravityZone-д анх бүртгэгдсэн эсвэл илрүүлэгдсэн цаг
- isIsolated - boolean, endpoint одоо тусгаарлах үйлдлээр сүлжээнээс тусгаарлагдсан бол true
- ip, endpoint-ийн дотоод IP хаяг
- publicIp, endpoint-ийн олон нийтийн (public) IP хаяг
- macs, endpoint-ийн MAC хаягуудын жагсаалт
- ssid, endpoint-ийн Active Directory SID
- managedWithBest, boolean, энэ endpoint дээр BEST суулгасан бол true
- isContainerHost, boolean, энэ endpoint нь Container Host бол true
- managedExchangeServer, boolean, энэ endpoint нь Exchange Server бол true
- managedRelay, boolean, энэ endpoint Relay үүрэгтэй бол true
- securityServer, boolean, энэ endpoint нь Security Server бол true
- policy - endpoint дээр идэвхтэй бодлогыг мэдээлэх Object. Дараах талбаруудтай:
- id, идэвхтэй бодлогыг өвөрмөц тодорхойлох String
- name, бодлогын нэр
- applied, бодлого endpoint дээр одоо хэрэгжиж байвал true болох Boolean
- movingInfo - endpoint-ийг нэг компаниас нөгөө рүү шилжүүлэх үеийн мэдээлэл өгөх Object. Дараах талбаруудтай:
- state, endpoint-ийн шилжилтийн төлөв (0 - явагдаж байна, 1 - шилжсэн)
- destinationCompanyName, endpoint-ийг шилжүүлсэн компанийн нэр.
- modules - суулгасан модулиуд болон тэдгээрийн төлөвийг мэдээлэх Object. Талбарууд Boolean утгатай: true - модуль идэвхтэй, false - модуль идэвхгүй. Боломжит талбарууд:
- advancedThreatControl
- antimalware
- contentControl
- deviceControl
- firewall
- powerUser
- encryption
- edrSensor
- hyperDetect
- patchManagement
- relay
- sandboxAnalyzer
- exchange
- advancedAntiExploit
- containerProtection
- networkAttackDefense
- integrityMonitoring
- productOutdated - тухайн endpoint дээрх security agent шинэчлэгдсэн эсэхийг заах Boolean. Боломжит утгууд:
- true, endpoint дээр суулгасан agent шинэчлэгдсэн байна.
- false, agent-ийн хамгийн сүүлийн хувилбар суулгагдаагүй байна.
- lastSuccessfulScan, object. Дараах мэдээллийг агуулна:
- name - шалгалтын (scan) нэр.
- date - шалгалт хийгдсэн огноо.

Жишээ (Example)

Хүсэлт (Request):

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

Хариу (Response):

         {
  "id": "301f7b05-ec02-481b-9ed6-c07b97de2b7",
  "jsonrpc": "2.0",
  "result": {
    "total": 4,
    "page": 1,
    "perPage": 3,
    "pagesCount": 2,
    "items": [
      {
        "id": "6979caeecc68e2d8440569f3",
        "name": "Partner A",
        "type": 1,
        "parentId": "6979cad9741a790bc5066175",
        "companyId": "6979cad9741a790bc5066172",
        "firstSeen": "2026-08-15T10:30:00",
        "isIsolated": false,
        "details": {
          "type": 0,
          "address": "",
          "phone": "",
          "industry": 203,
          "canBeManagedByAbove": true,
          "enforce2FA": true,
          "skip2FAPeriod": 7,
          "isSuspended": false,
          "createdAt": "2026-01-28T08:38:06",
          "country": "AI",
          "state": "N/A",
          "duplicateClosedIncidentsOnUpdate": true,
          "licenseInfo": {
            "isAddon": false,
            "expiryDate": "2027-04-10T00:20:16",
            "usedSlots": 0,
            "reservedSlots": 0,
            "totalSlots": null,
            "manageExchange": false,
            "manageEncryption": false,
            "manageRemoteEnginesScanning": false,
            "manageHyperDetect": false,
            "manageSandboxAnalyzer": false,
            "managePatchManagement": false,
            "manageEventCorrelator": false,
            "manageEmailSecurity": false,
            "manageExtendedEmailSecurity": true,
            "manageMobileSecurity": false,
            "manageContainerProtection": false,
            "managePHASR": false,
            "manageEASM": false,
            "manageIntegrityMonitoring": false,
            "manageComplianceManager": false,
            "assignedProtectionModel": "aLaCarte",
            "additionalProtectionModels": [
              "aLaCarte"
            ],
            "assignedProductType": 0,
            "additionalProductTypes": [
              0
            ],
            "ownUse": {
              "manageXDRIdentityProviders": false,
              "manageXDRProductivityApps": false,
              "manageXDRNetwork": false,
              "manageXDRCloudWorkloads": false,
              "manageRemoteEnginesScanning": false,
              "manageContainerProtection": false,
              "manageHyperDetect": false,
              "manageSandboxAnalyzer": false,
              "manageEventCorrelator": false,
              "managePHASR": false,
              "manageEASM": false,
              "manageComplianceManager": false,
              "manageExtendedEmailSecurity": true
            },
            "resell": {
              "manageXDRResell": false,
              "manageRemoteEnginesScanningResell": false,
              "manageContainerProtectionResell": false,
              "manageHyperDetectResell": false,
              "manageSandboxAnalyzerResell": false,
              "manageEventCorrelatorResell": false,
              "managePHASRResell": false,
              "manageEASMResell": false,
              "manageComplianceManagerResell": false,
              "manageExtendedEmailSecurityResell": true
            },
            "licensedServices": {
              "mdrServiceResell": false
            },
            "subscriptionType": 3
          }
        }
      },
      {
        "id": "6979cb003acd2ece290c72b",
        "name": "Partner B",
        "type": 1,
        "parentId": "6979cad9741a790bc5066175",
        "companyId": "6979cad9741a790bc5066172",
        "firstSeen": "2026-08-15T10:30:00",
        "isIsolated": false,
        "details": {
          "type": 0,
          "address": "",
          "phone": "",
          "industry": 202,
          "canBeManagedByAbove": true,
          "enforce2FA": true,
          "skip2FAPeriod": 7,
          "isSuspended": false,
          "createdAt": "2026-01-28T08:38:24",
          "country": "BQ",
          "state": "N/A",
          "duplicateClosedIncidentsOnUpdate": true,
          "licenseInfo": {
            "isAddon": false,
            "expiryDate": "2027-04-10T00:20:16",
            "usedSlots": 0,
            "reservedSlots": 0,
            "totalSlots": null,
            "manageExchange": false,
            "manageEncryption": false,
            "manageRemoteEnginesScanning": false,
            "manageHyperDetect": false,
            "manageSandboxAnalyzer": false,
            "managePatchManagement": false,
            "manageEventCorrelator": false,
            "manageEmailSecurity": false,
            "manageExtendedEmailSecurity": false,
            "manageMobileSecurity": false,
            "manageContainerProtection": false,
            "managePHASR": false,
            "manageEASM": false,
            "manageIntegrityMonitoring": false,
            "manageComplianceManager": false,
            "assignedProtectionModel": "aLaCarte",
            "additionalProtectionModels": [
              "aLaCarte"
            ],
            "assignedProductType": 0,
            "additionalProductTypes": [
              0
            ],
            "ownUse": {
              "manageXDRIdentityProviders": false,
              "manageXDRProductivityApps": false,
              "manageXDRNetwork": false,
              "manageXDRCloudWorkloads": false,
              "manageRemoteEnginesScanning": false,
              "manageContainerProtection": false,
              "manageHyperDetect": false,
              "manageSandboxAnalyzer": false,
              "manageEventCorrelator": false,
              "managePHASR": false,
              "manageEASM": false,
              "manageComplianceManager": false,
              "manageExtendedEmailSecurity": false,
              "manageAiSpm": true
            },
            "resell": {
              "manageXDRResell": false,
              "manageRemoteEnginesScanningResell": false,
              "manageContainerProtectionResell": false,
              "manageHyperDetectResell": false,
              "manageSandboxAnalyzerResell": false,
              "manageEventCorrelatorResell": false,
              "managePHASRResell": false,
              "manageEASMResell": false,
              "manageComplianceManagerResell": false,
              "manageExtendedEmailSecurityResell": false
            },
            "licensedServices": {
              "mdrServiceResell": false
            },
            "subscriptionType": 3
          }
        }
      },
      {
        "id": "6979cb23ff5ff8fa9f0294",
        "name": "Customer A",
        "type": 1,
        "parentId": "6979caeecc68e2d8440569f6",
        "companyId": "6979caeecc68e2d8440569f3",
        "firstSeen": "2026-08-15T10:30:00",
        "isIsolated": false,
        "details": {
          "type": 1,
          "address": "",
          "phone": "",
          "industry": 203,
          "canBeManagedByAbove": true,
          "enforce2FA": true,
          "skip2FAPeriod": 7,
          "isSuspended": false,
          "createdAt": "2026-01-28T08:38:59",
          "country": "AD",
          "state": "N/A",
          "duplicateClosedIncidentsOnUpdate": false,
          "licenseInfo": {
            "isAddon": false,
            "expiryDate": "2027-04-10T00:20:16",
            "usedSlots": 0,
            "totalSlots": null,
            "manageExchange": false,
            "manageEncryption": false,
            "manageRemoteEnginesScanning": false,
            "manageHyperDetect": false,
            "manageSandboxAnalyzer": false,
            "managePatchManagement": false,
            "manageEventCorrelator": true,
            "manageEmailSecurity": false,
            "manageExtendedEmailSecurity": true,
            "manageMobileSecurity": false,
            "manageContainerProtection": false,
            "managePHASR": false,
            "manageEASM": false,
            "manageIntegrityMonitoring": false,
            "manageComplianceManager": false,
            "assignedProtectionModel": "aLaCarte",
            "assignedProductType": 0,
            "additionalProductTypes": [],
            "ownUse": {
              "manageXDRIdentityProviders": false,
              "manageXDRProductivityApps": false,
              "manageXDRNetwork": false,
              "manageXDRCloudWorkloads": false,
              "manageRemoteEnginesScanning": false,
              "manageContainerProtection": false,
              "manageHyperDetect": false,
              "manageSandboxAnalyzer": false,
              "manageEventCorrelator": true,
              "managePHASR": false,
              "manageEASM": false,
              "manageComplianceManager": false,
              "manageExtendedEmailSecurity": true,
              "manageAiSpm": true
            },
            "licensedServices": {
              "mdrServiceFlavor": 1,
              "mdrServiceStatus": 1,
              "mdrStatusStartDate": "2025-12-04T11:27:46"
            },
            "subscriptionType": 3
          }
        }
      }
    ]
  }