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 an access token with Read extensions (extensions.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 |
| Accept | string | Accept header. Specifies part of the extension 2.0 that will be returned:
| header | optional |
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 200 | Extension | Success |
| 404 | ErrorEnvelope | Failed. The requested resource doesn't exist. |
| 406 | ErrorEnvelope | Not acceptable |
Response body objects
The Extension object
| Element | Type | Description |
|---|---|---|
| extensionName | string | Extension name |
| version | string | Extension version |
| author | Author | Extension author |
| 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 |
| minEECVersion | string | Minimal Extension Execution Controller version that works with the extension |
| fileHash | string | SHA-256 hash of uploaded Extension file |
The AuthorDto object
Extension author
| Element | Type | Description |
|---|---|---|
| name | string | Author name |
The FeatureSetDetails object
Additional information about a Feature Set
| Element | Type | Description |
|---|---|---|
| metrics | Metric | Feature set metrics |
The MetricDto object
Metric gathered by an extension
| Element | Type | Description |
|---|---|---|
| key | string | Metric key |
| metadata | Metric | Metric metadata |
The MetricMetadataDto object
Metric metadata
| Element | Type | Description |
|---|---|---|
| displayName | string | The name of the metric in the user interface |
| description | string | A short description of the metric |
| unit | string | The unit of the metric |
Response body JSON model
{
"extensionName": "string",
"version": "1.2.3",
"author": {
"name": "string"
},
"dataSources": [
"string"
],
"variables": [
"string"
],
"featureSets": [
"string"
],
"featureSetsDetails": {},
"minDynatraceVersion": "string",
"minEECVersion": "string",
"fileHash": "string"
}