Settings API - Settings zones schema table

  • Published Sep 25, 2025

Settings zones (builtin:settings-zones)

Settings zones enable defining fine grained access rights to parts of an environment.

Schema IDSchema groupsScope
builtin:settings-zones
  • group:preferences
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:settings-zones
GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:settings-zones
GETEnvironment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:settings-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
Settings zone id
id		text-Required
Settings zone display name
displayName		text-Optional
Entity selector rules
entitySelectorRules		Set<EntitySelectorRule>-Required
The EntitySelectorRule object
PropertyTypeDescriptionRequired
Enabled
enabled		boolean-Required
Monitored entity type
meType		enum

Rules can only be applied to the selected type

The element has these enums
  • SERVICE
Required
Entity selector
entitySelector		text

The documentation of the entity selector can be found here. The type is optional here (already defined above).

Required