更新包

参数

参数名	类型	可选	描述
`packageId`	字符串	否	软件包的ID。
`packageName`	字符串	否	软件包名称。
`description`	字符串	是	软件包描述。若未传入值，则描述为空字符串。
`language`	字符串	是	软件包的语言（格式为LL_CC，其中LL表示语言，CC表示国家/地区）。支持的语言包括：en_US、es_ES、de_DE、fr_FR、ro_RO、pl_PL、pt_BR、it_IT、ru_RU。若未指定，默认值为 `en_US` .
`modules`	对象	是	包含待启用/禁用模块的对象。其键值可为： `advancedThreatControl` `firewall` `内容控制` 注意如果 `内容控制` 存在，其值将自动赋给 `用户控制` , `反钓鱼` 以及 `流量扫描` 。若尝试为这三个键中的任意一个分配不同值，将导致错误。提示该 `内容控制` 设置已弃用。建议改用 `用户控制` , `反钓鱼` 和 `流量扫描` 设置进行替代。 `用户控制` 注意若 `内容控制` 存在，分配给它的值也会同步赋给此键。 `反钓鱼` 注意若 `内容控制` 若存在，其赋值也将应用于此键。 `流量扫描` 注意若 `内容控制` 存在，其赋值也将应用于此键。 `设备控制` `高级用户` `EDR传感器` `高级反漏洞利用` `容器保护` `加密` `补丁管理` `网络攻击防护` `完整性监控` `PHASR` 可选值为1（启用）或0（禁用）。若未发送该模块参数，则默认为禁用状态。对于EDR（仅报告模式），模块参数必须采用默认配置：edrSensor、contentControl、networkAttackDefense和advancedThreatControl设为1（启用），其余模块设为0。对于检测与防护模式，所有模块默认值为0。对于独立版PHASR，仅 `PHASR` 参数在 `modules` 对象下设为 `1` （启用），其余模块均设为 `0` .
`扫描模式`	对象	是	包含扫描模式设置的对象。对象描述：可接受的键包括： `type` , `vms` , `computers` 以及 `ec2` （若已配置AWS集成）。 `type` 的值可为1（自动模式）或2（自定义模式）。若 `type` 值为2，则需传递 `computers` , `vms` 与 `ec2` 的键值对，否则系统将填充默认值。 `computers` , `vms` 及 `ec2` 的值为包含以下可能键的对象： `main` 和 `fallback` . 参数 `main` 的可取值为：1（中央扫描模式（安全服务器））、2（混合扫描模式（轻量引擎））或3（本地扫描模式（完整引擎））。参数 `fallback` 的可取值为：2（混合扫描模式（轻量引擎））或3（本地扫描模式（完整引擎））。若 `main` 参数值为2或3，则 `fallback` 的取值将被忽略。对于 `ec2` ， `main` 参数仅支持取值1（中央扫描模式（安全服务器））。若未传递此参数，则自动模式的取值将被保存。
`settings`	对象	是	包含安装包其他设置的对象。其取值可包括： `removeCompetitors` , `uninstallPassword` , `customInstallationPath` , `customGroupId` . 参数 `removeCompetitors` 可为1（启用）或0（禁用）。 `uninstallPassword` 应为字符串且需满足复杂度要求：密码长度至少6个字符，且必须包含至少一位数字、一个大写字母、一个小写字母及一个特殊字符； `customInstallationPath` 应为有效的Windows安装路径（仅适用于Windows操作系统）。 `customGroupId` 应为表示新终端应部署到的自定义群组实体ID的字符串。所有值均为可选。对于EDR（仅报告模式），settings参数必须采用默认配置：removeCompetitors设为0（禁用）。 `vmsCustomGroupId` 应为表示虚拟机视图中新终端应部署到的自定义群组实体ID的字符串。所有值均为可选。
`roles`	Object	是	包含待启用或禁用角色的对象： `relay` 可取值如下： `1` 表示启用中继角色， `0` 表示禁用。默认情况下中继角色为禁用状态。 `exchange` 可取值如下： `1` 表示启用Exchange角色， `0` 表示禁用。默认情况下Exchange角色为禁用状态。仅当公司许可证涵盖Security for Exchange安全服务时此角色可用。
`deploymentOptions`	Object	是	包含安装选项的对象： `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` ，表示用于代理服务器认证的用户名字符串。若代理服务器无需认证，可省略此选项。 `proxyPassword` ，表示用于代理服务器认证的密码字符串。若代理服务器无需认证，可省略此选项。
`productType`	数字	是	此参数决定安全代理的运行模式。可选值： `0` - 检测与防护模式（完整端点安全代理的默认模式）。 `3` - EDR（仅报告）模式（Bitdefender EDR代理的默认模式）。 `5` - Phasr独立模式（PHASR独立代理的默认模式）。更多信息请参阅参数说明 .

参数说明

Bitdefender EDR用户仅能创建EDR（仅报告）安装包；指定 productType 为可选操作。
GravityZone BS/ABS/Elite用户仅能创建检测与防护安装包；指定 productType 为可选参数。
GravityZone Ultra / Ultra Plus 用户可同时创建EDR（仅报告）与检测防护包； productType 必须明确指定才能创建EDR（仅报告）包。
EDR（仅报告）包默认包含一组预定义参数，这些参数将覆盖用户指定的选项。预定义参数包括：
- 模块
  - edrSensor-true
  - contentControl-true
  - networkAttackDefense-true
  - advancedThreatControl-true
  - 其他模块-false
- scanMode-不适用
- settings.removeCompetitors-false
- settings.scanBeforeInstall-false
- roles.exchange-false
PHASR独立包默认包含一组预定义参数，这些参数将覆盖用户指定的选项。预定义参数包括：
- 模块
  - phasr - true
- scanMode - 不适用
- settings.removeCompetitors - false
- settings.scanBeforeInstall - false
- roles.exchange - false
该 完整性监控 模块不适用于仅报告型EDR产品。

返回值

此方法返回一个布尔值， 若 软件包更新成功则为真。

示例

请求 :

{
     "params": {
       "packageId": "652feab6b9684f3ba80685d5"
       "packageName": "唯一名称",
       "companyId": "54a1a1d3b1a43d2b347b23c1",
       "description": "软件包描述",
       "language": "en_EN",
       "modules": {
           "advancedThreatControl": 1,
           "firewall": 0,
           "userControl": 1,
           "antiphishing": 1,
           "trafficScan": 1,
           "deviceControl": 0,
           "powerUser": 1,
           "edrSensor": 1,
           "advancedAntiExploit": 1,
           "containerProtection": 1,
           "encryption": 0,
           "patchManagement": 0,
           "networkAttackDefense": 1,
           "integrityMonitoring": 1
       },
       "scanMode": {
           "type": 2,
           "computers": {
               "main": 1,
               "fallback": 2
           },
           "vms": {
               "main": 2
           },
           "ec2": {
               "main": 1,
               "fallback": 2
           }
       },
       "settings": {
           "uninstallPassword": "mys3cre3tP@assword",
           "removeCompetitors": 1,
           "customInstallationPath": "c:\\mypath\\bitdefender",
           "customGroupId": "5a4dff50b1a43ded0a7b23c8"
       },
       "roles": {
           "relay": 0,
           "exchange":1
       },
       "deploymentOptions": {
           "type": 2,
           "relayId": "54a1a1s3b1a43e2b347s23c1",
           "useCommunicationProxy": true,
           "proxyServer": "10.12.13.14",
           "proxyPort": 123
       },
       "productType": 0
     },
     "jsonrpc": "2.0",
     "method": "updatePackage",
     "id": "426db9bb-e92a-4824-a21b-bba6b62d0a18"
  }

响应 :

{
     "id": "426db9bb-e92a-4824-a21b-bba6b62d0a18",
     "jsonrpc": "2.0",
     "result": true
  }

更新软件包

警告

参数

注意

提示

注意

注意

注意

参数说明

返回值

示例

搜索结果