• Home
  • Dynatrace Managed
  • Cluster API
  • Cluster API v2
  • Synthetic locations and nodes
  • GET all nodes

Synthetic nodes API v2 - GET all nodes (Dynatrace Managed)

This API call lists all synthetic nodes (and their parameters) available for your environment. The request produces an application/json payload.

Authentication

To execute this request, you need the Service Provider API (ServiceProviderAPI) permission assigned to your API token. Generate your API token via Cluster Management Console (CMC). To learn how to obtain and use it, see Cluster API - Authentication.

Endpoint

/api/cluster/v2/synthetic/nodes

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

CodeTypeDescription
200Nodes

Success

Response body objects

The Nodes object

A list of synthetic nodes

ElementTypeDescription
nodesNodeCollectionElement[]

A list of synthetic nodes

The NodeCollectionElement object

The short representation of a synthetic object. Only contains the ID and the display name.

ElementTypeDescription
entityIdstring

The ID of a node.

hostnamestring

The hostname of a node.

ipsstring[]

The IP of a node.

versionstring

The version of a node

browserMonitorsEnabledboolean

Browser check capabilities enabled flag.

activeGateVersionstring

The version of the Active Gate.

oneAgentRoutingEnabledboolean

The Active Gate has the One Agent routing enabled ('true') or not ('false').

operatingSystemstring

The Active Gate's host operating system.

autoUpdateEnabledboolean

The Active Gate has the Auto update option enabled ('true') or not ('false')

statusstring

The status of the synthetic node.

playerVersionstring

The version of the synthetic player.

healthCheckStatusstring

The health check status of the synthetic node.

Response body JSON model

json
{ "nodes": [ { "entityId": "3086117876", "hostname": "gdn.dyna.trace", "ips": [ "238.245.160.14" ], "version": "1.161.0.20181210-173639", "browserMonitorsEnabled": true, "activeGateVersion": "1.172.2.20190607-040913", "oneAgentRoutingEnabled": true, "operatingSystem": "Linux", "autoUpdateEnabled": true, "status": "Running", "playerVersion": "1.179.0.20190920-145430", "healthCheckStatus": "Ok" } ] }

Example

In this example, the request lists all synthetic nodes available in the mySampleEnv environment.

The API token is passed in the Authorization header.

The result is truncated to two entries.

Curl

bash
curl -X GET \ https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/nodes \ -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

plaintext
https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/nodes

Response body

json
{ "nodes": [ { "entityId": "3086117876", "hostname": "gdn.dyna.trace", "ips": [ "238.245.160.14" ], "version": "1.207.0.20201029-141904", "browserMonitorsEnabled": true, "activeGateVersion": "1.207.0.20201029-180431", "oneAgentRoutingEnabled": false, "operatingSystem": "Platform: Linux, Version: 4.4.0-1092-aws, Architecture: amd64, Processors: 2", "autoUpdateEnabled": true, "status": "Running", "playerVersion": "1.207.0.20201029-081128", "healthCheckStatus": "Ok" }, { "entityId": "1267320067", "hostname": "244.94.30.253", "ips": [ "244.94.30.253" ], "version": null, "browserMonitorsEnabled": true, "activeGateVersion": "1.207.0.20201029-180431", "oneAgentRoutingEnabled": false, "operatingSystem": "Platform: Linux, Version: 4.15.0-1057-azure, Architecture: amd64, Processors: 2", "autoUpdateEnabled": true, "status": null, "playerVersion": null, "healthCheckStatus": "Offline" } ] }

Response code

200