aci_filter - Управляет объектами фильтров верхнего уровня на платформах Cisco ACI (vz:Filter)

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

Обзор
Требования (для хоста, на котором выполняется модуль)
Параметры
Примеры
Примечания
- Статус

Обзор

Управляет объектами фильтров верхнего уровня на платформах Cisco ACI.
Дополнительная информация из внутреннего класса APIC vz:Filter по адресу https://developer.cisco.com/media/mim-ref/MO-vzFilter.html.
Этот модуль не управляет записями фильтров, для этой функциональности см. aci_filter_entry.

Требования (для хоста, на котором выполняется модуль)

ACI Fabric 1.0(3f)+

Параметры

параметр	обязательно	по умолчанию	значения	комментарии
описание	нет			Описание фильтра. псевдонимы: descr
filter	да			Имя фильтра. псевдонимы: filter_name, name
hostname	да			IP-адрес или имя хоста APIC, разрешаемого управляющим хостом Ansible. псевдонимы: host
пароль	да			Пароль для аутентификации.
состояние	нет	present	absent present query	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для вывода объекта или нескольких объектов.
аренда	да			Имя аренды. псевдонимы: tenant_name
таймаут	нет	30		Таймаут уровня сокета в секундах.
использовать_прокси	нет	да	да нет	Если `no`, прокси не будет использоваться, даже если оно определено в переменной среды на целевых хостах.
использовать_ssl	нет	да	да нет	Если `no`, будет использоваться HTTP-соединение вместо стандартного HTTPS-соединения.
имя_пользователя	да	admin		Имя пользователя для аутентификации. псевдонимы: user
проверять_сертификаты	нет	да	да нет	Если `no`, сертификаты SSL не будут проверены. Это следует установить только в `no` используется на сайтах под собственным контролем с использованием самоподписанных сертификатов.

Примеры

- name: Add a new filter to a tenant
  aci_filter:
    hostname: apic
    username: admin
    password: SomeSecretPassword
    filter: web_filter
    description: Filter for web protocols
    tenant: production
    state: present

- name: Remove a filter for a tenant
  aci_filter:
    hostname: apic
    username: admin
    password: SomeSecretPassword
    filter: web_filter
    tenant: production
    state: absent

- name: Query a filter of a tenant
  aci_filter:
    hostname: apic
    username: admin
    password: SomeSecretPassword
    filter: web_filter
    tenant: production
    state: query

- name: Query all filters for a tenant
  aci_filter:
    hostname: apic
    username: admin
    password: SomeSecretPassword
    tenant: production
    state: query

Примечания

Примечание

Необходимый tenant должен существовать до использования этого модуля в вашем плейбуке. Для этого можно использовать модуль aci_tenant.
По умолчанию, если на целевом хосте установлена переменная среды <protocol>_proxy, запросы будут отправляться через этот прокси. Это поведение можно переопределить, установив переменную для этой задачи (см. установка среды), или с помощью параметра use_proxy.
HTTP-редиректы могут перенаправлять с HTTP на HTTPS, поэтому необходимо убедиться, что ваша прокси-среда для обоих протоколов корректна.

Статус

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

Для помощи в разработке модулей, если у вас есть такое желание, прочитайте Справочную информацию сообщества и вклад, Тестирование Ansible и Разработка модулей.

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