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.

PUT
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/networkZones/{id}
  • Managed Use the Cluster API.

Authentication

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.

Parameters

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.

optional
description string

A short description of the network zone

optional

Response

Response codes

Code Description
201

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

204

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

400

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.