Deployment API - Download latest OneAgent

Downloads the latest OneAgent installer. You can check the latest version number with the GET the latest version of OneAgent call.

For the paas or paas-sh installer types, you can get a configuring installer by passing additional parameters.

GET

Managed https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/{osType}/{installerType}/latest
SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/deployment/installer/agent/{osType}/{installerType}/latest
Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/{osType}/{installerType}/latest

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. The element can hold these values windows unix aix solaris zos	path	required
installerType	string	The type of the installer: `default`: Self-extracting installer for manual installation. Downloads an `.exe` file for Windows or an `.sh` file for Unix. `default-unattended`: Self-extracting installer for unattended installation. Windows only. Downloads a `.zip` archive, containing the `.msi` installer and the batch file. This option is deprecated with OneAgent version 1.173 `paas`: Code modules installer. Downloads a `*.zip` archive, containing the `manifest.json` file with meta information or a `.jar` file for z/OS. `paas-sh`: Code modules installer. Downloads a self-extracting shell script with the embedded `tar.gz` archive. The element can hold these values default default-unattended paas paas-sh	path	required
flavor	string	The flavor of your Linux distribution: `musl` for Linux distributions, which are using the musl C standard library, for example Alpine Linux. 'multidistro` for all Linux distributions which are using musl C and glibc standard library. Only applicable to the `paas` and `paas-sh` installer types. The element can hold these values default multidistro musl	query	optional
arch	string	The architecture of your OS: `all`: Use this value for AIX and z/OS. Defaults to `x86` for other OS types. `x86`: x86 architecture. `ppc`: PowerPC architecture, only supported for AIX and Linux. `ppcle`: PowerPC Little Endian architecture, only supported for Linux. `sparc`: Sparc architecture, only supported for Solaris. `arm`: ARM architecture, only supported for Linux. `s390`: S/390 architecture, only supported for Linux. Only applicable to the `paas` and `paas-sh` installer types. The element can hold these values all arm ppc ppcle s390 sparc x86	query	optional
bitness	string	The bitness of your OS. Must be supported by the OS. Only applicable to the `paas` and `paas-sh` installer types. The element can hold these values 32 64 all	query	optional
include	array	The code modules to be included to the installer. You can specify several modules in the following format: `include=java&include=dotnet`. Only applicable to the `paas` and `paas-sh` installer types.	query	optional
skipMetadata	boolean	Set `true` to omit the OneAgent connectivity information from the installer. Only applicable to the `paas` and `paas-sh` installer types.	query	optional
networkZone	string	The network zone you want the result to be configured with.	query	optional

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.