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 |
---|---|---|
assetsInfo | Asset | Information about extension assets included |
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 AssetInfo
object
Assets types and its count
Element | Type | Description |
---|---|---|
assetType | string | - |
count | integer | - |
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
{
"assetsInfo": [
{
"assetType": "string",
"count": 1
}
],
"author": {
"name": "string"
},
"dataSources": [
"string"
],
"extensionName": "string",
"featureSets": [
"string"
],
"featureSetsDetails": {},
"fileHash": "string",
"minDynatraceVersion": "string",
"minEECVersion": "string",
"variables": [
"string"
],
"version": "1.2.3"
}