Deployment API - View the checksum of a OneAgent installer

Reference
Published Aug 28, 2019

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.

GET	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v1/deployment/installer/agent/{osType}/{installerType}/version/{version}/checksum`
GET	Environment ActiveGate	`https://{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 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. The element can hold these values `windows` `unix` `aix` `solaris` `zos`	path	Required
installerType	string	The type of the installer. The element can hold these values `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 Linux distributions, which are using musl C and glibc standard library. `default` for Linux distributions, which are using 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. `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	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. The element can hold these values `all` `java` `java-graal-native` `apache` `nginx` `nodejs` `dotnet` `php` `go` `sdk` `envoy` `python`	query	Optional
networkZone	string	The network zone you want the result to be configured with.	query	Optional

Response

Response codes

Code	Type	Description
200	OneAgentInstallerChecksum	Success. The payload contains the installer file.
304	-	Not modified. You already have the latest OneAgent installed.
4XX	ErrorEnvelope	Client side error.
5XX	ErrorEnvelope	Server side error.

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.

Element

Type

Description

sha256

string

The checksum of the OneAgent installer.

This is the sha256 hash of the installer file.

The `ErrorEnvelope` object

Element	Type	Description
error	Error	-

The `Error` object

Element	Type	Description
code	integer	The HTTP status code
constraintViolations	ConstraintViolation[]	A list of constraint violations
message	string	The error message

The `ConstraintViolation` object

A list of constraint violations

Element	Type	Description
location	string	-
message	string	-
parameterLocation	string	- The element can hold these values `HEADER` `PATH` `PAYLOAD_BODY` `QUERY`
path	string	-

Response body JSON models

{
  "sha256": "string"
}

{
  "error": {
    "code": 1,
    "constraintViolations": [
      {
        "location": "string",
        "message": "string",
        "parameterLocation": "HEADER",
        "path": "string"
      }
    ],
    "message": "string"
  }
}