跳至主内容

获取软件包详情

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

警告

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

参数

参数

类型

可选

描述

软件包ID

字符串

否

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

返回值

此方法返回一个包含软件包信息的对象。响应对象包含：

  • packageName - 软件包名称。

  • description - 软件包描述。

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

  • modules - 表示软件包中模块的状态。该对象可能包含以下成员： antimalware , advancedThreatControl 和 atc , firewall , contentControl , userControl , antiphishing , trafficScan , deviceControl , 高级用户 , 容器保护 , 高级反漏洞利用 , 加密 , 补丁管理 , EDR传感器 , 网络攻击防御 , 完整性监控 。每个模块的值为 1 （启用）或 0 （禁用）。

    提示

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

  • 扫描模式 ——一个描述扫描模式设置并包含以下字段的对象：

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

    • 计算机 ，一个可能包含以下字段的对象： 主引擎 用于主扫描引擎， 备用引擎 用于备用扫描引擎。这些字段的值可以是 1 ——带安全服务器的集中式扫描， 2 ——混合扫描（轻量引擎）或 3 ——本地扫描（完整引擎）

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

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

    • 移除竞品

    • 自定义安装路径

    • 自定义组ID

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

    • 中继 可能取值如下： 1 表示启用， 0 表示禁用。

    • 交换 可能取值如下： 1 表示启用， 0 表示禁用。

  • 部署选项 - 包含安装选项的对象：

    • 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
     }
  }
本节内容 :