nxos_acl — Управляет записями списков доступа для ACL.

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

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Поддержка
- Автор

Описание

Управляет записями списков доступа для ACL.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
ack		Варианты: enable Значение по умолчанию: None	Сопоставление по биту ACK.
action		Варианты: permit deny remark Значение по умолчанию: None	Действие ACE.
dest		Значение по умолчанию: None	IP-адрес назначения и маска, используя обозначение IP/MASK, поддерживает ключевое слово 'any'.
dest_port1		Значение по умолчанию: None	Порт/протокол, а также первый (нижний) порт при использовании операнда диапазона.
dest_port2		Значение по умолчанию: None	Второй (верхний) порт при использовании операнда диапазона.
dest_port_op		Варианты: any eq gt lt neq range Значение по умолчанию: None	Операторы портов назначения, такие как eq, neq, gt, lt, range.
dscp		Варианты: af11 af12 af13 af21 af22 af23 af31 af32 af33 af41 af42 af43 cs1 cs2 cs3 cs4 cs5 cs6 cs7 default ef Значение по умолчанию: None	Сопоставление пакетов с заданным значением dscp.
established		Варианты: enable Значение по умолчанию: None	Сопоставление установленных соединений.
fin		Варианты: enable Значение по умолчанию: None	Сопоставление по биту FIN.
fragments		Варианты: enable Значение по умолчанию: None	Проверка фрагментов, отличных от начальных.
log		Варианты: enable Значение по умолчанию: None	Регистрация совпадений с этой записью.
name обязательно			Используется чувствительное к регистру имя списка доступа (ACL).
precedence		Варианты: critical flash flash-override immediate internet network priority routine Значение по умолчанию: None	Сопоставление пакетов с заданным значением приоритета.
proto		Значение по умолчанию: None	Номер порта или протокол (поддерживаемые коммутатором).
provider		Значение по умолчанию: None	Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Этот параметр необходим только если используется NX-API. Для получения дополнительной информации, обратитесь к руководству NXOS Platform Options. Объект словаря, содержащий сведения о подключении.
	username		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в командную строку или аутентификации nxapi, в зависимости от используемого транспорта. Если значение не указано в задании, вместо него используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
	authorize (добавлен в 2.5.3)	Варианты: нет ← да	Инструктирует модуль войти в привилегированный режим на удаленном устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задании, вместо него используется значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задании, вместо него используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	use_proxy (добавлен в 2.5)	Варианты: да ← нет	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут проигнорированы.
	auth_pass (добавлен в 2.5.3)	Значение по умолчанию: none	Указывает пароль для входа в привилегированный режим на удаленном устройстве, если это требуется. Если authorize равно false, этот аргумент не имеет эффекта. Если значение не указано в задании, вместо него используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному транспорту. Значение параметра host используется как адрес назначения для транспорта.
	timeout (добавлен в 2.3)	Значение по умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания превышено до завершения операции, модуль выдаст ошибку. NX-API может медленно отвечать при выполнении длительных команд (sh mac, sh bgp и т. д.).
	use_ssl	Варианты: да нет ←	Настраивает transport на использование SSL, если значение равно true, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	password	Значение по умолчанию: None	Указывает пароль для аутентификации подключения к удаленному устройству. Это общий аргумент, используемый для транспортов cli или nxapi. Если значение не указано в задании, вместо него используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	validate_certs	Варианты: да нет Значение по умолчанию: None	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых лично сайтах, использующих самозаверяющие сертификаты. Если транспорт не является nxapi, это значение игнорируется.
	port	Значение по умолчанию: 0 (использование стандартного порта)	Указывает порт для подключения к удаленному устройству. Это значение применяется к cli или nxapi. Значение порта по умолчанию соответствует стандартному порту для соответствующего транспорта, если в задании не указано иное. (cli=22, http=80, https=443).
	transport обязательно	Значение по умолчанию: cli	Настраивает транспортное соединение для подключения к удаленному устройству. Аргумент transport поддерживает подключение к устройству через cli (ssh) или nxapi.
psh		Варианты: enable Значение по умолчанию: None	Сопоставление по биту PSH.
remark		Значение по умолчанию: None	Если действие задано как remark, это описание.
rst		Варианты: enable Значение по умолчанию: None	Сопоставление по биту RST.
seq		Значение по умолчанию: None	Порядковый номер записи (ACE).
src		Значение по умолчанию: None	IP-адрес источника и маска, используя обозначение IP/MASK, поддерживает ключевое слово 'any'.
src_port1		Значение по умолчанию: None	Порт/протокол, а также первый (нижний) порт при использовании операнда диапазона.
src_port2		Значение по умолчанию: None	Второй (верхний) порт при использовании операнда диапазона.
src_port_op		Варианты: any eq gt lt neq range Значение по умолчанию: None	Операторы портов источника, такие как eq, neq, gt, lt, range.
state		Варианты: present ← absent delete_acl	Указывает желаемое состояние ресурса.
syn		Варианты: enable Значение по умолчанию: None	Сопоставление по биту SYN.
time_range		Значение по умолчанию: None	Имя временного диапазона для применения.
urg		Варианты: enable Значение по умолчанию: None	Сопоставление по биту URG.

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
state=absent удаляет ACE, если он существует.
state=delete_acl удаляет ACL, если она существует.
Для идемпотентности используйте номера портов для параметров src/dest port, например, src_port1, и имена для хорошо определенных протоколов для параметра proto.
Хотя этот модуль идемпотентен, в том смысле, что если ACE, представленный в задаче, идентичен ACE на коммутаторе, никаких изменений не будет внесено. Если есть какие-либо различия, то то, что содержится в Ansible, будет применено (настроенные параметры будут перезаписаны). Это сделано для повышения безопасности, но, в то же время, помните, что ACE может быть удален, а затем повторно добавлен, поэтому, если есть изменения, новый ACE будет точно таким, какими параметрами вы отправляете в модуль.
Для получения информации об использовании CLI и NX-API см. Руководство по параметрам платформы NXOS
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. Руководство по сетям Ansible
Для получения дополнительной информации об использовании Ansible для управления устройствами Cisco см. страницу интеграции Cisco .

Примеры

# configure ACL ANSIBLE
- nxos_acl:
    name: ANSIBLE
    seq: 10
    action: permit
    proto: tcp
    src: 1.1.1.1/24
    dest: any
    state: present

Значения возврата

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

Ключ	Возвращаемое значение	Описание
commands список	всегда	Команды, отправленные устройству Пример: ['ip access-list ANSIBLE', '10 permit tcp 1.1.1.1/24 any']

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.

Поддержка

Для получения дополнительной информации о поддержке этого модуля Red Hat, пожалуйста, обратитесь к этой статье базы знаний

Автор

Jason Edelman (@jedelman8)
Gabriele Gerbino (@GGabriele)

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/nxos_acl_module.html