Cluster information API
The Cluster information API enables you to check the version and internal time of your Dynatrace environment.
GET cluster time
The request produces plain/text.
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v1/time |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v1/time | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v1/time |
The response in cluster time in UTC milliseconds.
GET cluster version
Dynatrace innovates fast and releases a new server(cluster) version with new features every two weeks.
We operate multiple SaaS clusters worldwide and those clusters are updated at different times. As this update process is completely transparent for our customer it is hard to exactly identify when your environment is updated to a new cluster version.
This API endpoint enables you to query the actual cluster version of your environment.
The request produces an application/json payload.
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v1/config/clusterversion |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v1/config/clusterversion | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v1/config/clusterversion |
Authentication
To execute this request, you need Access problem and event feed, metrics, and topology (DataExport) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 200 | Cluster | Success |
Response body objects
The ClusterVersion object
| Element | Type | Description | Required |
|---|---|---|---|
| version | string | The version of the Dynatrace server. | optional |
Response body JSON model
{
"version": "string"
}