Получение расширения: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Функция выводит список свойств указанного расширения Extensions 2.0 или загружает ZIP-файл расш...») |
ENetrebin (обсуждение | вклад) |
||
(не показана 1 промежуточная версия этого же участника) | |||
Строка 20: | Строка 20: | ||
== Аутентификация == | == Аутентификация == | ||
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия '''Read extensions''' ( <code>extensions.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] . | Чтобы выполнить этот запрос , вам нужен токен доступа с областью действия '''Read extensions''' ( <code>extensions.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] . | ||
== Параметры == | == Параметры == | ||
Строка 125: | Строка 125: | ||
|minDynatraceVersion | |minDynatraceVersion | ||
|string | |string | ||
|Минимальная версия | |Минимальная версия Dynatrace, которая работает с расширением | ||
Может быть <code>null</code>. | Может быть <code>null</code>. |
Текущая версия на 15:17, 24 января 2023
Функция выводит список свойств указанного расширения 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"
}