getManagedEndpointDetails

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

Параметрүүд

• endpointId (String, хүсэлтэд заавал) — дэлгэрэнгүй мэдээллийг нь буцаах төгсгөлийн төхөөрөмжийн ID. Удирдлагад байгаа (managed) төгсгөлийн төхөөрөмжийн хүчинтэй ID байх ёстой.

> Зөвлөгөө: getEndpointsList аргад isManaged параметрийг true болгож өгвөл удирдлагад байгаа төгсгөлийн төхөөрөмжүүдийн жагсаалтыг авч болно.

Жишээ: "endpointId" : "54a28b41b1a43d89367b23fd"

• options (Object, заавал биш) — хариуд ямар мэдээлэл багтахыг тохируулах сонголтууд. Дэлгэрэнгүйг доорх options хэсгээс үзнэ үү. Жишээ: "options": { "includeScanLogs": true, "includeLastLoggedUsers": true }

Объектууд

options

options параметрээр API-ийн хариуд ямар мэдээлэл багтахыг тохируулна. Сонголтууд дараах байдалтай:

• includeScanLogs — Boolean. true бол хариунд lastSuccessfulScan атрибут орно. Үндсэн утга: false.
• includeLastLoggedUsers — Boolean. true бол хүсэлт илгээх үед төгсгөлийн төхөөрөмж дээр идэвхтэй байгаа хэрэглэгчдийн жагсаалт орно. Үндсэн утга: false.

Буцаах утга

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

• id - удирдлагад байгаа төгсгөлийн төхөөрөмжийн ID

• name - төгсгөлийн төхөөрөмжийн нэр

• companyId - төгсгөлийн төхөөрөмж харьяалагдах компанийн ID

• operatingSystem - төгсгөлийн төхөөрөмжийн үйлдлийн систем

• state - машины цахилгааны төлөв: 1 - онлайн, 2 - офлайн, 3 - түр зогссон (suspended), 0 - үл мэдэгдэх.

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

• ip - төгсгөлийн төхөөрөмжийн IP хаяг

• firstSeen - төгсгөлийн төхөөрөмж GravityZone-д анх бүртгэгдсэн эсвэл илэрсэн цаг

• lastSeen - Control Center-тэй хамгийн сүүлд синк хийсэн огноо

• isIsolated - Boolean, төгсгөлийн төхөөрөмж одоогоор тусгаарлах (isolation) үйлдлээр сүлжээнээс тусгаарлагдсан эсэх

• machineType - машины төрөл: 1 - компьютер, 2 - виртуал машин, 3 - EC2 Instance, 0 - бусад

• agent - төгсгөлийн төхөөрөмж дээр суулгасан агентын талаарх дараах мэдээллийг агуулсан Object:

- engineVersion, шалгалтын хөдөлгүүрийн (engine) хувилбар

- primaryEngine, хортой программ шалгахад хамгийн түрүүнд ашиглах хөдөлгүүр. Дараах утгын нэг байж болно:

- 1 - Central Scanning (Security Server)
- 2 - Hybrid Scanning (Light Engines)
- 3 - Local Scanning (Full Engines)
- 0 - үл мэдэгдэх

- fallbackEngine, даалгавар илгээх үед үндсэн хөдөлгүүр ашиглах боломжгүй бол ашиглах нөөц хөдөлгүүр. Дараах утгын нэг байж болно:

- 2 - Hybrid Scanning (Light Engines)
- 3 - Local Scanning (Full Engines)
- 0 - үл мэдэгдэх

- lastUpdate, сүүлийн удаа сигнатур шинэчилсэн цаг, огноо

- licensed, лицензийн төлөв: 0 - баталгаажуулалт хүлээгдэж байна, 1 - идэвхтэй лиценз, 2 - хугацаа дууссан лиценз, 6 - лиценз байхгүй эсвэл хамааралгүй

- productOutdated, Boolean, агентын хувилбар хамгийн сүүлийнх мөн эсэх

- productUpdateDisabled, Boolean, бүтээгдэхүүний шинэчлэлт идэвхгүй болгосон эсэх

- productVersion, агентын хувилбар

- signatureOutdated, Boolean, төгсгөлийн төхөөрөмжийн хортой программын эсрэг сигнатур хоцрогдсон эсэх

- signatureUpdateDisabled, Boolean, хортой программын эсрэг сигнатурын шинэчлэлт идэвхгүй болгосон эсэх

- type, төгсгөлийн төхөөрөмж дээр ямар төрлийн агент суулгасныг заана:

- 1 - Endpoint Security
- 2 - Bitdefender Tools
- 3 - BEST

• group - төгсгөлийн төхөөрөмж харьяалагдах бүлгийг заасан Object. Дараах талбаруудтай:

- id, бүлгийн ID
- name, бүлгийн нэр

• malwareStatus - төгсгөлийн төхөөрөмжийн хортой программтай холбоотой төлвийг заасан Object. Дараах талбаруудтай:

- detection, Boolean, сүүлийн 24 цагт төгсгөлийн төхөөрөмж дээр хортой программ илэрсэн эсэх,
- infected, Boolean, хортой программын эсрэг модуль халдварыг арилгаж чадсан уу, эсвэл төгсгөлийн төхөөрөмж халдвартай хэвээр байна уу

• policy - төгсгөлийн төхөөрөмж дээрх идэвхтэй бодлогыг (policy) заасан Object. Дараахыг агуулна:

- id, идэвхтэй бодлогын ID,
- name, бодлогын нэр,
- applied, Boolean, бодлого одоогоор төгсгөлийн төхөөрөмж дээр хэрэгжиж байвал True

• modules - суулгасан модулиуд болон тэдгээрийн төлвийг заасан Object. Талбарууд Boolean утгатай: true - модуль идэвхтэй, false - модуль идэвхгүй. Боломжит талбарууд:

- advancedThreatControl
- antimalware
- contentControl
- deviceControl
- firewall
- powerUser
- encryption
- edrSensor
- hyperDetect
- patchManagement
- relay
- sandboxAnalyzer
- exchange
- advancedAntiExploit
- containerProtection
- networkAttackDefense
- integrityMonitoring

• label - string, энэ төгсгөлийн төхөөрөмжид оноосон шошго

• moveState - төгсгөлийн төхөөрөмжийн зөөлтийн төлвийг заасан бүхэл тоо: 0 - зөөх үйлдэл байхгүй, 1 - компаниас гадагш зөөгдсөн, 2 - миний компани руу зөөгдсөн.

• managedWithBest - Boolean, төгсгөлийн төхөөрөмж дээр агент (BEST) суулгасан бол True.

• isContainerHost - Boolean, төгсгөлийн төхөөрөмж Container Host бол True.

• managedExchangeServer - Boolean, төгсгөлийн төхөөрөмж Exchange Server бол True

• managedRelay - Boolean, төгсгөлийн төхөөрөмж Relay үүрэгтэй бол True

• securityServer - Boolean, төгсгөлийн төхөөрөмж Security Server бол True

• riskScore - төгсгөлийн төхөөрөмжийн аюулгүй байдлын эрсдэлийн талаарх дараах мэдээллийг агуулсан Object:

- value, төгсгөлийн төхөөрөмжийн аюулгүй байдлын эрсдэлийн оноо хувиар. Үүнийг буруу тохиргоо болон аппын эмзэг байдалд задалж харуулдаг
- impact, төгсгөлийн төхөөрөмжийн аюулгүй байдлын эрсдэлийн нөлөө (Low, Medium, High)
- misconfigurations, эрсдэлийн оноонд буруу тохиргооны эзлэх хувь
- appVulnerabilities, эрсдэлийн оноонд аппын эмзэг байдлын эзлэх хувь
- humanRisks, эрсдэлийн оноонд хүний хүчин зүйлийн эрсдэлийн эзлэх хувь

• lastSuccessfulScan, object. Дараах мэдээллийг агуулна:

- name - шалгалтын нэр.
- date - шалгалт хийсэн огноо.

• lastLoggedUsers, тэмдэгт мөрийн массив, төгсгөлийн төхөөрөмж дээр одоо нэвтэрсэн хэрэглэгчдийн жагсаалт.

Жишээ

Хүсэлт:

{
  "params": {
    "endpointId": "54a28b41b1a43d89367b23fd",
    "options": {
      "includeScanLogs": true
    }
  },
  "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",
    "firstSeen": "2026-08-15T10:30:00",
    "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,
      "integrityMonitoring": false
    },
    "policy": {
      "id": "5121da426803fa2d0e000017",
      "applied": true,
      "name": "Default policy"
    },
    "label": "endpoint label",
    "moveState": 1,
    "riskScore": {
      "value": "81%",
      "impact": "High",
      "misconfigurations": "70%",
      "appVulnerabilities": "11%",
      "humanRisks": "19%"
    },
    "lastSuccessfulScan": {
      "name": "72OHI5dnIH",
      "date": "2023-07-19T04:09:29+00:00"
    },
    "lastLoggedUsers": [
      "Admin@serverpan.local",
      "cont@serverpan.local"
    ]
  }
}