Extensions 2.0 API - GET an extension schema

Gets the schema of the specified version of an Extensions 2.0 extension.

The request produces an application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/{extensionVersion}/schema
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/{extensionVersion}/schema
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/{extensionVersion}/schema

Authentication

To execute this request, you need the Read extension monitoring configurations (extensionConfigurations.read) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required
extensionName string

The name of the requested extension 2.0.

path required
extensionVersion string

The version of the requested extension 2.0

path required

Response

Response codes

Code Description
200

Success

404

Failed. The requested resource doesn't exist.

Response body

The SchemaDefinitionRestDto object

Element Type Description
dynatrace string

The version of the data format.

schemaId string

The ID of the schema.

displayName string

The display name of the schema.

description string

A short description of the schema.

documentation string

An extended description of the schema and/or links to documentation.

schemaGroups string[]

Names of the groups, which the schema belongs to.

version string

The version of the schema.

multiObject boolean

Multiple (true) objects per scope are permitted or a single (false) object per scope is permitted.

ordered boolean

If true the order of objects has semantic significance.

Only applicable when multiObject is set to true.

maxObjects integer

The maximum amount of objects per scope.

Only applicable when multiObject is set to true.

allowedScopes string[]

A list of scopes where the schema can be used.

enums object

A list of definitions of enum properties.

types object

A list of definitions of types.

A type is a complex property that contains its own set of subproperties.

properties object

A list of schema's properties.

constraints ComplexConstraint[]

A list of constrains limiting the values to be accepted by the schema.

metadata object

Metadata of the setting.

The SchemaType object

A list of definitions of types.

A type is a complex property that contains its own set of subproperties.

Element Type Description
summaryPattern string

The pattern for the summary (for example, "Alert after X minutes.") of the configuration in the UI.

versionInfo string

A short description of the version.

properties object

Definition of properties that can be persisted.

version string

The version of the type.

constraints ComplexConstraint[]

A list of constraints limiting the values to be accepted.

documentation string

An extended description and/or links to documentation.

displayName string

The display name of the property.

description string

A short description of the property.

The ComplexConstraint object

A constraint on the values accepted for a complex settings property.

Element Type Description
customValidatorId string

The ID of a custom validator.

minimumPropertyCount integer

The minimum number of properties that must be set.

maximumPropertyCount integer

The maximum number of properties that can be set.

customMessage string

A custom message for invalid values.

properties string[]

A list of properties (defined by IDs) that are used to check the constraint.

type string

The type of the constraint.

The PropertyDefinition object

Configuration of a property in a settings schema.

Element Type Description
referencedType string

The type referenced by the property value

items Item
documentation string

An extended description and/or links to documentation.

maxObjects integer

The maximum number of objects in a collection property.

Has the value of 1 for singletons.

minObjects integer

The minimum number of objects in a collection property.

modificationPolicy string

Modification policy of the property.

datasource DatasourceDefinition
precondition Precondition
subType string

The subtype of the property's value.

default object

The default value to be used when no value is provided.

If a non-singleton has the value of null, it means an empty collection.

type object

The type of the property's value.

displayName string

The display name of the property.

description string

A short description of the property.

metadata object

Metadata of the property.

constraints Constraint[]

A list of constraints limiting the values to be accepted.

nullable boolean

The value can (true) or can't (false) be null.

The Precondition object

A precondition for visibility of a property.

Element Type Description
precondition Precondition
preconditions Precondition[]

A list of child preconditions to be evaluated.

Only applicable to properties of the AND and OR types.

expectedValue object

The expected value of the property.

Only applicable to properties of the EQUALS type.

expectedValues object[]

A list of valid values of the property.

Only applicable to properties of the IN type.

property string

The property to be evaluated.

type string

The type of the precondition.

The Item object

An item of a collection property.

Element Type Description
referencedType string

The type referenced by the item's value.

documentation string

An extended description and/or links to documentation.

datasource DatasourceDefinition
subType string

The subtype of the item's value.

type object

The type of the item's value.

displayName string

The display name of the item.

description string

A short description of the item.

metadata object

Metadata of the items.

constraints Constraint[]

A list of constraints limiting the values to be accepted.

The Constraint object

A constraint on the values accepted for a settings property.

Element Type Description
maxLength integer

The maximum allowed length of string values.

minLength integer

The minimum required length of string values.

customValidatorId string

The ID of a custom validator.

uniqueProperties string[]

A list of properties for which the combination of values must be unique.

customMessage string

A custom message for invalid values.

type string

The type of the constraint.

maximum number

The maximum allowed value.

minimum number

The minimum allowed value.

pattern string

The regular expression pattern for valid string values.

The DatasourceDefinition object

Configuration of a datasource for a property.

Element Type Description
filterProperties string[]

The properties to filter the datasource options on.

fullContext boolean

Whether this datasource expects full setting payload as the context.

useApiSearch boolean

If true, the datasource should use the api to filter the results instead of client-side filtering.

validate boolean

Whether to validate input to only allow values returned by the datasource.

identifier string

The identifier of a custom data source of the property's value.

The EnumType object

Definition of an enum property.

Element Type Description
enumClass string

An existing Java enum class that holds the allowed values of the enum.

items EnumValue[]

A list of allowed values of the enum.

type string

The type of the property.

documentation string

An extended description and/or links to documentation.

displayName string

The display name of the property.

description string

A short description of the property.

The EnumValue object

An allowed value for an enum property.

Element Type Description
enumInstance string

The name of the value in an existing Java enum class.

icon string

The icon of the value.

value object

The allowed value of the enum.

displayName string

The display name of the value.

description string

A short description of the value.