跳至主内容

获取下载链接

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

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

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

参数

参数

类型

可选

描述

reportId

字符串

否

报告ID

返回值

此方法返回一个包含报告下载信息的对象。返回的对象包含：

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

  • lastInstanceUrl - 字符串，用于下载即时报告或计划报告最新实例的URL。仅当 readyForDownload 为 True 时，响应中才会包含此URL。下载结果为包含两个文件的归档：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密钥的Base64编码" https://您的域名/api/v1.0/http/downloadReportZip?reportId=5645cba6f12a9a8c5e8b4748&\allInstances=0&serviceType=1 > lastReportInstances.zip   

其中API密钥的Base64编码需将您的API密钥进行Base64转换。
本节内容 :