# Изменение правила Внешних сетей

#|
|| PATCH | `/routing/wan_rules/<id правила>` ||
|#

* `id` - идентификатор правила.

### Json-тело запроса (все или некоторые поля)

```json5
{
  "name": "string",
  "comment": "string",
  "enabled": true | false,
  "incoming_interface": "string",
  "source_negate": true | false,
  "source": ["string"],
  "destination_negate": true | false,
  "destination": ["string"],
  "nexthop": "string",
  "protocol": "string",
  "source_ports": ["string"],
  "destination_ports": ["string"],
  "source_ports_negate": true | false,
  "destination_ports_negate": true | false
}
```

#|
|| **Параметр** | **Тип** | **Описание** ||
|| `name` | string | Название правила, максимальная длина - 42 символа. Может быть пустым ||
|| `comment` | string | Комментарий пользователя, максимальная длина - 256 символов. Может быть пустым ||
|| `enabled` | boolean | Состояние маршрута:

- `true` - включено
- `false` - выключено

||
|| `incoming_interface` | string | Идентификатор объекта. Допустимые типы:

- `any` - любой интерфейс
- `interface.id.` - идентификатор конкретного интерфейса
- `zone.id.` - идентификатор зоны

||
|| `source_negate` | boolean | Инвертирование настроек источника:

- `true` - включено
- `false` - выключено

||
|| `source` | array | Источник трафика, задается через объекты. Допустимые типы:

- `any` - любой источник
- `address_list.id.` - идентификатор объекта **Список IP-адресов**
- `domain.id.` - идентификатор объекта **Домен**
- `quota.exceeded` - лимит превышен
- `group.id.` - идентификатор группы пользователей
- `ip_address_list.id.` - идентификатор объекта **Список IP-адресов**
- `ip.id.` - идентификатор объекта **IP-адрес**
- `ip_range.id.` - идентификатор объекта **Диапазон IP-адресов**
- `iplist.` - идентификатор списка IP-адресов
- `list_of_iplists.id.` - идентификатор объекта **Список стран и континентов**
- `security_group.guid.` - идентификатор группы безопасности
- `subnet.id.` - идентификатор объекта **Подсеть**
- `user.id.` - идентификатор пользователя
- `ldap_filter.id.` - идентификатор LDAP-фильтра
- `ad_user.guid.` - идентификатор пользователя Active Directory
- `all_ad_users` - все пользователи Active Directory
- `all_ad_trusted_users` - все доверенные пользователи Active Directory
- `zero_subnet` - нулевая подсеть (0.0.0.0/0)

||
|| `destination_negate` | boolean | Инвертирование настроек сети назначения:

- `true` - включено
- `false` - выключено

||
|| `destination` | array | Сеть назначения, задается через объекты. Допустимые типы совпадают с типами поля `source` ||
|| `nexthop` | string | IP-адрес шлюза или объект одного из допустимых типов:

- `ip.id.` - идентификатор объекта **IP-адрес**
- `nexthop.id.` - идентификатор Next hop
- `nexthop_group.id.` - идентификатор профиля next hop
- `nexthop_group.id.static.` - идентификатор профиля next hop в статическом режиме

||
|| `protocol` | string | Идентификатор протокола ||
|| `source_ports` | array | Список портов источника, допустимые типы:

- `any` - любой порт
- `port.id` - идентификатор объекта **Порт**
- `port_list.id` - идентификатор объекта **Порты** (список объектов)
- `port_range.id` - идентификатор объекта **Диапазон объектов**

||
|| `destination_ports` | array | Список портов назначения. Допустимые типы совпадают с типами поля `source_ports` ||
|| `source_ports_negate` | boolean | Инвертирование адреса источника:

- `true` - включено
- `false` - выключено

||
|| `destination_ports_negate` | boolean | Инвертирование портов назначения:

- `true` - включено
- `false` - выключено

||
|#


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

Код ответа: **200 ОК**
