Размещение файла расширения
Данная функция загружает файл расширения Extensions 2.0 в вашу среду Dynatrace.
Запрос потребляет multipart/form-dataполезную нагрузку и создает application/jsonполезную нагрузку.
| POST | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/extensions
|
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/extensions
| |
| Окружающая среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Write extensions ( extensions.write) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | In | Необходимость |
|---|---|---|---|---|
| File | zip.file | Файл пакета расширения 2.0 ( *.zip) для загрузки. Должен содержать только расширение zipи .zip.sigфайлы.
|
body | требуется |
Ответ
Коды ответов
| Код | Тип | Описание |
|---|---|---|
| 200 | Extension | Расширение действительно |
| 201 | Extension | Успех. Расширение 2.0 загружено. |
| 400 | ErrorEnvelope | Не удалось. Входной файл недействителен. |
| 409 | ErrorEnvelope | Загрузка пока невозможна, повторите попытку через несколько секунд. |
Объекты тела ответа
Объект ResponseBody
| Элемент | Тип | Описание |
|---|---|---|
| extensionName | string | Имя расширения
Может быть |
| version | string | Версия расширения
Может быть |
| author | AuthorDto | Автор расширения
Может быть |
| dataSources | string[] | Источники данных, которые расширение использует для сбора данных
Может быть |
| variables | string[] | Пользовательские переменные, используемые в конфигурации расширения
Может быть |
| featureSets | string[] | Доступные наборы функций
Может быть |
| featureSetsDetails | object | Подробная информация о наборах функций
Может быть |
| minDynatraceVersion | string | Минимальная версия Dynatrace, которая работает с расширением
Может быть |
| fileHash | string | Хэш SHA-256 загруженного файла расширения
Может быть |
Объект AuthorDto
Автор расширения
| Элемент | Тип | Описание |
|---|---|---|
| name | string | Имя автора
Может быть |
Объект FeatureSetDetails
Дополнительная информация о наборе функций
| Элемент | Тип | Описание |
|---|---|---|
| показатели | MetricDto[] | Показатели набора функций
Может быть |
Объект MetricDto
Метрика, собранная расширением
| Элемент | Тип | Описание |
|---|---|---|
| key | string | Метрический ключ
Может быть |
| metadata | MetricMetadataDto | Метаданные показателей
Может быть |
Объект MetricMetadataDto
Метаданные показателей
| Элемент | Тип | Описание |
|---|---|---|
| displayName | string | Название метрики в пользовательском интерфейсе
Может быть |
| description | string | Краткое описание метрики
Может быть |
| unit | string | Единица измерения
Может быть |
JSON-модель тела ответа
{
"extensionName": "string",
"version": "1.2.3",
"author": {
"name": "string"
},
"dataSources": [
"string"
],
"variables": [
"string"
],
"featureSets": [
"string"
],
"featureSetsDetails": {},
"minDynatraceVersion": "string",
"fileHash": "string"
}