Модуль cisco.aci.aci_epg_to_contract_master — Управление отношениями контрактов конечных точек группы (EPG) с главным контрактом (fv:RsSecInherited)
Примечание
Этот модуль входит в коллекцию cisco.aci (версия 2.10.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.aci.
Чтобы использовать её в плейбуке, укажите: cisco.aci.aci_epg_to_contract_master.
Описание
- Управление отношениями контрактов конечных точек групп (EPG) с главным контрактом на тканях Cisco ACI.
Параметры
Параметр | Комментарии |
|---|---|
annotation string | Пользовательская строка для аннотирования объекта. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Если значение не указано в задаче и переменной окружения Default: |
ap aliases: app_profile, app_profile_name string / required | Имя существующего профиля прикладной сети, который будет содержать EPG. |
certificate_name aliases: cert_name string | Имя сертификата X.509, присоединенного к пользователю APIC AAA, используемому для аутентификации на основе подписи. Если указано имя файла Если для Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
contract_master_ap string | Имя профиля приложения, где находится EPG-мастер контракта. |
contract_master_epg string | Имя конечной группы, которая служит мастером контракта. |
epg aliases: epg_name, name string / required | Имя конечной группы. |
host aliases: hostname string | IP-адрес или имя хоста APIC, доступное для узла управления Ansible. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
output_level string | Влияет на вывод этого модуля ACI.
Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Choices:
|
output_path string | Путь к файлу, который будет использоваться для выгрузки сгенерированных модулем объектов конфигурации ACI JSON. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
password string | Пароль для аутентификации. Эта опция является взаимоисключающей с Если значение не указано в задаче, вместо него будут использованы значения переменных окружения |
port integer | Номер порта, который будет использоваться для REST-подключения. Значение по умолчанию зависит от параметра Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
private_key aliases: cert_key string | Либо файл закрытого ключа в формате PEM, либо содержимое закрытого ключа, используемого для аутентификации на основе подписи. Это значение также влияет на используемое значение Эта опция является взаимоисключающей с Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
state string | Используйте Используйте Choices:
|
suppress_previous aliases: no_previous, ignore_previous boolean | Если Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Значение по умолчанию - ПРЕДУПРЕЖДЕНИЕ - Это приводит к тому, что предыдущее возвращаемое значение будет пустым. Предыдущее состояние объекта не будет проверено, и обновление POST будет содержать все свойства. Choices:
|
suppress_verification aliases: no_verification, no_verify, suppress_verify, ignore_verify, ignore_verification boolean | Если Если значение не указано в задаче, будет использовано значение переменной среды Значение по умолчанию — ПРЕДУПРЕЖДЕНИЕ — Это приводит к установке текущего возвращаемого значения в предложенное значение. Текущий объект, включая значения по умолчанию, не будет проверяем в одной задаче. Варианты:
|
tenant aliases: tenant_name string / обязательно | Имя существующего арендатора. |
timeout целое число | Таймаут уровня сокета в секундах. Если значение не указано в задаче, будет использовано значение переменной среды Значение по умолчанию — 30. |
use_proxy boolean | Если Если значение не указано в задаче, будет использовано значение переменной среды Значение по умолчанию — true. Варианты:
|
use_ssl boolean | Если Если значение не указано в задаче, будет использовано значение переменной среды Значение по умолчанию — true при локальном соединении. Варианты:
|
username aliases: user string | Имя пользователя для аутентификации. Если значение не указано в задаче, будет использовано значение переменных среды Значение по умолчанию — admin. |
validate_certs boolean | Если Это следует устанавливать в Если значение не указано в задаче, будет использовано значение переменной среды Значение по умолчанию — true. Варианты:
|
Примечания
Примечание
- Переменные
tenantиapp_profileдолжны существовать перед использованием данного модуля в вашем плейбуке. Для этого можно использовать модули cisco.aci.aci_tenant и cisco.aci.aci_ap.
См. также
См. также
- cisco.aci.aci_epg
-
Управление объектами групп конечных точек (EPG) (fv:AEPg).
- APIC Management Information Model reference
-
Дополнительная информация о внутреннем классе APIC fv:AEPg.
- Руководство по Cisco ACI
-
Подробная информация о том, как управлять вашей инфраструктурой ACI с помощью Ansible.
- Разработка модулей Cisco ACI
-
Подробное руководство по написанию собственных модулей Cisco ACI для внесения вклада.
Примеры
- name: Add contract master
cisco.aci.aci_epg_to_contract_master:
host: apic_host
username: admin
password: SomeSecretPassword
tenant: anstest
ap: apName
epg: epgName
contract_master_ap: ap
contract_master_epg: epg
state: present
delegate_to: localhost
- name: Remove contract master
cisco.aci.aci_epg_to_contract_master:
host: apic_host
username: admin
password: SomeSecretPassword
tenant: anstest
ap: apName
epg: epgName
contract_master_ap: ap
contract_master_epg: epg
state: absent
delegate_to: localhost
- name: Query contract master
cisco.aci.aci_epg_to_contract_master:
host: apic_host
username: admin
password: SomeSecretPassword
tenant: anstest
ap: apName
epg: epgName
contract_master_ap: ap
contract_master_epg: epg
state: query
delegate_to: localhost
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:
Ключ | Описание |
|---|---|
current список / элементы=строка | Текущая конфигурация из APIC после завершения работы модуля. Возвращено: успешно Пример: |
error словарь | Информация об ошибке, возвращённая из APIC. Возвращено: ошибка Пример: |
filter_string строка | Используемая строка фильтра. Возвращено: ошибка или отладка Пример: |
method строка | HTTP метод, используемый для запроса к APIC. Возвращено: ошибка или отладка Пример: |
previous список / элементы=строка | Исходная конфигурация из APIC до запуска модуля. Возвращено: информация Пример: |
proposed словарь | Скомпонованная конфигурация из параметров пользователя. Возвращено: информация Пример: |
raw строка | Необработанный вывод, возвращённый API REST APIC (xml или json). Возвращено: ошибка парсинга Пример: |
response строка | HTTP ответ от APIC. Возвращено: ошибка или отладка Пример: |
sent список / элементы=строка | Фактическая/минимальная конфигурация, отправленная в APIC. Возвращено: информация Пример: |
status целое число | HTTP статус из APIC. Возвращено: ошибка или отладка Пример: |
url строка | HTTP URL, используемый для запроса к APIC. Возвращено: ошибка или отладка Пример: |
Ссылки на сборку
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/aci/aci_epg_to_contract_master_module.html