跳至主内容

createRestoreQuarantineExchangeItemTask

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

重要提示

此方法已更新至1.1版本。适用于1.0版本的信息请参阅 本节 .

服务

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

  • exchange (对应"Exchange安全防护")

例如, exchange 服务的请求URL为:

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

参数

参数名

类型

可选性

描述

quarantineItemsIds

数组

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

username

字符串

Microsoft Exchange用户的用户名,必须包含域名。

password

字符串

Exchange用户的密码

email

字符串

Exchange用户的电子邮件地址。当邮箱地址与用户名不同时需提供此参数。

ewsUrl

字符串

Exchange Web Services URL。当Exchange自动发现功能失效时需提供此URL。

返回值

Exchange用户的密码。必填项,类型为字符串。

示例

请求 :

{
       "params": {
           "quarantineItemsIds": [
               "63896b87b7894d0f367b23c6",
               "65896b87b7894d0f367b23c6"
           ],
           "username": "user@domain",
           "password": "userPassword"
       },
       "jsonrpc": "2.0",
       "method": "createRestoreQuarantineExchangeItemTask",
       "id": "5399c9b5-0b46-45e4-81aa-889952433d86"
  }

响应 :

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

版本1.0

参数

参数

类型

可选

描述

quarantineItemsIds

数组

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

username

字符串

Microsoft Exchange用户的用户名。用户名必须包含域名。

password

字符串

Exchange用户的密码

email

字符串

Exchange用户的电子邮件地址。当电子邮件地址与用户名不同时,此参数为必填项。

ewsUrl

字符串

Exchange Web Services URL。当Exchange自动发现功能失效时,必须提供EWS URL。

返回值

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

示例

请求 :

{
       "params": {
           "quarantineItemsIds": [
               "63896b87b7894d0f367b23c6",
               "65896b87b7894d0f367b23c6"
           ],
           "username": "user@domain",
           "password": "userPassword"
       },
       "jsonrpc": "2.0",
       "method": "createRestoreQuarantineExchangeItemTask",
       "id": "5399c9b5-0b46-45e4-81aa-889952433d86"
  }

响应 :

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