Deployment API - View the checksum of a OneAgent installer

Gets the checksum of a OneAgent installer. The checksum is the SHA-256 hash of the installer file.

The request produces an application/json payload.

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

Authentication

To execute this request, you need an access token with `InstallerDownload` (PaaS integration - Installer download) 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
  • aix
  • solaris
  • zos
path
required
installerType
string

The type of the installer.

  • paas
path
required
version
string

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

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

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.

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

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

  • 32
  • 64
  • all
query
optional
include
string[]

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.

  • all
  • java
  • apache
  • nginx
  • nodejs
  • dotnet
  • php
  • go
  • sdk
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
Type
Description
200

Success. The payload contains the installer file.

304
-

Not modified. You already have the latest OneAgent installed.

Response body objects

The OneAgentInstallerChecksum object

The checksum of the OneAgent installer.

Element
Type
Description
sha256
string

The checksum of the OneAgent installer.

This is the sha256 hash of the installer file.

Response body JSON model

{
  "sha256": "string"
}