Network zones API - DELETE a network zone

  • Reference
  • Published Apr 08, 2020

Deletes the specified network zone. Deletion cannot be undone!

You can only delete an empty network zone (a zone that no ActiveGate or OneAgent is using). If the network zone is used as an alternative zone for any OneAgent, it will be automatically removed from the list of possible alternatives.

DELETE

  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/networkZones/{id}

Authentication

To execute this request, you need the Write network zones (networkZones.write) permission assigned to your API token. To learn how to obtain and use it, see Authentication.

Parameters

ParameterTypeDescriptionInRequired
idstring

The ID of the network zone to be deleted.

pathRequired

Response

Response codes

CodeTypeDescription
204-

Deleted. Response doesn't have a body.

400ErrorEnvelope

Failed. See error message in the response body for details.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
codeinteger

The HTTP status code

constraintViolationsConstraintViolation[]

A list of constraint violations

messagestring

The error message

The ConstraintViolation object

A list of constraint violations

ElementTypeDescription
locationstring-
messagestring-
parameterLocationstring-
The element can hold these values
  • HEADER
  • PATH
  • PAYLOAD_BODY
  • QUERY
pathstring-

Response body JSON models

{
  "error": {
    "code": 1,
    "constraintViolations": [
      {
        "location": "string",
        "message": "string",
        "parameterLocation": "HEADER",
        "path": "string"
      }
    ],
    "message": "string"
  }
}