Extensions API - GET an extension

Lists the properties of the specified extension.

The request produces an application/json payload.

GET	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/config/v1/extensions/{id}`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/extensions/{id}`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/extensions/{id}`

Authentication

To execute this request, you need an access token with ReadConfig scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
id	string	The ID of the required extension.	path	required

Response

Response codes

Code	Type	Description
200	Extension	Success

Response body objects

The `Extension` object

General configuration of an extension.

Element	Type	Description
id	string	The ID of the extension, for example `custom.remote.python.demo`.
name	string	The name of the extension, displayed in Dynatrace.
version	string	The version of the extension, displayed in Dynatrace.
type	string	The type of the extension. It indicates the runtime environment of the extension (for example, ACTIVEGATE). The element can hold these values `ACTIVEGATE` `CODEMODULE` `JMX` `ONEAGENT` `PMI` `UNKNOWN`
metricGroup	string	The metricGroup of the extension used for grouping custom metrics into a hierarchical namespace.
metadata	ConfigurationMetadata	Metadata useful for debugging
properties	ExtensionProperty[]	A list of extension properties.

The `ConfigurationMetadata` object

Metadata useful for debugging

Element	Type	Description
configurationVersions	integer[]	A sorted list of the version numbers of the configuration.
currentConfigurationVersions	string[]	A sorted list of version numbers of the configuration.
clusterVersion	string	Dynatrace version.

The `ExtensionProperty` object

A property of an extension.

Element	Type	Description
key	string	The key of the property.
type	string	The type of the property.
defaultValue	string	The default value of the property.
dropdownValues	string[]	The list of possible values of the property. If such a list is defined, only values from this list can be assigned to the property.

Response body JSON model

json
{
  "id": "custom.remote.python.demo",
  "name": "ActiveGate demo extension",
  "version": "1.01",
  "type": "ActiveGate",
  "metricGroup": "custom.demo_metrics",
  "metadata": {
    "configurationVersions": [
      7
    ],
    "clusterVersion": "1.186.0.20200109-094111"
  },
  "properties": [
    {
      "key": "serverIp",
      "type": "STRING",
      "defaultValue": "127.0.0.1"
    },
    {
      "key": "password",
      "type": "PASSWORD",
      "defaultValue": ""
    },
    {
      "key": "username",
      "type": "STRING",
      "defaultValue": "dynatrace"
    },
    {
      "key": "dropdownProperty",
      "type": "DROPDOWN",
      "defaultValue": "one",
      "dropdownValues": [
        "one",
        "two",
        "three"
      ]
    }
  ]
}