Settings API - Network zone schema table

  • Published Oct 27, 2025

Network zone (builtin:networkzones.zones)

Define rules to organize network structures and improve routing efficiency.

Schema IDSchema groupsScope
builtin:networkzones.zones-
environment
environment-default
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:networkzones.zones
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:networkzones.zones
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:networkzones.zones

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
Identifier
id
text

A lowercase string limited to 256 characters that can contain alphanumerics (0-9, a-z), hyphens (-), underscores (_), and dots (.), but can not start with a dot.

required
Description
description
text-optional
Alternative zones
alternativeZones
set

Network zones that should be used when the primary zone is not available.

required
Fallback mode
fallbackMode
enum

Determines the network zone fallback behavior in case the primary and alternative zones are not available.

  • ANY_ACTIVE_GATE
  • ONLY_DEFAULT_ZONE
  • NONE
required