mso_schema_template_contract_filter – Управление фильтрами контрактов в шаблонах схем
Новая версия с 2.8.
Обзор
- Управление фильтрами контрактов в шаблонах схем в Cisco ACI Multi-Site.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Многосайтовый оркестратор Cisco ACI версии 2.1 или новее
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| contract строка / обязательно | Имя контракта для управления. | |
| contract_display_name строка | Имя, отображаемое на веб-интерфейсе MSO. По умолчанию совпадает с именем контракта, если не задано при создании. | |
| contract_filter_type строка |
| Тип фильтров, определённых в этом контракте. По умолчанию both-way при отсутствии указания при создании. |
| contract_scope строка |
| Область действия контракта. По умолчанию vrf при отсутствии указания при создании. |
| filter строка | Фильтр, который необходимо связать с этим контрактом. псевдонимы: имя | |
| filter_directives список |
| Список директив фильтра. |
| filter_schema строка | Имя схемы, в которой находится фильтр. | |
| filter_template строка | Имя шаблона, в котором находится фильтр. | |
| filter_type строка |
| Тип управляемого фильтра. псевдонимы: тип |
| host строка / обязательно | IP-адрес или имя хоста ACI Multi Site Orchestrator. псевдонимы: имя_хоста | |
| output_level строка |
| Влияет на вывод этого модуля ACI. normal означает стандартный вывод, включая current словарьinfo добавляет информационный вывод, включая previous, proposed и sent словариdebug добавляет вывод отладки, включая filter_string, method, response, status и url информацию |
| password строка / обязательно | Пароль для аутентификации. Этот параметр исключает private_key. Если задан private_key, он будет использован. | |
| port целое число | Порт для подключения REST. Значение по умолчанию зависит от параметра `use_ssl`. | |
| schema строка / обязательно | Имя схемы. | |
| state строка |
| Используйте present или absent для добавления или удаления.Используйте query для получения списка объектов или нескольких объектов. |
| template строка / обязательно | Имя шаблона. | |
| timeout целое число | По умолчанию: 30 | Таймаут сокета в секундах. |
| use_proxy булево |
| Если no, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах. |
| use_ssl булево |
| Если no, вместо стандартного HTTPS соединения будет использовано HTTP-соединение. |
| username строка | По умолчанию: "админ" | Имя пользователя для аутентификации. |
| validate_certs булево |
| Если no, сертификаты SSL не будут проверены.Это должно быть установлено на no только на сайтах с собственными сертификатами. |
Примечания
Примечание
- Из-за ограничений API REST MSO этот модуль создаёт контракты при необходимости и удаляет их, когда последний фильтр был удалён.
- Из-за ограничений API REST MSO одновременные изменения фильтров контрактов могут быть опасны и привести к повреждению данных.
- Для получения более подробной информации о том, как управлять вашей инфраструктурой ACI с помощью Ansible, ознакомьтесь с руководством Cisco ACI Guide.
- Этот модуль был разработан для поддержки ACI Multi Site Orchestrator версии 2.1 или новее. Некоторые или все функции могут не работать на более ранних версиях.
См. также
См. также
- mso_schema_template_filter_entry – Управление записями фильтров в шаблонах схем
- Официальная документация модуля mso_schema_template_filter_entry.
Примеры
- name: Add a new contract filter
mso_schema_template_contract_filter:
host: mso_host
username: admin
password: SomeSecretPassword
schema: Schema 1
template: Template 1
contract: Contract 1
contract_scope: global
filter: Filter 1
state: present
delegate_to: localhost
- name: Remove a contract filter
mso_schema_template_contract_filter:
host: mso_host
username: admin
password: SomeSecretPassword
schema: Schema 1
template: Template 1
contract: Contract 1
filter: Filter 1
state: absent
delegate_to: localhost
- name: Query a specific contract filter
mso_schema_template_contract_filter:
host: mso_host
username: admin
password: SomeSecretPassword
schema: Schema 1
template: Template 1
contract: Contract 1
filter: Filter 1
state: query
delegate_to: localhost
register: query_result
- name: Query all contract filters
mso_schema_template_contract_filter:
host: mso_host
username: admin
password: SomeSecretPassword
schema: Schema 1
template: Template 1
contract: Contract 1
state: query
delegate_to: localhost
register: query_result
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Dag Wieers (@dagwieers)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/mso_schema_template_contract_filter_module.html