createScanTask: шалгалтын даалгавар үүсгэх
Энэ хуудсыг AI-аар орчуулж, автоматаар шалгасан. Нарийн тохиргоо хийхээсээ өмнө англи эхтэй тулгаж болно.
Энэ method нь шинэ шалгалтын (scan) даалгавар үүсгэнэ.
Тайлбар
virtualmachines service-ийн удирдагдаж буй төгсгөлийн төхөөрөмжүүд нь computers service-ийн Custom Group дор мөн харагддаг. Шалгалтын даалгаврыг давхардуулан эхлүүлэхээс зайлсхийхийн тулд computers service-ийн төгсгөлийн төхөөрөмжүүдийг ашиглахыг зөвлөж байна.
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
Параметрүүд
| Параметр | Төрөл | Заавал биш эсэх | Тайлбар |
|---|---|---|---|
| targetIds | Array | Үгүй | Шалгах зорилтот объектуудын ID-ийн жагсаалт. Зорилтот ID нь төгсгөлийн төхөөрөмж эсвэл контейнерийг заана. |
| 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 - permissive. array $scanPath - шалгах зорилтот замуудын жагсаалт. |
| returnTaskId (deprecated) | Boolean | Тийм | Анхааруулга: хүсэлтийн үр дүнд үүссэн бүх даалгаврын ID-г хариунд авахын тулд оронд нь returnAllTaskIds параметрийг ашиглахыг зөвлөж байна. Хүсэлтийн үр дүнд хамгийн сүүлд үүссэн даалгаврын ID-г буцаах эсэхийг заана. Боломжит утга: true - хүсэлт амжилттай бол хамгийн сүүлийн даалгаврын ID-г буцаана. false - хамгийн сүүлийн даалгаврын ID-г буцаахгүй, оронд нь Boolean утга буцаана. Өгөгдмөл утга: false. Тайлбар: returnTaskId болон returnAllTaskIds хоёулаа true бол зөвхөн returnAllTaskIds параметрийн хүссэн мэдээллийг буцаана. |
| returnAllTaskIds | Boolean | Тийм | Хүсэлтийн үр дүнд үүссэн бүх даалгаврын ID-г хариунд оруулах эсэхийг заана. Боломжит утга: true - хүсэлтийн үр дүнд үүссэн бүх даалгаврын ID-тай мөрүүдийн array буцаана. false - ямар ч даалгаврын ID буцаахгүй. Өгөгдмөл утга: false. |
Буцаах утга
Энэ method нь шинээр үүсгэсэн даалгаврын 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"
]
}Энэ хуудсанд гарсан нэр томъёо
- Network
- Таны байгууллагын бүх төхөөрөмжийн жагсаалт (Inventory)
