List the available ActiveGate installer versions in Dynatrace with the Fleet Management API, page by page, to choose a version to download.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/v1/activegate/installer/versions |
You use this operation to list the ActiveGate installer versions available for your environment. The response is paginated: set page-size for the number of versions per page and pass the nextPageKey from a previous response as page-key to get the next page. Typical usage is picking a specific version to download.
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 |
|---|---|---|---|---|
| page-key | string | The cursor for the next page of results. You can find it in the nextPageKey field of the previous response. The first page is always returned if you don't specify the page-key query parameter. When the page-key is set to obtain subsequent pages, you must omit all other query parameters. | query | Optional |
| page-size | integer | The amount of ActiveGate Installer versions in a single response payload. The maximal allowed page size is 1000 and the minimum size is 10. If not set, 10 is used. | query | Optional |
| Code | Type | Description |
|---|---|---|
| 200 | Active | Success |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
ActiveGateInstallerVersions objectList of available ActiveGate Installer versions
| Element | Type | Description |
|---|---|---|
| nextPageKey | string | The cursor for the next page of results. Has the value of Use it in the page-key query parameter to obtain subsequent pages of the result. |
| pageSize | integer | The number of entries per page. |
| totalCount | string | The total number of entries in the result. |
| versions | string[] | ActiveGate installer versions. |
ErrorEnvelope 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 | - |
{"nextPageKey": "AQAAABQBAAAABQ==","pageSize": 100,"totalCount": "1000","versions": ["string"]}
{"error": {"code": 1,"constraintViolations": [{"location": "string","message": "string","parameterLocation": "HEADER","path": "string"}],"message": "string"}}