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 | ManagedDynatrace for Government | 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 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 |
|---|---|---|
| author | Author | Extension author |
| dataSources | string[] | Data sources that extension uses to gather data |
| extensionName | string | Extension name |
| featureSets | string[] | Available feature sets |
| featureSetsDetails | object | Details of feature sets |
| fileHash | string | SHA-256 hash of uploaded Extension file |
| minDynatraceVersion | string | Minimal Dynatrace version that works with the extension |
| minEECVersion | string | Minimal Extension Execution Controller version that works with the extension |
| variables | string[] | Custom variables used in extension configuration |
| version | string | Extension version |
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 |
|---|---|---|
| description | string | A short description of the metric |
| displayName | string | The name of the metric in the user interface |
| unit | string | The unit of the metric |
Response body JSON model
{
"author": {
"name": "string"
},
"dataSources": [
"string"
],
"extensionName": "string",
"featureSets": [
"string"
],
"featureSetsDetails": {},
"fileHash": "string",
"minDynatraceVersion": "string",
"minEECVersion": "string",
"variables": [
"string"
],
"version": "1.2.3"
}