createScanTask — шалгалтын даалгавар үүсгэх

Энэ арга нь шинэ шалгалтын (scan) даалгавар үүсгэнэ.

Параметрүүд

• `targetIds` — Төрөл: Array; Заавал: Тийм; Шалгах зорилтуудын ID-ийн жагсаалт. Зорилтын ID нь endpoint эсвэл container байж болно.
• `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 танд хариунд ирэхийг баталгаажуулахын тулд оронд нь returnAllTaskIds параметрийг ашиглахыг зөвлөж байна. Хүсэлтийн үр дүнд үүссэн хамгийн сүүлийн даалгаврын ID-г буцаах эсэхийг заана. Боломжит утгууд:

- true — хүсэлт амжилттай бол хамгийн сүүлийн даалгаврын ID-г буцаана.
- false — хамгийн сүүлийн даалгаврын ID-г буцаахгүй; оронд нь Boolean утга буцаана.
- Анхдагч утга: false.
- Тэмдэглэл: returnTaskId болон returnAllTaskIds хоёулаа true бол зөвхөн returnAllTaskIds параметрээр хүссэн мэдээллийг буцаана.

• `returnAllTaskIds` — Төрөл: Boolean; Заавал биш; Хүсэлтийн үр дүнд үүссэн бүх даалгаврын ID хариунд орох эсэхийг заана. Боломжит утгууд:

- true — хүсэлтийн үр дүнд үүссэн бүх даалгаврын ID-уудын тэмдэгт мөрийн массивыг буцаана.
- false — даалгаврын ID буцаахгүй.
- Анхдагч утга: false.

Буцаах утга

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

Жишээ

Хүсэлт:

{
    "params": {
        "targetIds": [
            "63f491e5aeb92d393da4ee27", "642ed114edc94a4d0ea7be98"
        ],
        "type": 4,
        "name": "my scan",
        "customScanSettings": {
            "scanDepth": 1,
            "scanPath": [
                "LocalDrives"
            ]
        },
        "returnAllTaskIds":true
    },
    "jsonrpc": "2.0",
    "method": "createScanTask",
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f"
}

Хариу:

{
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
    "jsonrpc": "2.0",
    "result": [
        "64356e4590cbea5a7600ca1e",
        "64356e4590cbea5a7600ca21"
    ]
}