Lists all available releases.
The request produces an application/json payload.
| GET | SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/releases |
| Environment ActiveGateCluster ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/releases |
To execute this request, you need an access token with releases.read scope.
To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| from | string | The start of the requested timeframe. You can use one of the following formats:
If not set, the relative timeframe of two weeks is used ( | query | optional |
| to | string | The end of the requested timeframe. You can use one of the following formats:
If not set, the current timestamp is used. | query | optional |
| nextPageKey | 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 nextPageKey query parameter. When the nextPageKey is set to obtain subsequent pages, you must omit all other query parameters. | query | optional |
| pageSize | integer | The amount of Releases in a single response payload. The maximal allowed page size is 1000. If not set, 100 is used. | query | optional |
| demo | boolean | Get your Releases ( | query | optional |
| releasesSelector | string | Defines the scope of the query. Only Releases matching the provided criteria are included in the response. You can add one or several of the criteria listed below.
To set several criteria, separate them with comma (,). Only results matching all criteria are included in the response. e.g., .../api/v2/releases?releasesSelector=name("Server"),monitoringState("Active"),healthState("HEALTHY"),releasesVersion("1.0.7"). The special characters ~ and " need to be escaped using a ~ (e.g. double quote search entityName("~""). | query | optional |
| sort | string | Specifies the field that is used for sorting the releases list. The field has a sign prefix (+/-) which corresponds to the sorting order ('+' for ascending and '-' for descending). If no sign prefix is set, then the default ascending sorting order will be applied. You can sort by the following properties:
If not set, the ascending order sorting for name is applied. | query | optional |
| Code | Type | Description |
|---|---|---|
| 200 | Releases | Success |
| 400 | Error | Failed. The input is invalid. |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
Releases objectA list of releases.
| Element | Type | Description |
|---|---|---|
| nextPageKey | string | The cursor for the next page of results. Has the value of Use it in the nextPageKey query parameter to obtain subsequent pages of the result. |
| pageSize | integer | The number of entries per page. |
| releases | Release[] | A list of releases. |
| releasesWithProblems | integer | Number of releases with problems. |
| totalCount | integer | The total number of entries in the result. |
Release objectContains data related to a single release of a component. A Release is a combination of a component and a version. A Component can be any form of deployable that can be associated with a version. In the first draft, a Component is always a Service.
The tuple <name, product, stage, version> is always unique.
| Element | Type | Description |
|---|---|---|
| affectedByProblems | boolean | The entity has one or more problems |
| affectedBySecurityVulnerabilities | boolean | The entity has one or more security vulnerabilities |
| instances | Release | The instances entityIds included in this release |
| name | string | The entity name |
| problemCount | integer | The number of problems of the entity |
| product | string | The product name |
| releaseEntityId | string | The entity id of correlating release. |
| running | boolean | The related PGI is still running/monitored |
| securityVulnerabilitiesCount | integer | The number of security vulnerabilities of the entity |
| securityVulnerabilitiesEnabled | boolean | Indicates that the security vulnerabilities feature is enabled |
| softwareTechs | Software | The software technologies of the release |
| stage | string | The stage name |
| throughput | number | The count of bytes per second of the entity |
| version | string | The identified release version |
ReleaseInstance objectContains data related to a single instance of a release. An instance is a Process Group Instance and has an optional build version.
| Element | Type | Description |
|---|---|---|
| buildVersion | string | The build version |
| entityId | string | The entity id of the instance. |
| problems | string[] | List of event Ids of open problems |
| securityVulnerabilities | string[] | List of Security vulnerabilities Ids |
SoftwareTechs objectContains information about the used software technology.
| Element | Type | Description |
|---|---|---|
| edition | string | The edition of the technology. |
| technology | string | The type of the technology. |
| verbatimType | string | The verbatim type of the technology. |
| version | string | The version of the technology. |
{"nextPageKey": "AQAAABQBAAAABQ==","pageSize": 1,"releases": [{"affectedByProblems": true,"affectedBySecurityVulnerabilities": true,"instances": ["PROCESS_GROUP_INSTANCE-49D94B90FB71C45B","PROCESS_GROUP_INSTANCE-7EA049157C82D1A5"],"name": "cluster","problemCount": 4,"product": "Sockshop","releaseEntityId": "PROCESS_GROUP-DFDBAC9CBF104253","running": true,"securityVulnerabilitiesCount": 4,"securityVulnerabilitiesEnabled": true,"softwareTechs": [{"edition": "OpenJDK","technology": "JAVA","verbatimType": "Java","version": "1.8.0_242"}],"stage": "staging","throughput": 923234,"version": "1.195.34.12341232423-012342"}],"releasesWithProblems": 1,"totalCount": 1}