Extensions 2.0 API - GET an extension

Lists the properties of the specified Extensions 2.0 extension or downloads the extension's ZIP file.

The request produces one of the following types of payload, depending on the value of the Accept request header:

application/json—a JSON payload containing properties of the extension.
application/octet-stream—a download of the ZIP file of the extension.

If no Accept header is provided with the request, an application/json payload is returned.

GET

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

Authentication

To execute this request, you need the Read extensions (extensions.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
Accept	string	Accept header. Specifies part of the extension 2.0 that will be returned: application/json; charset=utf-8 - returns extension 2.0 metadata in JSON application/octet-stream - returns extension 2.0 zip package stored on the server.	header	optional

Parameter

Type

Description

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

string

Accept header. Specifies part of the extension 2.0 that will be returned:

application/json; charset=utf-8 - returns extension 2.0 metadata in JSON
application/octet-stream - returns extension 2.0 zip package stored on the server.

header

optional

Response

Response codes

Code	Description
200	Success
404	Failed. The requested resource doesn't exist.
406	Not acceptable

Response body

Response parametersJSON model

The Extension object

Element	Type	Description
extensionName	string	Extension name
version	string	Extension version
author	AuthorDto
dataSources	string[]	Data sources that extension uses to gather data
variables	string[]	Custom variables used in extension configuration
featureSets	string[]	Available feature sets
featureSetsDetails	object	Details of feature sets
minDynatraceVersion	string	Minimal Dynatrace version that works with the extension
fileHash	string	SHA-256 hash of uploaded Extension file

The FeatureSetDetails object

Additional information about a Feature Set

Element	Type	Description
metrics	MetricDto[]	Feature set metrics

The MetricDto object

Metric gathered by an extension

Element	Type	Description
key	string	Metric key

The AuthorDto object

Extension author

Element	Type	Description
name	string	Author name

    {
  "extensionName": "string",
  "version": "1.2.3",
  "author": {
    "name": "string"
  },
  "dataSources": [
    "string"
  ],
  "variables": [
    "string"
  ],
  "featureSets": [
    "string"
  ],
  "featureSetsDetails": {},
  "minDynatraceVersion": "string",
  "fileHash": "string"
}