Synthetic locations API v2 - POST a location
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.
This request is an Early Adopter release and may be changed in non-compatible way.
POST |
|
Authentication
To execute this request, you need the Write synthetic locations (syntheticLocations.write
) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.
Parameter
To find all model variations that depend on the type of the model, see JSON models.
Parameter | Type | Description | In | Required |
---|---|---|---|---|
body | PrivateSyntheticLocation |
The JSON body of the request. Contains parameters of the new private synthetic location. |
body | optional |
Body format
The PrivateSyntheticLocation object
Configuration of a synthetic location.
The actual set of fields depends on the type of the location.
Element | Type | Description | Required |
---|---|---|---|
entityId | string |
The Dynatrace entity ID of the location. |
required |
type | string |
Defines the actual set of fields depending on the value. See one of the following objects:
|
required |
name | string |
The name of the location. |
required |
city | string |
The city of the location. |
optional |
latitude | number |
The latitude of the location in |
required |
longitude | number |
The longitude of the location in |
required |
status | string |
The status of the location:
|
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. |
required |
availabilityLocationOutage | boolean |
The alerting of location outage is enabled ( |
optional |
availabilityNodeOutage | boolean |
The alerting of node outage is enabled ( If enabled, the outage of any node in the location triggers an alert. |
optional |
locationNodeOutageDelayInMinutes | integer |
Alert if the location or node outage lasts longer than X minutes. Only applicable when availabilityLocationOutage or availabilityNodeOutage is set to |
optional |
availabilityNotificationsEnabled | boolean |
The notifications of location and node outage is enabled ( |
optional |
geoLocationId | string |
The Dynatrace GeoLocation ID of the location. |
required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request. See the Example expandable section for working sample request.
{
"type": "PRIVATE",
"name": "Linz Location",
"latitude": 48.306351,
"longitude": 14.287399,
"nodes": [
"93302281"
],
"status": "ENABLED",
"availabilityLocationOutage": false,
"availabilityNodeOutage": false,
"availabilityLocationNodeOutageDelayInMinutes": 5
}
Response
Response codes
Code | Description |
---|---|
201 | Success. The private location has been created. The response contains the ID of the new location. |
Response body
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 |
{
"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 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