getManagedEndpointDetails: удирдагдаж буй төгсгөлийн төхөөрөмжийн дэлгэрэнгүй

getManagedEndpointDetails method нь GravityZone-д удирдагдаж буй тодорхой нэг төгсгөлийн төхөөрөмжийн бүрэн мэдээллийг авна.

Service-үүд

Энэ method нь API URL-д {service} нэрийг оруулахыг шаардана. Зөвшөөрөгдсөн service-үүд:

• computers - "Computers and Virtual Machines" хувьд
• virtualmachines - "Virtual Machines" хувьд

Жишээ нь virtualmachines service-ийн хүсэлтийн URL:

https://YOUR-HOSTNAME/api/v1.0/jsonrpc/network/virtualmachines

Параметрүүд

Буцаах утга

Энэ method нь заасан төгсгөлийн төхөөрөмжийн мэдээллийг агуулсан Object буцаана:

• id - удирдагдаж буй төгсгөлийн төхөөрөмжийн ID
• name - төгсгөлийн төхөөрөмжийн нэр
• companyId - төгсгөлийн төхөөрөмж харьяалагдах компанийн ID
• operatingSystem - төгсгөлийн төхөөрөмжийн үйлдлийн систем
• state - машины тэжээлийн төлөв: 1 - online, 2 - offline, 3 - suspended, 0 - unknown.

Тайлбар

Дараах төлвүүд нь зөвхөн GravityZone-д тохируулсан идэвхтэй виртуалчлалын интеграцийн хэсэг болох төгсгөлийн төхөөрөмжид буцна:

• 2 - offline
• 3 - suspended

Үргэлжлэл:

• ip - төгсгөлийн төхөөрөмжийн IP хаяг
• lastSeen - Control Center-тэй хамгийн сүүлд синхрончилсон огноо
• isIsolated - төгсгөлийн төхөөрөмж одоогоор тусгаарлах (isolation) үйлдлээр сүлжээнээс тусгаарлагдсан эсэхийг заасан Boolean
• machineType - машины төрөл: 1 - computer, 2 - virtual machine, 3 - EC2 Instance, 0 - Other
• agent - төгсгөлийн төхөөрөмж дээр суулгасан agent-ийн талаарх дараах мэдээллийг агуулсан Object:
  • engineVersion, шалгалтын (scanning) хөдөлгүүрийн хувилбар
  • primaryEngine, хортой програм шалгахад хамгийн түрүүнд ашиглах хөдөлгүүр. Дараах утгын аль нэгийг авч болно:
    • 1 - Central Scanning (Security Server)
    • 2 - Hybrid Scanning (Light Engines)
    • 3 - Local Scanning (Full Engines)
    • 0 - Unknown
  • fallbackEngine, даалгавар илгээх үед үндсэн хөдөлгүүр боломжгүй байвал ашиглах хөдөлгүүр. Дараах утгын аль нэгийг авч болно:
    • 2 - Hybrid Scanning (Light Engines)
    • 3 - Local Scanning (Full Engines)
    • 0 - Unknown
  • lastUpdate, хамгийн сүүлийн signature шинэчлэлтийн цаг, огноо
  • licensed, лицензийн төлөв: 0 - pending authentication, 1 - active license, 2 - expired license, 6 - лицензгүй эсвэл хамааралгүй
  • productOutdated, agent-ийн хувилбар хамгийн сүүлийнх мөн эсэхийг заасан Boolean
  • productUpdateDisabled, бүтээгдэхүүний шинэчлэлт идэвхгүй болгосон эсэхийг заасан Boolean
  • productVersion, agent-ийн хувилбар
  • signatureOutdated, төгсгөлийн төхөөрөмжийн антималвэр signature-ууд хуучирсан эсэхийг заасан Boolean
  • signatureUpdateDisabled, антималвэр signature шинэчлэлт идэвхгүй болгосон эсэхийг заасан Boolean
  • type, төгсгөлийн төхөөрөмж дээр суулгасан agent-ийн төрлийг тодорхойлно:
    • 1 - Endpoint Security
    • 2 - Bitdefender Tools
    • 3 - BEST
• group - төгсгөлийн төхөөрөмж харьяалагдах бүлгийг заасан Object. Объект дараах талбаруудыг агуулна:
  • id, бүлгийн ID
  • name, бүлгийн нэр
• malwareStatus - төгсгөлийн төхөөрөмжийн хортой програмтай холбоотой төлөвийг мэдээлэх Object. Объект дараах талбартай:
  • detection, сүүлийн 24 цагт төгсгөлийн төхөөрөмж дээр хортой програм илэрсэн эсэхийг заасан Boolean,
  • infected, антималвэр халдварыг устгаж чадсан эсвэл төгсгөлийн төхөөрөмж халдвартай хэвээр байгааг мэдээлэх Boolean
• policy - төгсгөлийн төхөөрөмж дээрх идэвхтэй бодлогын талаарх Object. Объект дараахыг агуулна:
  • id, идэвхтэй бодлогын ID,
  • name, бодлогын нэр,
  • applied, бодлого одоогоор төгсгөлийн төхөөрөмж дээр хэрэгжиж байвал True болсон Boolean
• modules - суулгасан модулиуд болон тэдгээрийн төлөвийг мэдээлэх Object. Талбарууд Boolean утгатай: модуль идэвхтэй бол true, идэвхгүй бол false. Боломжит талбарууд:
  • advancedThreatControl
  • antimalware
  • contentControl
  • deviceControl
  • firewall
  • powerUser
  • encryption
  • edrSensor
  • hyperDetect
  • patchManagement
  • relay
  • sandboxAnalyzer
  • exchange
  • advancedAntiExploit
  • containerProtection
  • networkAttackDefense
• label - string, энэ төгсгөлийн төхөөрөмжид оноосон шошго (label)
• managedWithBest - төгсгөлийн төхөөрөмж дээр agent (BEST) суулгасан бол True болсон Boolean.
• isContainerHost - төгсгөлийн төхөөрөмж Container Host бол True болсон Boolean.
• managedExchangeServer - төгсгөлийн төхөөрөмж Exchange Server бол True болсон Boolean
• managedRelay - төгсгөлийн төхөөрөмж Relay үүрэгтэй бол True болсон Boolean
• securityServer - төгсгөлийн төхөөрөмж Security Server бол True болсон Boolean
• managedWithNsx - төгсгөлийн төхөөрөмж хамгаалагдсан VMware NSX дата төвд байвал True болсон Boolean
• managedWithVShield - төгсгөлийн төхөөрөмж хамгаалагдсан VMware vShield орчинд байвал True болсон Boolean

Жишээ

Хүсэлт:

{
  "params": {
    "endpointId": "54a28b41b1a43d89367b23fd"
  },
  "jsonrpc": "2.0",
  "method": "getManagedEndpointDetails",
  "id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b"
}

{
   "params": {
       "endpointId" : "54a28b41b1a43d89367b23fd",
           "options": {
           "includeScanLogs": true,
           "includeLastLoggedUsers": true
        }
   },
   "jsonrpc": "2.0",
   "method": "getManagedEndpointDetails",
   "id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b"
}

Хариу:

{
  "id": "0df7568c-59c1-48e0-a31b-18d83e6d9810",
  "jsonrpc": "2.0",
  "result": {
    "id": "54a28b41b1a43d89367b23fd",
    "name": "WIN-TGQDU499RS4",
    "companyId": "5575a235d2172c65038b454e",
    "operatingSystem": "Windows Server 2008 R2 Datacenter",
    "state": 1,
    "ip": "10.10.24.154",
    "lastSeen": "2026-08-22T13:46:59",
    "isIsolated": false,
    "machineType": 1,
    "agent": {
      "engineVersion": "7.61184",
      "primaryEngine": 1,
      "fallbackEngine": 2,
      "lastUpdate": "2015-06-22T13: 40: 06",
      "licensed": 1,
      "productOutdated": false,
      "productUpdateDisabled": false,
      "productVersion": "6.2.3.569",
      "signatureOutdated": false,
      "signatureUpdateDisabled": false,
      "type": 3
    },
    "group": {
      "id": "5575a235d2172c65038b456d",
      "name": "Custom Groups"
    },
    "malwareStatus": {
      "detection": false,
      "infected": false
    },
    "modules": {
      "advancedThreatControl": false,
      "antimalware": true,
      "contentControl": false,
      "deviceControl": false,
      "firewall": false,
      "powerUser": false,
      "networkAttackDefense": false
    },
    "policy": {
      "id": "5121da426803fa2d0e000017",
      "applied": true,
      "name": "Default policy"
    },
    "label": "endpoint label"
    }
  }
}