GET списка событий - Расширения 2.0

API АппОптима / Эндпойнты среды / Развёртывание / Расширения 2.0 / Конфигурация среды / GET списка событий

Функция возвращает список событий, связанных с указанной конфигурацией среды.

Запрос создает application/jsonполезную нагрузку.

GET	АппОптима	`https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration/events`
GET	Среда АктивногоШлюза	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/environmentConfiguration/events`

Аутентификация

Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение конфигураций среды расширения ( extensionEnvironment.read) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Параметр	Тип	Описание	In	Необходимость
extensionName	string	Имя запрошенного расширения 2.0.	path	требуется
from	string	Начало запрошенного таймфрейма. Вы можете использовать один из следующих форматов: Отметка времени в миллисекундах UTC. Читаемый формат `2021-01-25T05:57:01.123+01:00`. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо `T`. Секунды и доли секунды не являются обязательными. Относительный таймфрейм, назад. Формат: `now-NU/A`, где `N`количество времени, `U`единица времени и `A`выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, `now-1y/w`это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: `now-NU`. Поддерживаемые единицы времени для относительного таймфрейма: `m`: минуты `h`: часы `d`: дни `w`: недели `M`: месяцы `y`: годы Если не установлено, используется относительный таймфрейм в два часа ( `now-2h`).	запрос	по желанию
to	string	Конец запрошенного периода времени. Вы можете использовать один из следующих форматов: Отметка времени в миллисекундах UTC. Читаемый формат `2021-01-25T05:57:01.123+01:00`. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо `T`. Секунды и доли секунды не являются обязательными. Относительный таймфрейм, назад. Формат: `now-NU/A`, где `N`количество времени, `U`единица времени и `A`выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, `now-1y/w`это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: `now-NU`. Поддерживаемые единицы времени для относительного таймфрейма: `m`: минуты `h`: часы `d`: дни `w`: недели `M`: месяцы `y`: годы Если не установлено, используется текущая метка времени.	запрос	по желанию
content	string	Содержание мероприятия	запрос	по желанию
status	string	Статус события Элемент может содержать эти значения `ERROR` `INFO` `NONE` `WARN`	запрос	по желанию

Схемы расширения

Коды ответов

Код	Тип	Описание
200	ExtensionEventsList	Список последних событий конфигурации среды расширения
404	ErrorEnvelope	Не удалось. Запрошенный ресурс не существует.

Объекты тела ответа

Объект `ResponseBody`

Элемент	Тип	Описание
extensionEvents	ExtensionEventDto[]	Список событий расширения. Может быть `null`.

Объект `ExtensionEventDto`

Список событий расширения.

Элемент	Тип	Описание
timestamp	string	Отметка времени события Может быть `null`.
severity	string	Серьезность события Может быть `null`.
content	string	Содержание мероприятия Может быть `null`.
dt.entity.host	string	Хост, который использует эту конфигурацию мониторинга. Пример:`HOST-ABCDEF0123456789` Может быть `null`.
dt.active_gate.id	string	Шестнадцатеричный идентификатор Active Gate, который использует эту конфигурацию мониторинга. Пример:`0x1a2b3c4d` Может быть `null`.
dt.extension.ds	string	Источник данных, который использует эту конфигурацию мониторинга. Пример:`snmp` Может быть `null`.
status	string	Статус события Элемент может содержать эти значения Может быть `null`.

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

<{
  "extensionEvents": [
    {
      "timestamp": "string",
      "severity": "string",
      "content": "string",
      "dt.entity.host": "string",
      "dt.active_gate.id": "string",
      "dt.extension.ds": "string",
      "status": "ERROR"
    }
  ]
}