跳至主内容

获取软件包详情

此方法通过提供的ID获取特定软件包的配置信息。

警告

该 atc 模块已弃用，将在未来从API中移除。

参数

参数

类型

是否可选

描述

packageId

字符串

否

需要获取详情的软件包ID。

返回值

该方法返回一个包含软件包信息的对象。响应对象包含以下内容：

  • packageName - 软件包名称。

  • description - 软件包描述。

  • language - 软件包语言（格式为LL_CC，其中LL和CC为语言和国家国际代码）。

  • modules - 表示软件包中各模块的状态。该对象可能包含以下成员： antimalware , advancedThreatControl 和 atc , firewall , contentControl , userControl , 反钓鱼 , 流量扫描 , 设备控制 , 高级用户 , 容器保护 , 高级漏洞防御 , 加密 , 补丁管理 , 终端检测与响应传感器 , 网络攻击防护 , 完整性监控 。每个模块的值为 1 （启用）或 0 （禁用）。

    提示

    ： 内容控制 设置已弃用，将显示为 启用 若 用户控制 , 反钓鱼 及 流量扫描 均设置为 启用 状态，否则将显示为 禁用 .

  • 扫描模式 - 描述扫描模式设置的对象，包含以下字段：

    • 类型 ，可选值为 1 （自动模式）或 2 （自定义模式）

    • 计算机 ，该对象可能包含以下字段： 主引擎 用于主扫描引擎， 备用引擎 用于备用扫描引擎。这些字段的值可以是 1 - 通过安全服务器进行中央扫描， 2 - 混合扫描（轻量引擎）或 3 - 本地扫描（完整引擎）

    • vms ，一个包含可能字段的对象： main 表示主扫描引擎， fallback 表示备用扫描引擎。这些字段的值可以是 1 - 带安全服务器的中央扫描， 2 - 混合扫描（轻量引擎）或 3 - 本地扫描（完整引擎）

  • settings - 包含以下字段的包的其他设置对象：

    • removeCompetitors

    • customInstallationPath

    • customGroupId

  • roles - 包含启用/禁用角色的对象：

    • relay ，可能取值为： 1 表示启用， 0 表示禁用。

    • exchange ，可能取值为： 1 若启用则为 0 ，禁用则为

  • deploymentOptions ——包含安装选项的对象：

    • type ，整数，表示端点将连接到的实体。该实体将提供安装包和更新。可能值为： 1 表示从Bitdefender更新服务器常规部署； 2 表示通过中继服务器部署。

    • relayId ，字符串，表示启用了中继角色的端点ID。当 type 选项设置为 2 （即通过中继部署）时返回此字段。

    • useCommunicationProxy ，布尔值，指定端点是否使用代理进行网络通信。可能值为： True 表示使用通信代理， False 表示不使用。

    • proxyServer ，字符串，表示代理服务器的IP或域名。有效值为IPv4/IPv6格式的IP地址及RFC 1035定义的域名。当 useCommunicationProxy 设置为 True .

    • proxyPort ，一个表示允许访问代理服务器端口的整数。有效值介于 1 与 65535 之间。当 useCommunicationProxy 设置为 True .

    • proxyUsername ，表示代理服务器认证所需的用户名字符串。若代理服务器无需认证，可省略此选项。

  • productType ——指定的产品类型。该字段决定安全代理的运行模式。可能取值：

    • 0 ，表示检测与防护

    • 3 ，表示EDR（仅报告）

    • 5 ，表示PHASR独立版

示例

请求 : 

{
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
    "jsonrpc": "2.0",
    "method": "getPackageDetails",
    "params": {
         "packageId": "5a37b660b1a43d99117b23c6"
    }
  }

响应 : 

{
    "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
    "jsonrpc": "2.0",
    "result": {
       "packageName": "Package",
       "description": "package description",
       "language": "en_US",
       "modules": {
           "antimalware": 1,
           "advancedThreatControl": 1,
           "atc": 1,
           "firewall": 0,
           "userControl" 1,
           "antiphishing": 0,
           "trafficScan": 1,
           "deviceControl": 0,
           "powerUser": 0,
           "containerProtection": 0,
           
           "advancedAntiExploit": 0,
           "encryption": 0,
           "patchManagement": 0,
           "edrSensor": 0,"networkAttackDefense": 0,},
       "roles": {
              "relay": 1,
              "exchange": 0
       },
       "scanMode": {
          "type": 2,
          "computers": {
              "main": 1,
              "fallback": 2
          },
          "vms": {
              "main": 2
          }
       },
       "settings": {
          
          "removeCompetitors": true,
          "customInstallationPath": "c:\\mypath\\bitdefender",
          "customGroupId": "5a4dff50b1a43ded0a7b23c8",
          
       },
       "deploymentOptions": {
          "type": 1,
          "useCommunicationProxy": true,
          "proxyServer": "10.12.13.14",
          "proxyPort": 123,
          "proxyUsername": "user"
          
          
       },
       "productType": 0
     }
  }
本节内容 :