---
canonical: https://docs.ideco.ru/v22/ru/ngfw/api/monitor-ip-blocking-api
---



# Блокировки WAF

::: page-constructor
blocks:
  - type: content-layout-block
    textContent:
      buttons:
        - text: Классический VCE
          theme: action
          width: 'auto'
        - text: Высокопроизводительный VCE
          theme: outlined
          url: https://docs.ideco.ru/api/vpp-v22/ru/ngfw/monitor-api/ip-blocking/
          width: 'auto'
        - text: Документация
          theme: outlined
          url: https://docs.ideco.ru/v22/ru/ngfw/settings/monitor/ip-blocking
          width: 'auto'
    resetPaddings: false
    textWidth: l
    size: m
    centered: false
:::

{% cut "Получение списка блокировок IP" %}{#poluchenie-spiska-blokirovok-ip}

```
GET /waf/blocked?<GET-параметры, разделенные знаком &>`
```

Перечень необязательных GET-параметров:

* `limit: integer` - ограничение на количество срабатываний (строк). Минимальное значение - `1`;
* `offset: integer` - количество строк, которые необходимо пропустить до вывода записи. Минимальное значение - `0`.

**Ответ на успешный запрос:**

```json5
{
  "meta": [
      {
        "name": "string",
        "type": "string"
      }
  ],
  "data": [
      {
        "id": "string",
        "ip_address": "string",
        "date_time": "integer",
        "block_sensor": "string",
        "time_left": "integer"
      },
      ...
  ],
  "rows": "integer",
  "rows_before_limit_at_least": "integer"
}
```

* `meta` - массив метаданных, описывающих поля запроса:
  * `name` - имя поля данных;
  * `type` - тип данных.
* `data` - список заблокированных IP-адресов в виде объектов с данными по одной блокировке:
  * `id` - идентификатор срабатывания профиля;
  * `ip_address` - заблокированный IP-адрес;
  * `date_time` - дата и время, когда указанный IP-адрес был заблокирован;
  * `block_sensor` - источник блокировки;
  * `time_left` - количество секунд, оставшееся до окончания блокировки.
* `rows` - количество объектов `data`;
* `rows_before_limit_at_least` - общее количество строк без учета `limit` и `offset`. Если в параметрах запроса отсутствуют `limit` и `offset`, поле `rows_before_limit_at_least` в ответе на запрос будет отсутствовать.

{% endcut %}

{% cut "Снятие блокировки с IP-адреса" %}{#snyatie-blokirovki-s-ip-adresa}

```
POST /waf/unblock
```

**Json-тело запроса:**

```json5
{
  "ip_address": "string"
}
```

* `ip_address` - IP-адрес, который необходимо разблокировать.

**Ответ на успешный запрос:** 200 ОК

{% endcut %}
