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