Extensions 2.0 API - POST an extension file
Uploads an Extensions 2.0 extension file to your Dynatrace environment.
The request consumes a multipart/form-data payload and produces an application/json payload.
| POST | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v2/extensions |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/extensions | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions |
Authentication
To execute this request, you need an access token with extensions.write scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| file | .zip file | Extension 2.0 package file (*.zip) to be uploaded. Must contain only extension zip and .zip.sig files. | body | required |
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 200 | Extension | The extension is valid |
| 201 | Extension | Success. The extension 2.0 has been uploaded. |
| 400 | ErrorEnvelope | Failed. The input file is invalid. |
| 409 | ErrorEnvelope | Upload not possible yet, please try again in a few seconds. |
Response body objects
The ExtensionUploadResponseDto 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 |
| assetsInfo | Asset | Information about extension assets included |
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 |
The AssetInfo object
Assets types and its count
| Element | Type | Description |
|---|---|---|
| assetType | string | - |
| count | integer | - |
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",
"assetsInfo": [
{
"assetType": "string",
"count": 1
}
]
}