跳至主内容

createRestoreQuarantineItemTask

此方法用于创建从隔离区恢复项目的新任务。

重要提示

本文主要章节包含该方法1.1版本的信息。1.0版本信息可查阅 此处 .

服务

使用此方法需在API URL中填入 {服务} 名称。允许的服务包括:

  • computers (对应"计算机与虚拟机")

例如,请求URL用于 computers 服务的格式为:

https://YOUR-HOSTNAME/api/v1.0/jsonrpc/quarantine/computers

参数

参数名

类型

可选

描述

quarantineItemsIds

数组

待恢复隔离项ID列表。单次最多可恢复100项。

locationToRestore

字符串

文件恢复的目标文件夹绝对路径。若未设置,则使用原始路径。

addExclusionInPolicy

布尔值

将待恢复文件从后续扫描中排除。此排除不适用于已分配 默认策略 的项目。该参数默认值为 False .

返回值

本方法返回所创建任务的父任务ID数组。

示例

请求 :

{
       "params": {
           "quarantineItemsIds": [
               "63896b87b7894d0f367b23c6",
               "65896b87b7894d0f367b23c6"
           ],
           "locationToRestore": "C:\RestoreDirectory"
           "addExclusionInPolicy": true
       },
       "jsonrpc": "2.0",
       "method": "createRestoreQuarantineItemTask",
       "id": "5399c9b5-0b46-45e4-81aa-889952433d86"
  }

响应 :

{
      "id": "5399c9b5-0b46-45e4-81aa-889952433d86",
      "jsonrpc":"2.0",
      "result": [
          "652feab6b9684f3ba80685d5",
          "652feab6b9684f3ba80685d5"
      ]
}

版本 1.0

参数

参数

类型

可选

描述

quarantineItemsIds

数组

隔离项目的ID列表。单次最多可恢复100个项目。

locationToRestore

字符串

项目将被恢复到的文件夹的绝对路径。如果未设置此参数,将使用原始位置。

addExclusionInPolicy

布尔值

将要恢复的文件排除在未来的扫描之外。排除不适用于已分配 默认策略 的项目。此参数的默认值为 False .

返回值

此方法返回一个布尔值,当任务成功创建时为True。

示例

请求 :

{
       "params": {
           "quarantineItemsIds": [
               "63896b87b7894d0f367b23c6",
               "65896b87b7894d0f367b23c6"
           ],
           "locationToRestore": "C:\恢复目录"
           "addExclusionInPolicy": true
       },
       "jsonrpc": "2.0",
       "method": "createRestoreQuarantineItemTask",
       "id": "5399c9b5-0b46-45e4-81aa-889952433d86"
  }

响应 :

{
      "id": "5399c9b5-0b46-45e4-81aa-889952433d86",
      "jsonrpc":"2.0",
      "result": true
  }