Размещение файла расширения: различия между версиями

Текущая версия от 21:00, 25 декабря 2024

Данная функция загружает файл расширения Extensions 2.0 в вашу среду АппОптима.

Запрос потребляет multipart/form-dataполезную нагрузку и создает application/jsonполезную нагрузку.

POST	АппОптима	`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	Имя расширения Может быть `null`.
version	string	Версия расширения Может быть `null`.
author	AuthorDto	Автор расширения Может быть `null`.
dataSources	string[]	Источники данных, которые расширение использует для сбора данных Может быть `null`.
variables	string[]	Пользовательские переменные, используемые в конфигурации расширения Может быть `null`.
featureSets	string[]	Доступные наборы функций Может быть `null`.
featureSetsDetails	object	Подробная информация о наборах функций Может быть `null`.
minDynatraceVersion	string	Минимальная версия АппОптима, которая работает с расширением Может быть `null`.
fileHash	string	Хэш SHA-256 загруженного файла расширения Может быть `null`.

Объект `AuthorDto`

Автор расширения

Элемент	Тип	Описание
name	string	Имя автора Может быть `null`.

Объект `FeatureSetDetails`

Дополнительная информация о наборе функций

Элемент	Тип	Описание
показатели	MetricDto[]	Показатели набора функций Может быть `null`.

Объект `MetricDto`

Метрика, собранная расширением

Элемент	Тип	Описание
key	string	Метрический ключ Может быть `null`.
metadata	MetricMetadataDto	Метаданные показателей Может быть `null`.

Объект `MetricMetadataDto`

Метаданные показателей

Элемент	Тип	Описание
displayName	string	Название метрики в пользовательском интерфейсе Может быть `null`.
description	string	Краткое описание метрики Может быть `null`.
unit	string	Единица измерения Может быть `null`.

JSON-модель тела ответа

<{
  "extensionName": "string",
  "version": "1.2.3",
  "author": {
    "name": "string"
  },
  "dataSources": [
    "string"
  ],
  "variables": [
    "string"
  ],
  "featureSets": [
    "string"
  ],
  "featureSetsDetails": {},
  "minDynatraceVersion": "string",
  "fileHash": "string"
}

@@ Строка 1: / Строка 1: @@
-Данная функция загружает файл расширения Extensions 2.0 в вашу среду Ключ-АСТРОМ.
+Данная функция загружает файл расширения Extensions 2.0 в вашу среду АппОптима.
 Запрос потребляет <code>multipart/form-data</code>полезную нагрузку и создает <code>application/json</code>полезную нагрузку.
 {| class="wikitable"
 | rowspan="3" |POST
-|Managed
+|АппОптима
 |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/extensions</nowiki></code>
 |-
@@ Строка 26: / Строка 26: @@
 |-
 |File
-|ZIP.file
+|zip.file
 |Файл пакета расширения 2.0 ( <code>*.zip</code>) для загрузки. Должен содержать только расширение <code>zip</code>и <code>.zip.sig</code>файлы.
 |body
@@ Строка 109: / Строка 109: @@
 |minDynatraceVersion
 |string
-|Минимальная версия Ключ-АСТРОМ, которая работает с расширением
+|Минимальная версия АппОптима, которая работает с расширением
 Может быть <code>null</code>.
@@ Строка 195: / Строка 195: @@
 === JSON-модель тела ответа ===
-  <code>{
+  <{
     "extensionName": "string",
     "version": "1.2.3",