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 | Error | Failed. The requested resource doesn't exist. |
406 | Error | Not acceptable |
Response body objects
The Extension
object
Element | Type | Description |
---|---|---|
extensionName | string | Extension name Can be |
version | string | Extension version Can be |
author | Author | Extension author Can be |
dataSources | string[] | Data sources that extension uses to gather data Can be |
variables | string[] | Custom variables used in extension configuration Can be |
featureSets | string[] | Available feature sets Can be |
featureSetsDetails | object | Details of feature sets Can be |
minDynatraceVersion | string | Minimal Dynatrace version that works with the extension Can be |
fileHash | string | SHA-256 hash of uploaded Extension file Can be |
The AuthorDto
object
Extension author
Element | Type | Description |
---|---|---|
name | string | Author name Can be |
The FeatureSetDetails
object
Additional information about a Feature Set
Element | Type | Description |
---|---|---|
metrics | Metric | Feature set metrics Can be |
The MetricDto
object
Metric gathered by an extension
Element | Type | Description |
---|---|---|
key | string | Metric key Can be |
Response body JSON model
{
"extensionName": "string",
"version": "1.2.3",
"author": {
"name": "string"
},
"dataSources": [
"string"
],
"variables": [
"string"
],
"featureSets": [
"string"
],
"featureSetsDetails": {},
"minDynatraceVersion": "string",
"fileHash": "string"
}