Получение расширения
Функция выводит список свойств указанного расширения Extensions 2.0 или загружает ZIP-файл расширения.
Запрос создает один из следующих типов полезной нагрузки, в зависимости от значения заголовка запроса Accept :
application/json— полезная нагрузка JSON, содержащая свойства расширения.application/octet-stream— загрузка ZIP-файла расширения.
Если с запросом не предоставлен заголовок Acceptapplication/json , возвращается полезная нагрузка.
| 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}
| |
| Окружающая среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/{extensionVersion}
|
Аутентификация
Чтобы выполнить этот запрос , вам нужен токен доступа с областью действия Read extensions ( extensions.read) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | В | Необходимый |
|---|---|---|---|---|
| extensionName | string | Имя запрошенного расширения 2.0. | path | требуется |
| extensionVersion | string | Версия запрашиваемого расширения 2.0 | path | требуется |
| Accept | string | Принять заголовок. Указывает часть расширения 2.0, которая будет возвращена:
|
заголовок | по желанию |
Ответ
Коды ответов
| Код | Тип | Описание |
|---|---|---|
| 200 | Extension | Успех |
| 404 | ErrorEnvelope | Не удалось. Запрошенный ресурс не существует. |
| 406 | ErrorEnvelope | Неприемлимо |
Объекты тела ответа
Объект _ ResponseBody
| Элемент | Тип | Описание |
|---|---|---|
| имя_расширения | string | Имя расширения
Может быть |
| version | string | Версия расширения
Может быть |
| author | AuthorDto | Автор расширения
Может быть |
| dataSources | string[] | Источники данных, которые расширение использует для сбора данных
Может быть |
| переменные | string[] | Пользовательские переменные, используемые в конфигурации расширения
Может быть |
| наборы функций | string[] | Доступные наборы функций
Может быть |
| featureSetsДетали | object | Подробная информация о наборах функций
Может быть |
| minDynatraceVersion | string | Минимальная версия Dynatrace, которая работает с расширением
Может быть |
| fileHash | string | Хэш SHA-256 загруженного файла расширения
Может быть |
Объект AuthorDto
Автор расширения
| Элемент | Тип | Описание |
|---|---|---|
| name | string | Имя автора
Может быть |
Объект FeatureSetDetails
Дополнительная информация о наборе функций
| Элемент | Тип | Описание |
|---|---|---|
| metrics | 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"
}