Deployment API - GET available versions of OneAgent

Lists all available versions of OneAgent installer.

The request produces an application/json payload.

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

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
osType string

The operating system of the installer.

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.
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.

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.

query optional

Response

Response codes

Code Description
200

Success. The payload contains the available versions.

Response body

The AgentInstallerVersions object

A list of available versions of OneAgent installer.

Element Type Description
availableVersions string[]

A list of available versions of OneAgent installer.