跳至主内容

获取报告列表

此方法根据接收参数返回计划报告列表。

仅显示由 GravityZone 生成请求所用API密钥的用户创建的报告。

参数

参数

类型

可选

描述

名称

字符串

报告的名称。

类型

数字

报告类型。可用类型包括:

  • 1 - 反钓鱼活动

  • 2 - 被阻止的应用程序

  • 3 - 被阻止的网站

  • 4 - 客户状态概览

  • 5 - 数据保护

  • 6 - 设备控制活动

  • 7 - 终端模块状态

  • 8 - 终端防护状态

  • 9 - 防火墙活动

  • 10 - 许可证状态

  • 12 - 恶意软件状态

  • 13 - 月度许可证使用情况

  • 14 - 网络状态

  • 15 - 按需扫描

  • 16 - 策略合规性

  • 17 - 安全审计

  • 18 - 安全服务器状态

  • 19 - 检测到的十大恶意软件

  • 20 - 感染最严重的十家企业

  • 21 - 感染最严重的十个终端

  • 22 - 更新状态

  • 23 - 升级状态

  • 24 - AWS月度使用量

  • 29 - 电子邮件安全使用情况

  • 30 - 终端加密状态

  • 31 - HyperDetect检测活动

  • 32 - 网络补丁状态

  • 33 - 沙盒分析器提交失败记录

  • 34 - 网络事件

  • 35 - MDR服务状态

  • 36 - 完整性监控活动

  • 37 - 完整性监控配置变更

  • 38 - 移动安全月度许可证使用情况

页码

数字

结果页编号。默认页码为 1 .

每页条数

数字

单页显示的项目数量。上限为每页100项。默认值:每页30项。

返回值

该方法返回包含报告信息的对象。返回对象包含:

  • 页码 - 当前显示的页码

  • pagesCount - 可用总页数

  • perPage - 每页返回的项目总数

  • items - 报告列表。列表中每个条目包含以下字段:

    • ID ,报告的ID

    • name ,报告名称

    • type ,报告类型(如参数表所述)

    • occurrence ,报告运行的时间间隔。可能值为:2-每小时,3-每天,4-每周或5-每月。请注意值1(即时报告)不属于有效选项。

  • total - 项目总数

示例

请求 :

{
       "params": {
           "type": 2,
           "page": 2,
           "perPage": 4
       },
       "jsonrpc": "2.0",
       "method": "getReportsList",
       "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f"
  }

响应 :

{
      "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
      "jsonrpc":"2.0",
      "result": {
           "page": 2,
           "pagesCount": 11,
           "perPage": 5,
           "total": 54
           "items": [
               {
                   'id': '5638cdceb1a43d46137b23c6',
                   'name': '我的报告1',
                   'occurrence': 2,
                   'type': 2
               },
               {
                   'id': '5638d7f8b1a43d49137b23c9',
                   'name': '我的报告2',
                   'occurrence': 4,
                   'type': 2
               },
               {
                   'id': u'563b271bb1a43d21077b23c8',
                   'name': '我的报告3',
                   'occurrence': 4,
                   'type': 2
               },
               {
                   'id': '563a289eb1a43d2f617b23c6',
                   'name': '我的报告4',
                   'occurrence': 2,
                   'type': 2
               }
           ]
      }
  }