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

Response

Response codes

Code Description
200

Success

404

Failed. The requested resource doesn't exist.

406

Not acceptable

Response body

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