Synthetic locations API v2 - GET a location (Dynatrace Managed)

This API call gets the parameters of the specified location. 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/locations

Parameters

Parameter
Type
Description
In
Required
locationId
string

The Dynatrace entity ID of the required location.

path
required

Response

Response codes

Code
Type
Description
200

Success. The response contains parameters of the synthetic location.

4XX

Client side error.

5XX

Server side error.

Response body objects

The SyntheticLocation object

Configuration of a synthetic location.

countryCode, regionCode, city parameters are optional as they can be retrieved based on latitude and longitude of location.

The actual set of fields depends on the type of the location. Find the list of actual objects in the description of the type field or see Synthetic locations API v2 - JSON models.

Element
Type
Description
city
string

The city of the location.

countryCode
string

The country code of the location.

To fetch the list of available country codes, use the GET all countries request.

countryName
string

The country name of the location.

entityId
string

The Dynatrace entity ID of the location.

geoLocationId
string

The Dynatrace GeoLocation ID of the location.

latitude
number

The latitude of the location in DDD.dddd format.

Response body JSON model

{
  "city": "string",
  "countryCode": "string",
  "countryName": "string",
  "entityId": "string",
  "geoLocationId": "string",
  "latitude": 1,
  "longitude": 1,
  "name": "string",
  "regionCode": "string",
  "regionName": "string",
  "status": "DISABLED",
  "type": "CLUSTER"
}

Response format

To find all model variations that depend on the type of the model, see JSON models.

Response codes

Code
Type
Description
200

Success. The response contains parameters of the synthetic location.

4XX

Client side error.

5XX

Server side error.

Response body objects

The SyntheticLocation object

Configuration of a synthetic location.

countryCode, regionCode, city parameters are optional as they can be retrieved based on latitude and longitude of location.

The actual set of fields depends on the type of the location. Find the list of actual objects in the description of the type field or see Synthetic locations API v2 - JSON models.

Element
Type
Description
city
string

The city of the location.

countryCode
string

The country code of the location.

To fetch the list of available country codes, use the GET all countries request.

countryName
string

The country name of the location.

entityId
string

The Dynatrace entity ID of the location.

geoLocationId
string

The Dynatrace GeoLocation ID of the location.

latitude
number

The latitude of the location in DDD.dddd format.

Response body JSON model

{
  "city": "string",
  "countryCode": "string",
  "countryName": "string",
  "entityId": "string",
  "geoLocationId": "string",
  "latitude": 1,
  "longitude": 1,
  "name": "string",
  "regionCode": "string",
  "regionName": "string",
  "status": "DISABLED",
  "type": "CLUSTER"
}

Example - public location

In this example, the request gets the details of the Amazon US East (N. Virginia) public location, which has the ID of SYNTHETIC_LOCATION-0000000000000064.

Curl

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

Request URL

https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations/SYNTHETIC_LOCATION-0000000000000064

Response body

{
  "entityId": "SYNTHETIC_LOCATION-0000000000000064",
  "type": "PUBLIC",
  "name": "Gdańsk",
  "countryCode": "PL",
  "regionCode": "EU",
  "city": "Gdańsk",
  "latitude": 54.399078,
  "longitude": 18.576557,
  "status": "ENABLED",
  "cloudPlatform": "OTHER",
  "ips": [
    "120.157.221.247",
    "172.158.6.93",
    "197.136.70.30",
    "227.53.205.237",
    "131.123.197.12"
  ],
  "stage": "GA",
  "browserType": "Chrome",
  "browserVersion": "83.0.4103.61",
  "capabilities": [
    "BROWSER",
    "HTTP"
  ],
  "geoLocationId": "GEOLOCATION-0A41430434C388A9"
}

Response code

200

Example - private location

In this example, the request gets the details of the Linz HTTP private location, which has the ID of SYNTHETIC_LOCATION-BB5EE23C1D48AFF5.

Curl

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

Request URL

https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations/SYNTHETIC_LOCATION-BB5EE23C1D48AFF5

Response body

{
  "entityId": "SYNTHETIC_LOCATION-BB5EE23C1D48AFF5",
  "type": "PRIVATE",
  "name": "Linz HTTP",
  "countryCode": "AT",
  "regionCode": "04",
  "city": "Linz",
  "latitude": 48.306351,
  "longitude": 14.287399,
  "status": "ENABLED",
  "nodes": [
    "137829320"
  ],
  "availabilityLocationOutage": false,
  "availabilityNodeOutage": false,
  "locationNodeOutageDelayInMillis": 3000,
  "geoLocationId": "GEOLOCATION-427705B3488A4C45"
}

Response code

200

Related topics