Download the ActiveGate installer for an OS type and architecture from Dynatrace with the Fleet Management API in the configured target version.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/v1/activegate/installer/{os-type}/{arch}:download |
You use the os-type and arch path parameters to download the ActiveGate installer in the configured target version, or the latest available version if no target is set. Send the ETag of a previous download in the If-None-Match header to skip the download when nothing changed. Typical usage is automated ActiveGate installation.
To execute this request, you need a platform token or OAuth access token with fleet-management:activegates:download scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| If-None-Match | string | The ETag of the previous request. Don't download if it matches the ETag of the installer. | header | Optional |
| os-type | string | The operating system of the installer. The element can hold these values
| path | Required |
| arch | string | The architecture of your OS:
The element can hold these values
| path | Required |
| Code | Type | Description |
|---|---|---|
| 200 | string | Success. The payload contains the installer file. |
| 304 | - | Not modified. You already have the latest version of the installer. The response doesn't contain a payload. |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
ResponseBody objectErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| code | integer | The HTTP status code |
| constraintViolations | Constraint | A list of constraint violations |
| message | string | The error message |
ConstraintViolation objectA list of constraint violations
| Element | Type | Description |
|---|---|---|
| location | string | - |
| message | string | - |
| parameterLocation | string | -The element can hold these values
|
| path | string | - |
{"error": {"code": 1,"constraintViolations": [{"location": "string","message": "string","parameterLocation": "HEADER","path": "string"}],"message": "string"}}