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 an access token with Read extension monitoring configurations (extensionConfigurations.read
) scope. 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 | Type | Description |
---|---|---|
200 | Schema | Success |
404 | Error | Failed. The requested resource doesn't exist. |
Response body objects
The SchemaDefinitionRestDto
object
Element | Type | Description |
---|---|---|
dynatrace | string | The version of the data format. Can be |
schemaId | string | The ID of the schema. Can be |
displayName | string | The display name of the schema. Can be |
description | string | A short description of the schema. Can be |
documentation | string | An extended description of the schema and/or links to documentation. Can be |
schemaGroups | string[] | Names of the groups, which the schema belongs to. Can be |
version | string | The version of the schema. Can be |
multiObject | boolean | Multiple ( Can be |
ordered | boolean | If Only applicable when multiObject is set to Can be |
maxObjects | integer | The maximum amount of objects per scope. Only applicable when multiObject is set to Can be |
allowedScopes | string[] | A list of scopes where the schema can be used. Can be |
enums | object | A list of definitions of enum properties. Can be |
types | object | A list of definitions of types. A type is a complex property that contains its own set of subproperties. Can be |
properties | object | A list of schema's properties. Can be |
constraints | Complex | A list of constrains limiting the values to be accepted by the schema. Can be |
metadata | object | Metadata of the setting. Can be |
uiCustomization | Ui | Customization for UI elements Can be |
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. Can be |
items | Enum | A list of allowed values of the enum. Can be |
type | string | The type of the property. Can be |
documentation | string | An extended description and/or links to documentation. Can be |
displayName | string | The display name of the property. Can be |
description | string | A short description of the property. Can be |
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. Can be |
displayName | string | The display name of the value. Can be |
value | object | The allowed value of the enum. Can be |
description | string | A short description of the value. Can be |
icon | string | The icon of the value. Can be |
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. Can be |
searchPattern | string | The pattern for the summary search(for example, "Alert after X minutes.") of the configuration in the UI. Can be |
versionInfo | string | A short description of the version. Can be |
constraints | Complex | A list of constraints limiting the values to be accepted. Can be |
properties | object | Definition of properties that can be persisted. Can be |
version | string | The version of the type. Can be |
documentation | string | An extended description and/or links to documentation. Can be |
displayName | string | The display name of the property. Can be |
description | string | A short description of the property. Can be |
The ComplexConstraint
object
A constraint on the values accepted for a complex settings property.
Element | Type | Description |
---|---|---|
customMessage | string | A custom message for invalid values. Can be |
minimumPropertyCount | integer | The minimum number of properties that must be set. Can be |
maximumPropertyCount | integer | The maximum number of properties that can be set. Can be |
customValidatorId | string | The ID of a custom validator. Can be |
properties | string[] | A list of properties (defined by IDs) that are used to check the constraint. Can be |
type | string | The type of the constraint. Can be |
The PropertyDefinition
object
Configuration of a property in a settings schema.
Element | Type | Description |
---|---|---|
referencedType | string | The type referenced by the property value Can be |
items | Item | An item of a collection property. Can be |
documentation | string | An extended description and/or links to documentation. Can be |
maxObjects | integer | The maximum number of objects in a collection property. Has the value of Can be |
uiCustomization | Ui | Customization for UI elements Can be |
modificationPolicy | string | Modification policy of the property. Can be |
precondition | Precondition | A precondition for visibility of a property. Can be |
datasource | Datasource | Configuration of a datasource for a property. Can be |
minObjects | integer | The minimum number of objects in a collection property. Can be |
subType | string | The subtype of the property's value. Can be |
displayName | string | The display name of the property. Can be |
constraints | Constraint[] | A list of constraints limiting the values to be accepted. Can be |
default | object | The default value to be used when no value is provided. If a non-singleton has the value of Can be |
type | object | The type of the property's value. Can be |
description | string | A short description of the property. Can be |
metadata | object | Metadata of the property. Can be |
nullable | boolean | The value can ( Can be |
The Item
object
An item of a collection property.
Element | Type | Description |
---|---|---|
referencedType | string | The type referenced by the item's value. Can be |
documentation | string | An extended description and/or links to documentation. Can be |
uiCustomization | Ui | Customization for UI elements Can be |
datasource | Datasource | Configuration of a datasource for a property. Can be |
subType | string | The subtype of the item's value. Can be |
displayName | string | The display name of the item. Can be |
constraints | Constraint[] | A list of constraints limiting the values to be accepted. Can be |
type | object | The type of the item's value. Can be |
description | string | A short description of the item. Can be |
metadata | object | Metadata of the items. Can be |
The UiCustomization
object
Customization for UI elements
Element | Type | Description |
---|---|---|
expandable | Ui | UI customization for expandable section Can be |
table | Ui | Customization for UI tables Can be |
The UiExpandableCustomization
object
UI customization for expandable section
Element | Type | Description |
---|---|---|
displayName | string | The display name Can be |
sections | Ui | A list of sections Can be |
The UiExpandableSectionCustomization
object
Expandable section customization for UI
Element | Type | Description |
---|---|---|
displayName | string | The display name Can be |
properties | string[] | A list of properties Can be |
description | string | The description Can be |
The UiTableCustomization
object
Customization for UI tables
Element | Type | Description |
---|---|---|
columns | Ui | A list of columns for the UI table Can be |
The UiTableColumnCustomization
object
Customization for UI table columns
Element | Type | Description |
---|---|---|
propertyRef | string | The referenced property for this column. Can be |
displayName | string | The display name for this column. Can be |
type | string | The ui specific type for this column. Can be |
The DatasourceDefinition
object
Configuration of a datasource for a property.
Element | Type | Description |
---|---|---|
resetValue | string | When to reset datasource value in the UI on filter change. Can be |
filterProperties | string[] | The properties to filter the datasource options on. Can be |
validate | boolean | Whether to validate input to only allow values returned by the datasource. Can be |
fullContext | boolean | Whether this datasource expects full setting payload as the context. Can be |
useApiSearch | boolean | If true, the datasource should use the api to filter the results instead of client-side filtering. Can be |
identifier | string | The identifier of a custom data source of the property's value. Can be |
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. Can be |
minLength | integer | The minimum required length of string values. Can be |
customMessage | string | A custom message for invalid values. Can be |
uniqueProperties | string[] | A list of properties for which the combination of values must be unique. Can be |
customValidatorId | string | The ID of a custom validator. Can be |
maximum | number | The maximum allowed value. Can be |
minimum | number | The minimum allowed value. Can be |
type | string | The type of the constraint. Can be |
pattern | string | The regular expression pattern for valid string values. Can be |
The Precondition
object
A precondition for visibility of a property.
Element | Type | Description |
---|---|---|
expectedValues | object[] | A list of valid values of the property. Only applicable to properties of the Can be |
precondition | Precondition | A precondition for visibility of a property. Can be |
preconditions | Precondition[] | A list of child preconditions to be evaluated. Only applicable to properties of the Can be |
expectedValue | object | The expected value of the property. Only applicable to properties of the Can be |
property | string | The property to be evaluated. Can be |
type | string | The type of the precondition. Can be |
pattern | string | The Regular expression which is matched against the property. Only applicable to properties of the Can be |
Response body JSON model
{
"dynatrace": "1",
"schemaId": "builtin:container.built-in-monitoring-rule",
"displayName": "Built-in container monitoring rules",
"description": "Dynatrace disables monitoring of containers that do not run any applications",
"documentation": "string",
"schemaGroups": [
"group:some.1",
"group:some.2"
],
"version": "1.4.2",
"multiObject": true,
"ordered": true,
"maxObjects": 10,
"allowedScopes": [
"host",
"application"
],
"enums": {},
"types": {},
"properties": {},
"constraints": [
{
"customMessage": "string",
"minimumPropertyCount": 1,
"maximumPropertyCount": 2,
"customValidatorId": "my-min-max",
"properties": [
"string"
],
"type": "CUSTOM_VALIDATOR_REF"
}
],
"metadata": {},
"uiCustomization": {
"expandable": {
"displayName": "string",
"sections": [
{
"displayName": "string",
"properties": [
"string"
],
"description": "string"
}
]
},
"table": {
"columns": [
{
"propertyRef": "apiColor",
"displayName": "Color",
"type": "cell-color-picker"
}
]
}
}
}