Deployment API - Download the latest version of the orchestration tarball

Reference
Published Jun 29, 2021

Downloads the latest OneAgent deployment orchestration tarball.

GET	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/v1/deployment/orchestration/agent/{orchestrationType}/latest`
GET	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v1/deployment/orchestration/agent/{orchestrationType}/latest`

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
orchestrationType	string	The Orchestration Type of the orchestration deployment script. The element can hold these values `ansible` `puppet`	path	Required

Response

Response codes

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 does not contain a payload.
4XX	ErrorEnvelope	Client side error.
5XX	ErrorEnvelope	Server side error.

Response body objects

The `ResponseBody` object

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

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