跳至主内容

获取安装链接

此方法返回安装包的下载链接及完整安装套件。

警告

请确保您具备相应访问权限，且安装包已发布在 配置>更新>组件 页面的 控制中心 中。否则可能返回 400错误请求 或 404未找到 .

参数

参数

描述

请求包含

类型

取值

companyId

被管理公司的ID。

若请求中未包含该参数，将返回适用于所有被管理公司的安装链接。

可选

字符串

无额外要求。

packageName

软件包名称。

若请求中未包含该参数，将返回所有软件包。

可选

字符串

无额外要求。

ringId

当请求中包含此参数时，该方法将返回与特定分阶段发布环相关联的安装包。

可选

整数

无额外要求。

默认值： 0

可选值：

  • 0 - 慢速发布环

  • 3 - 生产发布环

  • 4 - 测试1发布环

  • 5 - 测试2发布环

返回值

该方法返回一个数组，包含请求包的安装链接列表，若未明确指定则返回所有可用包的链接。链接分为两种类型：

  • 安装链接 - 此类链接下载可执行文件，启动指定版本安全代理的下载安装流程。首先从Bitdefender云服务器下载完整安装包，随后开始安装。

  • 完整安装包 - 此类链接直接下载指定版本安全代理的完整安装包。

安装方式

文件大小

Windows兼容性

Linux兼容性

Mac兼容性

安装链接

较小

32位、64位、ARM

32位、64位

64位

完整安装包

较大

32位、64位、ARM

32位、64位、ARM

64位、ARM

列表中每个条目包含以下字段：

属性

类型

描述

packageName

字符串

需要获取安装链接及安装包的软件包名称。

installLinkWindows

字符串

Windows下载器的链接。

installLinkMac

字符串

Mac下载器的链接。

installLinkMacArm

字符串

Mac（ARM）下载器的链接。

installLinkLinux

字符串

Linux下载器的链接。

fullKitWindowsX32

字符串

Windows 32位操作系统完整安装包的链接。

fullKitWindowsX64

字符串

Windows 64位操作系统完整安装包的链接。

fullKitWindowsArm64

字符串

Windows ARM 64位操作系统完整安装包的链接。

fullKitLinuxX32

字符串

Linux 32位操作系统完整安装包的链接。

fullKitLinuxX64

字符串

Linux 64位操作系统完整安装包的链接。

fullKitLinuxArm64

字符串

Linux ARM 64位操作系统完整安装包的链接。

installLinkMacDownloader

字符串

Mac操作系统完整安装包的链接。

installLinkMacArm

String

Mac ARM操作系统完整安装套件的下载链接。

status

Object

一个包含支持的操作系统及显示您 GravityZone 环境中以下操作系统套件可用性的对象：

  • windows

  • windowsArm64

  • linux

  • linuxArm64

  • mac

  • macArm

可能的状态值：

  • 0 - 未下载

  • 1 - 下载中

  • 2 - 就绪

示例

请求

获取特定安装包的安装链接： 

{
     "params": {
       
       "packageName": "我的包"
   },
     "jsonrpc": "2.0",
     "method": "getInstallationLinks",
     "id": "426db9bb-e92a-4824-a21b-bba6b62d0a18"
  }

获取与特定分级环关联的安装包链接： 

{
	"method": "getInstallationLinks",
	"id": "736b0b48-63be-4b53-818e-b37df9b02e90",
	"jsonrpc": "2.0",
	"params": {
        "ringId":3
	}
}

响应 

{
   "packageName":"PackagesAPI1695306052.633011oWYMHbCBM1",
   "installLinkWindows":"https://10.18.148.224/Packages/BSTWIN/0/setupdownloader_[aHR0cHM6Ly8xMC4xOC4xNDguMjI0Ojg0NDMvUGFja2FnZXMvQlNUV0lOLzAvaUpuSF9fL2luc3RhbGxlci54bWw-bGFuZz1lbi1VUw==].exe",
   "installLinkMac":"https://10.18.148.224/Packages/MAC/0/iJnH__/Bitdefender_for_MAC.dmg",
   "installLinkMacArm":"https://10.18.148.224/Packages/MAC/0/iJnH__/Bitdefender_for_MAC_ARM.dmg",
   "installLinkMacDownloader":"https://10.18.148.224/Packages/MAC/0/iJnH__/setup_downloader.dmg",
   "installLinkLinux":"https://10.18.148.224/Packages/NIX/0/iJnH__/setup_downloader.tar",
   "fullKitWindowsX32":"https://10.18.148.224/api/v1.0/http/downloadPackageFullKit?packageId=650c5145a024a1001303b99d&downloadType=19",
   "fullKitWindowsX64":"https://10.18.148.224/api/v1.0/http/downloadPackageFullKit?packageId=650c5145a024a1001303b99d&downloadType=20",
   "fullKitWindowsArm64":"https://10.18.148.224/api/v1.0/http/downloadPackageFullKit?packageId=650c5145a024a1001303b99d&downloadType=35",
   "fullKitLinuxX32":"https://10.18.148.224/api/v1.0/http/downloadPackageFullKit?packageId=650c5145a024a1001303b99d&downloadType=21",
   "fullKitLinuxX64":"https://10.18.148.224/api/v1.0/http/downloadPackageFullKit?packageId=650c5145a024a1001303b99d&downloadType=22",
   "fullKitLinuxArm64":"https://10.18.148.224/api/v1.0/http/downloadPackageFullKit?packageId=650c5145a024a1001303b99d&downloadType=36",
   "status":{
      "windows":2,
      "windowsArm64":0,
      "linux":0,
      "mac":0,
      "macArm":0,
      "macDownloader":0
   }
}

注意

<gz_ip>是GravityZone控制中心管理控制台的IP地址。

您可以使用以下任一提供的URL地址下载安装包：

  • 如果您使用的是GZVA自签名证书。 

    curl -fOJ -H "YOUR_API_KEY:" https://gravityzone.bitdefender.com/api/v1.0/http/downloadPackageFullKit?packageId=5645cba6f12a9a8c5e8b4748&downloadType=20

  • 如果您未使用GZVA自签名证书。 

    curl -fOJ -H "Authorization: Basic ENCODED_API_KEY" https://gravityzone.bitdefender.com/api/v1.0/http/downloadPackageFullKit?packageId=5f1ecde1be4be6142c3e9b32&downloadType=20

注意

API_KEY_ENCODED_BASE64 是您使用base64编码的API密钥。

要获取您的 ENCODED_API_KEY ，请使用以下命令： 

echo "YOUR_API_KEY:" | base64
本节内容 :