Network zones API - PUT a network zone

Updates the specified network zone. If the network zone with the specified ID doesn't exist, a new network zone is created.

The request produces and consumes an application/json payload.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

  • SaaS https://{your-environment-id}{id}
  • Managed Use the Cluster API.


To execute this request, you need the Deployment management permission assigned to your API token. To learn how to obtain and use it, see Authentication.


Parameter Type Description In Required
id string

The ID of the network zone to be updated.

If you set the ID in the body as well, it must match this ID.

The ID is not case sensitive. Dynatrace stores the ID in lowercase.

path required
body NetworkZone

The JSON body of the request. Contains parameters of the network zone.

body optional

Body format

The NetworkZone object

Configuration of a network zone.

Element Type Description Required
alternativeZones string[]

A list of alternative network zones.

description string

A short description of the network zone



Response codes

Code Description

Success. The new network zone has been created. The response body contains the ID of the new network zone.


Success. The network zone has been updated. Response doesn't have a body.


Failed. The input is invalid.

Response body

The EntityShortRepresentation object

The short representation of a Dynatrace entity.

Element Type Description
id string

The ID of the Dynatrace entity.

name string

The name of the Dynatrace entity.

description string

A short description of the Dynatrace entity.