Deployment API - Download ActiveGate of specific version

Downloads the ActiveGate installer of the specified version. You can fetch the list of available ActiveGate versions with the GET available versions of ActiveGate call.

GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v1/deployment/installer/gateway/{osType}/version/{version}
Environment ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v1/deployment/installer/gateway/{osType}/version/{version}

Authentication

To execute this request, you need an access token with InstallerDownload scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter
Type
Description
In
Required
If-None-Match
string

The ETag of the previous request. Do not download if it matches the ETag of the installer.

header
optional
osType
string

The operating system of the installer.

  • windows
  • unix
path
required
version
string

The required version of the ActiveGate installer, in 1.155.275.20181112-084458 format.

You can retrieve the list of available versions with the GET available versions of ActiveGate call.

path
required
networkZone
string

The network zone you want the result to be configured with. Provided network zone must exist, otherwise the request will fail. Requires at least ActiveGate version 1.247.

query
optional
arch
string

The architecture of your OS:

  • all: Defaults to amd64.
  • amd64: amd64 architecture.
  • s390: S/390 architecture, only supported for Linux.
  • arm64: arm64 architecture, only supported for Linux.
  • all
  • amd64
  • arm64
  • s390
query
optional

Response

Response codes

Code
Type
Description
200
string

Success. The payload contains the installer file.

304
-

Not modified. You already have the latest version of the installer. The response does not contain a payload.

4XX

Client side error.

5XX

Server side error.

Response body objects

The ResponseBody object