community.network.ce_acl_advance – Управляет расширенной конфигурацией ACL на коммутаторах HUAWEI CloudEngine.

Примечание

Этот плагин входит в коллекцию community.network (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.network.

Для использования в плейбуке укажите: community.network.ce_acl_advance.

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Управляет расширенными конфигурациями ACL на коммутаторах HUAWEI CloudEngine.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
acl_description строка		Описание ACL. Значение — строка от 1 до 127 символов.
acl_name строка / обязательно		Номер или имя ACL. Для группы правил с номером, значение от 3000 до 3999 указывает на расширенный ACL. Для группы правил с именем, значение — строка от 1 до 32 символов, чувствительная к регистру, начинающаяся с буквы, пробелы не поддерживаются.
acl_num строка		Номер ACL. Значение — целое число от 3000 до 3999.
acl_step строка		Шаг ACL. Значение — целое число от 1 до 20. Значение по умолчанию — 5.
dest_ip строка		Адрес назначения IP. Значение — строка от 0 до 255 символов. Значение по умолчанию — 0.0.0.0. Значение в формате с точками.
dest_mask строка		Маска адреса назначения IP. Значение — целое число от 1 до 32.
dest_pool_name строка		Имя пула назначения. Значение — строка от 1 до 32 символов.
dest_port_begin строка		Начальный номер порта назначения. Значение — целое число от 0 до 65535.
dest_port_end строка		Конечный номер порта назначения. Значение — целое число от 0 до 65535.
dest_port_op строка	Варианты: lt eq gt range	Тип диапазона порта назначения.
dest_port_pool_name строка		Имя пула портов назначения. Значение — строка от 1 до 32 символов.
dscp строка		Значение точки кода дифференцированных сервисов. Значение — целое число от 0 до 63.
established логическое значение	Варианты: нет ← да	Соответствие установленным соединениям.
frag_type строка	Варианты: фрагмент удалить_фрагмент	Тип фрагментации пакетов.
icmp_code строка		Код сообщения ICMP. Пакеты данных могут быть отфильтрованы на основе кода сообщения ICMP. Значение — целое число от 0 до 255.
icmp_name строка	Варианты: неконфигурировано эхо ответ_эхо необходимость_фрагментации-DFset перенаправление_хоста перенаправление_хоста_TOS недоступность_хоста ответ_информации запрос_информации перенаправление_сети перенаправление_сети_TOS недоступность_сети проблема_параметра недоступность_порта недоступность_протокола тайм-аут_сборки запрет_источника неудачное_маршрутизирование_источника ответ_времени_отклика запрос_времени_отклика исчерпан_TTL ответ_адреса_маски запрос_адреса_маски настраиваемое	Имя ICMP.
icmp_type строка		Тип ICMP. Этот параметр доступен только когда протокол пакета — ICMP. Значение — целое число от 0 до 255.
igmp_type строка	Варианты: запрос_хоста реклама_mrouter запрос_mrouter прекращение_mrouter ответ_mtrace маршрут_mtrace отчёт_хоста_v1 отчёт_хоста_v2 выход_из_группы_v2 отчёт_хоста_v3	Протокол управления группами в интернете.
log_flag логическое значение	Варианты: нет ← да	Флаг регистрации совпавших пакетов данных.
precedence строка		Пакеты данных могут быть отфильтрованы на основе поля приоритета. Значение — целое число от 0 до 7.
protocol строка	Варианты: ip icmp igmp ipinip tcp udp gre ospf	Тип протокола.
rule_action строка	Варианты: разрешить запретить	Режим соответствия правилам основных ACL.
rule_description строка		Описание правила ACL.
rule_id строка		Идентификатор основного правила ACL в режиме конфигурации. Значение — целое число от 0 до 4294967294.
rule_name строка		Имя основного правила ACL. Значение — строка от 1 до 32 символов.
source_ip строка		Адрес источника IP. Значение — строка от 0 до 255 символов. Значение по умолчанию — 0.0.0.0. Значение в формате с точками.
src_mask строка		Маска адреса источника IP. Значение — целое число от 1 до 32.
src_pool_name строка		Имя пула источника. Значение — строка от 1 до 32 символов.
src_port_begin строка		Начальный номер порта источника. Значение — целое число от 0 до 65535.
src_port_end строка		Конечный номер порта источника. Значение — целое число от 0 до 65535.
src_port_op строка	Варианты: lt eq gt range	Тип диапазона порта источника.
src_port_pool_name строка		Имя пула портов источника. Значение — строка от 1 до 32 символов.
state строка	Варианты: существующий ← отсутствующий удалить_acl	Указывает желаемое состояние ресурса.
syn_flag строка		Значение флага TCP. Значение — целое число от 0 до 63.
tcp_flag_mask строка		Значение маски флага TCP. Значение — целое число от 0 до 63.
time_range строка		Имя временного диапазона, в котором правило ACL вступает в силу.
tos строка		Значение TOS, на основе которого фильтруются пакеты данных. Значение — целое число от 0 до 15.
ttl_expired логическое значение	Варианты: нет ← да	Соответствие истекшему TTL, со значением TTL 1.
vrf_name строка		Имя VPN-инстанса. Значение — строка от 1 до 31 символа. Значение по умолчанию — _public_.

Примечания

Примечание

Для этого модуля требуется включение службы netconf на удаленном управляемом устройстве.
Рекомендуемое соединение — netconf.
Этот модуль также работает с local соединениями для плейбуков старого типа.

Примеры

- name: CloudEngine advance acl test
  hosts: cloudengine
  connection: local
  gather_facts: no
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:

  - name: "Config ACL"
    community.network.ce_acl_advance:
      state: present
      acl_name: 3200
      provider: "{{ cli }}"

  - name: "Undo ACL"
    community.network.ce_acl_advance:
      state: delete_acl
      acl_name: 3200
      provider: "{{ cli }}"

  - name: "Config ACL advance rule"
    community.network.ce_acl_advance:
      state: present
      acl_name: test
      rule_name: test_rule
      rule_id: 111
      rule_action: permit
      protocol: tcp
      source_ip: 10.10.10.10
      src_mask: 24
      frag_type: fragment
      provider: "{{ cli }}"

  - name: "Undo ACL advance rule"
    community.network.ce_acl_advance:
      state: absent
      acl_name: test
      rule_name: test_rule
      rule_id: 111
      rule_action: permit
      protocol: tcp
      source_ip: 10.10.10.10
      src_mask: 24
      frag_type: fragment
      provider: "{{ cli }}"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
changed boolean	всегда	проверка, было ли произведено изменение на устройстве Пример: True
end_state словарь	всегда	пара ключ/значение параметров aaa после выполнения модуля
existing словарь	всегда	пара ключ/значение существующего сервера aaa Пример: {'aclNumOrName': 'test', 'aclType': 'Advance'}
proposed словарь	всегда	пара ключ/значение параметров, переданных в модуль Пример: {'acl_name': 'test', 'state': 'delete_acl'}
updates список / элементы=строка	всегда	команда, отправленная на устройство Пример: ['undo acl name test']

Авторы

wangdezhuang (@QijunPan)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/ce_acl_advance_module.html