跳至主内容

按MAC地址创建扫描任务

使用此方法为通过MAC地址识别的受控终端生成扫描任务。

参数

参数

类型

可选

描述

macAddresses

数组

否

待扫描端点的MAC地址列表。单次最多可指定100个MAC地址。

type

数值

否

扫描类型。可选选项： 1 - 快速扫描； 2 - 全面扫描； 3 - 内存扫描； 4 - 自定义扫描

name

字符串

是

任务名称。若未传递该参数，名称将自动生成。

customScanSettings

数组

否

包含扫描深度、扫描路径等信息的对象。仅当 type 参数值为 4 - 自定义扫描时需设置此对象。其他类型下设置的值将被忽略。参数$customScanSettings必须包含以下属性：int $scanDepth 扫描配置文件。可选选项： 1 - 激进模式； 2 - 常规； 3 - 宽松模式array $scanPath 待扫描的目标路径列表

returnTaskId

布尔值

是

指示请求是否返回新任务的ID。可选值：

  • true ，请求成功时将返回新创建任务的ID。

  • false ，不会返回新创建任务的ID，而是返回一个布尔值。

默认值： False .

返回值

本方法返回新创建任务的ID或一个布尔值，若任务创建成功则返回 true 。

示例

请求 : 

{
       "params": {
           "macAddresses": [
               "1c67da49e1a1",
               "8c67f849e1a8"
           ],
           "type": 4,
           "name": "我的扫描",
           "customScanSettings": {
               "scanDepth": 1,
               "scanPath": [ 
                   "本地驱动器"
               ]
           },
           "returnTaskId":true
       },
       "jsonrpc": "2.0",
       "method": "createScanTaskByMac",
       "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f"
  }

响应 : 

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