Update a synthetic location in Dynatrace with the Synthetic API by specifying the location ID and changing its properties.
| PUT | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/synthetic/v1/locations/{location-id} |
You use the location-id endpoint to update a specific synthetic location. The path parameter location-id identifies the location to update, and for public locations you can only change the location status. The operation returns no body when the update succeeds.
To execute this request, you need a platform token or OAuth access token with synthetic:locations:write scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| location-id | string | The ID of the synthetic location to be updated. | path | Required |
| body | Synthetic | The JSON body of the request. Contains updated parameters of the location. | body | Required |
SyntheticPrivateLocationUpdateRequest objectThe request to update of a private Synthetic location. Some fields need to be defined only for containerized locations.
| Element | Type | Description | Required |
|---|---|---|---|
| autoUpdateChromium | boolean | Non-containerized location property. 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 |
| browserExecutionSupported | boolean | Containerized location property. Boolean value describes if browser monitors will be executed on this location:
| Optional |
| city | string | The city of the location. | Optional |
| countryCode | string | The country code of the location. To fetch the list of available country codes, use the GET all countries request. | Optional |
| deploymentType | string | The deployment type of the location:
The element can hold these values
| Optional |
| fipsMode | string | Containerized location property indicating whether FIPS mode is enabled on this location:
The element can hold these values
| Optional |
| latitude | number | The latitude of the location in | Required |
| locationNodeOutageDelayInMinutes | integer | Alert if location or node outage lasts longer than X minutes. \n\n Only applicable when | Optional |
| longitude | number | The longitude of the location in | Required |
| maxActiveGateCount | integer | Containerized location property. The maximum number of ActiveGates deployed for the location (required for a Kubernetes location). | Optional |
| minActiveGateCount | integer | Containerized location property. The minimum number of ActiveGates deployed for the location (required for a Kubernetes location). | Optional |
| namExecutionSupported | boolean | Containerized location property. Boolean value describes if icmp monitors will be executed on this location:
| Optional |
| name | string | The name of the location. | Required |
| nodeSize | string | Containerized location property. The size of a containerized node deployed for the location (required for a Kubernetes location). Accepted values:
The element can hold these values
| 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 |
| regionCode | string | The region code of the location. To fetch the list of available region codes, use the GET regions of the country request. | Optional |
| status | string | The status of the location:
The element can hold these values
| Optional |
| type | string | -The element can hold these values
| Required |
| useNewKubernetesVersion | boolean | Containerized location property. Boolean value describes which kubernetes version will be used:
| Optional |
SyntheticPublicLocationUpdateRequest objectThe request to update of a public Synthetic location.
| Element | Type | Description | Required |
|---|---|---|---|
| status | string | The status of the location:
The element can hold these values
| Required |
| type | string | -The element can hold these values
| Required |
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,"availabilityNodeOutage": false,"availabilityNotificationsEnabled": true,"deploymentType": "STANDARD","fipsMode": "DISABLED","isAvailabilityNodeOutage": false,"latitude": 48.306351,"locationNodeOutageDelayInMinutes": 5,"longitude": 14.287399,"name": "Linz Location","nodes": ["93302281"],"status": "ENABLED","type": "PRIVATE"}
| Code | Type | Description |
|---|---|---|
| 204 | - | Success. The location has been updated. Response doesn't have a body. |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
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
|
{"error": {"code": 1,"details": {"type": "constraintViolation"},"message": "string"}}