Deployment API - Download ActiveGate of specific version

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

The request downloads the ActiveGate installer of the version compatible with the provided OneAgent version. This version might be different from the specified OneAgent version.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/gateway/{osType}/version/{version}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/deployment/installer/gateway/{osType}/version/{version}

Authentication

To execute this request, you need the PaaS token (InstallerDownload) of your environment. To learn how to obtain and use it, see Access tokens.

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.

path required
version string

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

The request returns the ActiveGate installer of the version, compatible with the provided OneAgent version.

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

path required

Response

Response codes

Code Description
200

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.

Response payload

A successful request downloads the requested installer.