ce_acl – Управляет базовой конфигурацией ACL на коммутаторах HUAWEI CloudEngine

Новая версия с 2.4.

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
acl_description -		Описание ACL. Значение — строка от 1 до 127 символов.
acl_name - / обязательно		Номер или имя ACL. Для группы правил с номером, значение от 2000 до 2999 указывает на базовый ACL. Для группы правил с именем, значение — строка от 1 до 32 символов, чувствительная к регистру, начинающаяся с буквы, пробелы не поддерживаются.
acl_num -		Номер ACL. Значение — целое число от 2000 до 2999.
acl_step -		Шаг ACL. Значение — целое число от 1 до 20. Значение по умолчанию — 5.
frag_type -	Варианты: fragment clear_fragment	Тип фрагментации пакетов.
log_flag boolean	Варианты: нет ← да	Флаг протоколирования совпадающих пакетов данных.
rule_action -	Варианты: разрешить запретить	Режим сопоставления правил базового ACL.
rule_description -		Описание правила ACL. Значение — строка от 1 до 127 символов.
rule_id -		Идентификатор правила базового ACL в режиме конфигурации. Значение — целое число от 0 до 4294967294.
rule_name -		Имя правила базового ACL. Значение — строка от 1 до 32 символов. Значение нечувствительно к регистру и не может содержать пробелы или начинаться с символа подчёркивания (_).
source_ip -		IP-адрес источника. Значение — строка от 0 до 255 символов. Значение по умолчанию — 0.0.0.0. Значение в формате точка-десятичная.
src_mask -		Маска IP-адреса источника. Значение — целое число от 1 до 32.
state -	Варианты: присутствует ← отсутствует удалить_acl	Указывает желаемое состояние ресурса.
time_range -		Имя временного интервала, в котором действует правило ACL. Значение — строка от 1 до 32 символов. Значение нечувствительно к регистру и не может содержать пробелы. Имя должно начинаться с заглавной или строчной буквы. Кроме того, слово «все» не может быть указано как имя временного интервала.
vrf_name -		Имя виртуальной сети. Значение — строка от 1 до 31 символа. Значение по умолчанию — _public_.

Примечания

Примечание

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

Примеры

- name: CloudEngine 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"
    ce_acl:
      state: present
      acl_name: 2200
      provider: "{{ cli }}"

  - name: "Undo ACL"
    ce_acl:
      state: delete_acl
      acl_name: 2200
      provider: "{{ cli }}"

  - name: "Config ACL base rule"
    ce_acl:
      state: present
      acl_name: 2200
      rule_name: test_rule
      rule_id: 111
      rule_action: permit
      source_ip: 10.10.10.10
      src_mask: 24
      frag_type: fragment
      time_range: wdz_acl_time
      provider: "{{ cli }}"

  - name: "undo ACL base rule"
    ce_acl:
      state: absent
      acl_name: 2200
      rule_name: test_rule
      rule_id: 111
      rule_action: permit
      source_ip: 10.10.10.10
      src_mask: 24
      frag_type: fragment
      time_range: wdz_acl_time
      provider: "{{ cli }}"

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

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

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

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.8/modules/ce_acl_module.html