Размещение файла расширения
Данная функция загружает файл расширения Extensions 2.0 в вашу среду Ключ-АСТРОМ.
Запрос потребляет 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 | Минимальная версия Ключ-АСТРОМ, которая работает с расширением
Может быть |
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"
}