Deployment API - GET available versions of BOSH tarballs

Reference
Published Aug 28, 2019

Gets the list of available OneAgent versions for BOSH release tarballs.

The request produces an application/json payload.

GET	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/v1/deployment/boshrelease/versions/{osType}`
GET	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v1/deployment/boshrelease/versions/{osType}`

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
osType	string	The operating system of the installer. The element can hold these values `windows` `unix`	path	Required

Response

Response codes

Code	Type	Description
200	BoshReleaseAvailableVersions	Success
4XX	ErrorEnvelope	Client side error.
5XX	ErrorEnvelope	Server side error.

Response body objects

The `BoshReleaseAvailableVersions` object

A list of available OneAgent versions for BOSH release tarballs.

Element	Type	Description
availableVersions	string[]	A list of available OneAgent versions for BOSH release tarballs.

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

{
  "availableVersions": [
    "string"
  ]
}

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