createScanTaskByMac — MAC хаягаар шалгалтын даалгавар үүсгэх

Энэ аргыг MAC хаягаар нь тодорхойлсон, удирдлагад буй endpoint-уудад шалгалтын (scan) даалгавар үүсгэхэд ашиглана.

Параметрүүд

• macAddresses — Төрөл: Array; Заавал: Тийм; Шалгах endpoint-уудын MAC хаягийн жагсаалт. Нэг дор хамгийн ихдээ 100 MAC хаяг зааж болно.
• type — Төрөл: Number; Заавал: Тийм; Шалгалтын төрөл. Боломжит сонголтууд: 1 - quick scan; 2 - full scan; 3 - memory scan; 4 - custom scan
• name — Төрөл: String; Заавал биш; Даалгаврын нэр. Параметрийг дамжуулаагүй бол нэр автоматаар үүснэ.
• customScanSettings — Төрөл: Array; Заавал: Тийм; Шалгалтын гүн, шалгах зам(ууд) зэрэг мэдээллийг агуулсан объект. Энэ объектийг зөвхөн type параметр 4 - Custom scan утгатай үед тохируулна. Бусад төрөлд тохируулсан утгыг үл тооно. $customScanSettings параметр дараах шинж чанаруудыг агуулах ёстой:int $scanDepth Шалгалтын профайл. Боломжит сонголтууд: 1 - aggressive; 2 - normal; 3 - permissivearray $scanPath Шалгах зорилтот замуудын жагсаалт
• `returnTaskId` — Төрөл: Boolean; Заавал биш; Хүсэлт шинэ даалгаврын ID-г буцаах эсэхийг заана. Боломжит утгууд:

- true — хүсэлт амжилттай бол шинээр үүссэн даалгаврын ID-г буцаана.
- false — шинээр үүссэн даалгаврын ID-г буцаахгүй; оронд нь Boolean утга буцаана.
- Анхдагч утга: False.

Буцаах утга

Энэ арга нь шинээр үүссэн даалгаврын ID-г эсвэл даалгавар амжилттай үүссэн бол true гэсэн Boolean утгыг буцаана.

Жишээ

Хүсэлт:

  {
       "params": {
           "macAddresses": [
               "1c67da49e1a1",
               "8c67f849e1a8"
           ],
           "type": 4,
           "name": "my scan",
           "customScanSettings": {
               "scanDepth": 1,
               "scanPath": [
                   "LocalDrives"
               ]
           },
           "returnTaskId":true
       },
       "jsonrpc": "2.0",
       "method": "createScanTaskByMac",
       "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f"
  }

Хариу:

  {
      "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
      "jsonrpc":"2.0",
      "result": 6372b7a3897aaa77ee021642
  }