Изменение фильтра

Изменяет настройки указанного фильтра счетчика.

Request

PUT

https://api-metrika.yandex.net/management/v1/counter/{counterId}/filter/{filterId}

Path parameters

Name

Description

counterId

Type: integer

Идентификатор счетчика, фильтр которого вы хотите изменить.

filterId

Type: integer

Идентификатор фильтра, настройки которого вы хотите изменить.

Body

application/json
{
  "filter": {
    "id": 0,
    "attr": "example",
    "type": "example",
    "value": "example",
    "action": "example",
    "status": "example",
    "start_ip": "example",
    "end_ip": "example",
    "with_subdomains": true
  }
}

Name

Description

filter

Type: FilterE

Фильтр.

Example
{
  "id": 0,
  "attr": "example",
  "type": "example",
  "value": "example",
  "action": "example",
  "status": "example",
  "start_ip": "example",
  "end_ip": "example",
  "with_subdomains": true
}

FilterE

Фильтр.

Name

Description

action

Type: string

Тип фильтра:

  • exclude — исключить трафик.
  • include — оставить только трафик.

Example: example

attr

Type: string

Тип данных, к которым применяется фильтр:

  • title — заголовок страницы.
  • client_ip — IP-адрес.
  • url — URL страницы.
  • referer — реферер.
  • uniq_id — специальный атрибут для фильтра не учитывать мои визиты.

Example: example

status

Type: string

Статус фильтра:

  • active — фильтр используется.
  • disabled — фильтр отключен (без удаления).

Example: example

type

Type: string

Отношение или действие для фильтра:

  • equal — равно.
  • start — начинается с.
  • contain — содержит.
  • interval — в интервале, используется только с типом данных «IP-адрес» (attr = client_ip).
  • me — мои посещения, используется только с типом данных attr = uniq_id.
  • only_mirrors — только сайт и зеркала, используется только для типа данных «URL страницы» (attr = url) и типа фильтра оставить только трафик (action = include), а также при условии, что для счетчика заданы зеркала.
  • regexp — регулярное выражение.

Example: example

end_ip

Type: string

Последний IP-адрес диапазона.

Example: example

id

Type: integer

Идентификатор фильтра. Укажите данный параметр при изменении фильтра счетчика.

start_ip

Type: string

Первый IP-адрес диапазона.

Example: example

value

Type: string

Значение фильтра.

Example: example

with_subdomains

Type: boolean

Фильтровать по поддоменам:

  • 0 — не фильтровать по поддоменам (по умолчанию);
  • 1 — фильтровать по поддоменам.

Example
{
  "id": 0,
  "attr": "example",
  "type": "example",
  "value": "example",
  "action": "example",
  "status": "example",
  "start_ip": "example",
  "end_ip": "example",
  "with_subdomains": true
}

Responses

200 OK

OK

Body

application/json
{
  "filter": {
    "id": 0,
    "attr": "example",
    "type": "example",
    "value": "example",
    "action": "example",
    "status": "example",
    "start_ip": "example",
    "end_ip": "example",
    "with_subdomains": true
  }
}

Name

Description

filter

Type: FilterE

Фильтр.

Example
{
  "id": 0,
  "attr": "example",
  "type": "example",
  "value": "example",
  "action": "example",
  "status": "example",
  "start_ip": "example",
  "end_ip": "example",
  "with_subdomains": true
}