Get a synthetic node in Dynatrace with the Synthetic API by its node ID and retrieve the node properties for the specified node.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/synthetic/v1/nodes/{node-id} |
Provide the node-id path parameter to identify the synthetic node you want to inspect. Dynatrace returns the properties of that node in a successful response.
To execute this request, you need a platform token or OAuth access token with synthetic:locations:read scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| node-id | string | The ID of the required synthetic node. | path | Required |
| Code | Type | Description |
|---|---|---|
| 200 | Extended | Success |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
ExtendedNodeResponse objectConfiguration of a synthetic node. Compare to NodeResponse contains additional browser-related data.
| Element | Type | Description |
|---|---|---|
| activeGateVersion | string | The version of the Active Gate. |
| autoUpdateEnabled | boolean | The Active Gate has the Auto update option enabled ('true') or not ('false'). |
| browserMonitorsEnabled | boolean | The synthetic node is able to execute browser monitors ( |
| browserType | string | The browser type. |
| browserVersion | string | The browser version. |
| capabilities | string[] | The list of node's capabilities. |
| healthCheckStatus | string | The health check status of the synthetic node. |
| hostname | string | The hostname of the synthetic node. |
| id | string | The ID of the synthetic node. |
| ips | string[] | The IP of the synthetic node. |
| oneAgentRoutingEnabled | boolean | The Active Gate has the One Agent routing enabled ('true') or not ('false'). |
| operatingSystem | string | The Active Gate's host operating system. |
| playerVersion | string | The version of the synthetic player. |
| status | string | The status of the synthetic node. |
| version | string | The version of the synthetic node. |
ErrorResponseEnvelope objectEncloses the encountered error.
| Element | Type | Description |
|---|---|---|
| error | Error | Basic information of the encountered error. |
ErrorResponse objectBasic information of the encountered error.
| Element | Type | Description |
|---|---|---|
| code | integer | The returned HTTP status code. |
| details | Error | Detailed information of the error. |
| message | string | Description of the encountered error. |
ErrorResponseDetails objectDetailed information of the error.
| Element | Type | Description |
|---|---|---|
| type | string | Defines the actual set of fields depending on the value. See one of the following objects:
The element can hold these values
|
{"activeGateVersion": "1.172.2.20190607-040913","autoUpdateEnabled": true,"browserMonitorsEnabled": true,"browserType": "Chrome","browserVersion": "69.0.3497.81","capabilities": ["HTTP_HIGH_RESOURCE","HTTP"],"healthCheckStatus": "Ok","hostname": "gdn.dyna.trace","id": "3086117876","ips": ["238.245.160.14"],"oneAgentRoutingEnabled": true,"operatingSystem": "Linux","playerVersion": "1.179.0.20190920-145430","status": "Running","version": "1.161.0.20181210-173639"}
{"error": {"code": 1,"details": {"type": "constraintViolation"},"message": "string"}}