跳至主内容

获取下载链接

该方法返回一个包含报告下载可用性及对应下载链接信息的对象。

即时报告仅生成一次，且可供下载的时间不超过24小时。

计划报告会定期生成，所有报告实例均保存在 GravityZone 数据库中。

参数

参数

类型

可选

描述

报告ID

字符串

否

报告的唯一标识符

返回值

该方法返回包含报告下载信息的对象，返回对象包含以下内容：

  • readyForDownload - 布尔值, True 表示报告已准备好下载，或 False 表示未准备好

  • lastInstanceUrl - 字符串, 用于下载即时或定时报告最新实例的URL。仅当 readyForDownload 为 True 时才会出现在响应中。下载结果是一个包含两个文件的压缩包：CSV和PDF文件，均指向该报告的同一最新实例。

    注意

    访问此URL需发送HTTP基本认证头（用户名:密码对），其中用户名为您的API密钥，密码为空字符串。详情请参阅 认证 章节。

  • allInstancesUrl - 字符串, 该URL用于下载包含定时报告所有生成实例的压缩包。仅当 readyForDownload 为 True 且报告为定时报告时，该字段才会出现在响应中。下载结果是一个压缩包，其中每个报告实例对应一对文件：CSV和PDF文件，均指向该报告的同一实例。

    注意

    访问此URL需发送HTTP基本认证头（用户名:密码对），其中用户名为您的API密钥，密码为空字符串。详情请参阅 认证 章节。

示例

请求 : 

{
       "params": {
           "reportId": "5638d7f8b1a43d49137b23c9"
       },
       "jsonrpc": "2.0",
       "method": "getDownloadLinks",
       "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87g"
  }

响应 : 

{
      "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
      "jsonrpc":"2.0",
      "result": {
          "readyForDownload": true,
          "allInstancesUrl":"https://gravityzone.bitdefender.com/api/v1.0/http/downloadReportZip?reportId=5645cba6f12a9a8c5e8b4748&allInstances=1&serviceType=1",
          "lastInstanceUrl":"https://gravityzone.bitdefender.com/api/v1.0/http/downloadReportZip?reportId=5645cba6f12a9a8c5e8b4748&allInstances=0&serviceType=1"
      }
  }

响应 : 

{
      "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
      "jsonrpc":"2.0",
      "result": {
          "readyForDownload": false
      }
  }

请求 : 

例如：使用curl下载报告：
   curl -f0 -u "您的API密钥："https://gravityzone.bitdefender.com/api/v1.0/http/downloadReportZip?reportId=5645cba6f12a9a8c5e8b4748&\allInstances=0&serviceType=1 > lastReportInstances.zip   

等效于：   

curl -f0 -H "Authorization: Basic API_KEY_ENCODED_BASE64" https://YOUR-HOSTNAME/api/v1.0/http/downloadReportZip?reportId=5645cba6f12a9a8c5e8b4748&\allInstances=0&serviceType=1 > lastReportInstances.zip   

其中API_KEY_ENCODED_BASE64是使用base64编码的API密钥。
本节内容 :