aci_contract_subject - Управление начальными темами контрактов в Cisco ACI fabric (vz:Subj)

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

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

Обзор

Управление начальными темами контрактов в Cisco ACI fabric.
Дополнительную информацию можно получить из внутреннего класса APIC vz:Subj по адресу https://developer.cisco.com/media/mim-ref/MO-vzSubj.html.

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

Cisco ACI Fabric 1.0(3f)+

Параметры

параметр	обязательно	по умолчанию	значения	комментарии
consumer_match	нет	at_least_one	all at_least_one at_most_one none	Критерии соответствия для потребителей. APIC по умолчанию устанавливает новые темы контрактов в `at_least_one`.
contract	нет			Имя контракта. псевдонимы: contract_name
description	нет			Описание темы контракта.
dscp	нет	unspecified	AF11 AF12 AF13 AF21 AF22 AF23 AF31 AF32 AF33 AF41 AF42 AF43 CS0 CS1 CS2 CS3 CS4 CS5 CS6 CS7 EF VA unspecified	Целевое значение DSCP. APIC по умолчанию устанавливает новые темы контрактов в `unspecified`. псевдонимы: target
hostname	да			IP-адрес или имя хоста APIC, разрешимый контрольным хостом Ansible. псевдонимы: host
password	да			Пароль для аутентификации.
priority	нет	unspecified	level1 level2 level3 unspecified	Класс QoS. APIC по умолчанию устанавливает новые темы контрактов в `unspecified`.
provider_match	нет	at_least_one	all at_least_one at_most_one none	Критерии соответствия для поставщиков. APIC по умолчанию устанавливает новые темы контрактов в `at_least_one`.
reverse_filter	нет	True	True False	Определяет, должен ли APIC инвертировать исходный и целевой порты, чтобы разрешить возврат трафика обратно, так как ACI является бесстатсным фильтром. APIC по умолчанию устанавливает новые темы контрактов в `yes`.
state	нет	present	absent present query	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления объекта или нескольких объектов.
subject	нет			Имя темы контракта. псевдонимы: contract_subject, name, subject_name
tenant	нет			Имя клиента. псевдонимы: tenant_name
timeout	нет	30		Таймаут уровня сокета в секундах.
use_proxy	нет	да	да нет	Если `no`, прокси не будет использоваться, даже если он определен в переменной окружения на целевых хостах.
use_ssl	нет	да	да нет	Если `no`, будет использоваться HTTP-соединение вместо стандартного HTTPS-соединения.
username	да	admin		Имя пользователя для аутентификации. псевдонимы: user
validate_certs	нет	да	да нет	Если `no`, сертификаты SSL не будут проверяться. Это следует устанавливать только в `no` для сайтов с собственными сертификатами.

Примеры

- name: Add a new contract subject
  aci_contract_subject:
    hostname: apic
    username: admin
    password: SomeSecretPassword
    tenant: production
    contract: web_to_db
    subject: default
    description: test
    reverse_filter: yes
    priority: level1
    dscp: unspecified
    state: present

- name: Remove a contract subject
  aci_contract_subject:
    hostname: apic
    username: admin
    password: SomeSecretPassword
    tenant: production
    contract: web_to_db
    subject: default
    state: absent

- name: Query a contract subject
  aci_contract_subject:
    hostname: apic
    username: admin
    password: SomeSecretPassword
    tenant: production
    contract: web_to_db
    subject: default
    state: query

- name: Query all contract subjects
  aci_contract_subject:
    hostname: apic
    username: admin
    password: SomeSecretPassword
    state: query

Примечания

Примечание

Необходимые tenant и contract должны существовать перед использованием этого модуля в вашем playbook.
Модули aci_tenant и aci_contract могут быть использованы для этого.
По умолчанию, если на целевом хосте установлена переменная среды <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_contract_subject_module.html