Synthetic locations API v2 - POST a location (Dynatrace Managed)
This API call creates a new private synthetic location. For more details about synthetic location creation, see Create a private Synthetic location. The request consumes and 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
Parameter
To find all model variations that depend on the type of the model, see JSON models.
Parameter | Type | Description | In | Required |
---|---|---|---|---|
body | Synthetic | The JSON body of the request. Contains parameters of the new private synthetic location. | body | optional |
Request 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 | Required |
---|---|---|---|
autoUpdateChromium | boolean | Auto upgrade of Chromium is enabled ( | optional |
availabilityLocationOutage | boolean | Alerting for location outage is enabled ( | optional |
availabilityNodeOutage | boolean | Alerting for node outage is enabled ( | optional |
availabilityNotificationsEnabled | boolean | Notifications for location and node outage are enabled ( | optional |
deploymentType | string | The deployment type of the location:
| optional |
locationNodeOutageDelayInMinutes | integer | Alert if location or node outage lasts longer than X minutes. \n\n Only applicable when | optional |
nodes | string[] | A list of synthetic nodes belonging to the location. You can retrieve the list of available nodes with the GET all nodes call. | optional |
useNewKubernetesVersion | boolean | Boolean value describes which kubernetes version will be used:
| optional |
Request body JSON model
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{
"autoUpdateChromium": true,
"availabilityLocationOutage": true,
"availabilityNodeOutage": true,
"availabilityNotificationsEnabled": true,
"deploymentType": "KUBERNETES",
"locationNodeOutageDelayInMinutes": 1,
"nodes": [
"string"
],
"useNewKubernetesVersion": true
}
Response
Response codes
Code | Type | Description |
---|---|---|
201 | Synthetic | Success. The private location has been created. The response contains the ID of the new location. |
Response body objects
The SyntheticLocationIdsDto
object
A DTO for synthetic Location IDs.
Element | Type | Description |
---|---|---|
entityId | string | Entity ID to be transferred |
geoLocationId | string | GeoLocation ID to be transferred |
Response body JSON model
{
"entityId": "string",
"geoLocationId": "string"
}
Example
In this example, the request creates a new private Synthetic location. This location lies in Linz, Austria. It uses the synthetic node with the ID of 290433380.
The API token is passed in the Authorization header.
You can download or copy the example request body to try it out on your own. Be sure to replace the list of nodes with nodes available in your environment. You can fetch the list of available nodes with the GET all nodes request.
Curl
curl -L -X POST 'https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Content-Type: application/json' \
--data-raw '{
"type": "PRIVATE",
"name": "REST example - Linz",
"countryCode": "AT",
"city": "Linz",
"status": "ENABLED",
"latitude": 48.306351,
"longitude": 14.287399,
"nodes": [
"290433380"
],
"availabilityLocationOutage": false,
"availabilityNodeOutage": false,
"locationNodeOutageDelayInMillis": 5000
}
'
Request URL
https://mySampleEnv.live.dynatrace.com/api/v2/synthetic/locations
Request body
{
"type": "PRIVATE",
"name": "REST example - Linz",
"countryCode": "AT",
"city": "Linz",
"status": "ENABLED",
"latitude": 48.306351,
"longitude": 14.287399,
"nodes": ["290433380"],
"availabilityLocationOutage": false,
"availabilityNodeOutage": false,
"locationNodeOutageDelayInMillis": 5000
}
Response body
{
"entityId": "SYNTHETIC_LOCATION-493122BFA29674DC",
"geoLocationId": "GEOLOCATION-96B57899C9B5A3C7"
}
Response code
200