List

Список оповещений. Параметры передаются в теле запроса, поэтому используется метод POST.

Эндпоинт

POST /vision/api/v1/alerts/

Параметры запроса

Параметр Тип Обязательный Описание

filters

array

Условия фильтрации

limit

int

Размер страницы, 1–1000 (при 0 или null возвращается 100)

offset

int

Сколько записей пропустить от начала списка (при null — 0)

orders

array

Правила сортировки

Пример запроса

{
  "filters": [
    { "operator": "EQUALS", "names": ["is_ended"], "values": [false] },
    { "operator": "IN", "names": ["object_id"], "values": ["mbdp_host", "mbdp_vm"] },
    { "operator": "BETWEEN", "names": ["fired_at"], "values": ["2026-06-01T00:00:00Z", "2026-06-11T00:00:00Z"] }
  ],
  "orders": [
    { "name": "fired_at", "direction": "DESC" }
  ],
  "limit": 100,
  "offset": 0
}

Пример ответа

{
  "status": "string",
  "data": [
    {
      "id": 0,
      "trigger_id": 0,
      "is_ended": true,
      "labels": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "annotations": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "pended_at": "2026-06-11T09:00:25.127Z",
      "fired_at": "2026-06-11T09:00:25.127Z",
      "resolved_at": "2026-06-11T09:00:25.127Z",
      "duration": 0,
      "object_id": "string"
    }
  ],
  "message": {
    "text": "string",
    "type": "string",
    "extra": "string"
  },
  "next_offset": 0,
  "total_count": 0,
  "error": {
    "name": "string",
    "desc": "string",
    "detail": "string"
  }
}

Условие фильтрации

Каждый элемент массива filters — объект с обязательными полями names, operator и values:

names

Массив названий полей оповещения, к которым применяется условие. Для вложенных полей labels и annotations используется точечная нотация: labels.<ключ>, annotations.<ключ>.

operator

Оператор сравнения. Допустимые операторы и сочетания полей со значениями приведены в таблице ниже.

values

Массив значений для сравнения.

Оператор Допустимые названия полей Тип значений Количество значений и ограничения

BETWEEN

duration

int

Чётное количество значений (не меньше двух). Одна из границ может иметь значение null

  • fired_at;

  • pended_at;

  • resolved_at

datetime

Чётное количество значений (не меньше двух). Одна из границ может иметь значение null

CONTAINS

annotations.<ключ>; labels.<ключ>

string

Одно или несколько значений; пустые строки недопустимы

EQUALS

is_ended

boolean

Ровно одно значение

labels.<ключ>

string

Ровно одно значение

IN

is_ended

boolean

Одно или несколько значений

object_id; labels.<ключ>

string

Одно или несколько значений

NOT_CONTAINS

  • annotations.<ключ>;

  • labels.<ключ>

string

Одно или несколько значений; пустые строки недопустимы

NOT_IN

object_id; labels.<ключ>

string

Одно или несколько значений

В поле names операторов CONTAINS и NOT_CONTAINS можно указать несколько полей. Остальные операторы принимают в names ровно одно поле.

Правило сортировки

Каждый элемент массива orders — объект с обязательными полями name и direction:

name

Имя поля сортировки. Допустимые поля:

  • duration;

  • fired_at;

  • id;

  • is_ended;

  • object_id;

  • pended_at;

  • resolved_at;

  • annotations.<ключ> и labels.<ключ> в точечной нотации.

direction

Направление сортировки:

  • ASC — по возрастанию;

  • DESC — по убыванию.

Поля оповещения

В поле data — массив оповещений, каждое из которых содержит поля:

annotations

Аннотации оповещения в формате ключ-значение.

duration

Длительность оповещения в секундах.

fired_at

Дата и время срабатывания оповещения.

id

Идентификатор оповещения.

is_ended

Признак того, завершено ли оповещение: true — завершено, false — ещё активно.

labels

Метки оповещения в формате ключ-значение.

object_id

Идентификатор объекта мониторинга, к которому относится оповещение.

pended_at

Дата и время перехода оповещения в состояние ожидания.

resolved_at

Дата и время снятия оповещения.

trigger_id

Идентификатор правила, по которому сработало оповещение.