cisco.aci.aci_interface_policy_ospf – Управление политиками интерфейсов OSPF (ospf:IfPol)
Примечание
Этот плагин является частью коллекции cisco.aci (версия 1.1.1).
Для его установки используйте: ansible-galaxy collection install cisco.aci
Чтобы использовать его в плейбуке, укажите: cisco.aci.aci_interface_policy_ospf
Краткое описание
- Управление политиками интерфейсов OSPF на Cisco ACI фабриках.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| annotation строка | Пользовательская строка для аннотирования объекта. Если значение не указано в задаче, используется значение переменной окружения ACI_ANNOTATION. | |
| certificate_name строка | Имя сертификата X.509, прикрепленного к пользователю APIC AAA, используемому для аутентификации на основе подписи. Если был предоставлен файл с именем private_key, по умолчанию используется имя файла private_key, без расширения.Если для private_key был предоставлен контент в формате PEM, по умолчанию используется значение username. Если значение не указано в задаче, используется значение переменной окружения ACI_CERTIFICATE_NAME. псевдонимы: cert_name | |
| controls список / элементы=строка |
| Контроли политики интерфейса. Это список одного или нескольких следующих контролей: advert-subnet — Объявлять IP-подсеть вместо маски хоста в LSA маршрутизатора.bfd — Двунаправленное обнаружение пересылки.mtu-ignore — Отключает обнаружение несовпадения MTU на интерфейсе.passive — Интерфейс не участвует в протоколе OSPF и не будет устанавливать смежности или отправлять обновления маршрутизации. Однако интерфейс объявляется как часть сетевой маршрутизации. |
| cost целое число | Стоимость интерфейса OSPF. Стоимость (также называемая метрикой) интерфейса в OSPF указывает на накладные расходы, необходимые для отправки пакетов через определенный интерфейс. Стоимость интерфейса обратно пропорциональна пропускной способности этого интерфейса. Более высокая пропускная способность указывает на меньшую стоимость. Переход по 56k последовательной линии требует больше накладных расходов (большая стоимость) и задержек по времени, чем по 10M Ethernet-линии. Используемая формула для расчета стоимости — cost= 10000 0000/bandwith in bps. Например, переход по 10M Ethernet-линии стоит 10 EXP8/10 EXP7 = 10, а по T1-линии — 10 EXP8/1544000 = 64.По умолчанию стоимость интерфейса рассчитывается на основе пропускной способности; вы можете принудительно установить стоимость интерфейса с помощью команды ip ospf cost value в режиме подконфигурации интерфейса. Допустимые значения находятся в диапазоне от 1 до 450. APIC по умолчанию устанавливает 0 при отсутствии настроек при создании. | |
| dead_interval целое число | Интервал между пакетами hello от соседа, прежде чем маршрутизатор объявляет соседа отключенным. Это значение должно быть одинаковым для всех сетевых устройств в определенной сети. Указание меньшего интервала отключения (секунды) позволит быстрее обнаружить отказ соседа и улучшит сходимость, но может привести к большей нестабильности маршрутизации. Допустимые значения находятся в диапазоне от 1 до 65535. APIC по умолчанию устанавливает 40 при отсутствии настроек при создании. | |
| description строка | Описание интерфейса OSPF. псевдонимы: descr | |
| hello_interval целое число | Интервал между пакетами hello, которые OSPF отправляет по интерфейсу. Обратите внимание, что чем меньше интервал hello, тем быстрее будут обнаружены изменения топологии, но увеличится сетевой трафик маршрутизации. Это значение должно быть одинаковым для всех маршрутизаторов и серверов доступа в определенной сети. Допустимые значения находятся в диапазоне от 1 до 65535. APIC по умолчанию устанавливает 10 при отсутствии настроек при создании. | |
| host строка / обязательно | IP-адрес или имя хоста, разрешаемые хостом управления Ansible. Если значение не указано в задаче, используется значение переменной окружения ACI_HOST. псевдонимы: hostname | |
| name_alias строка | Псевдоним для текущего объекта. Он относится к полю nameAlias в ACI. | |
| network_type строка |
| Тип сети политики интерфейса OSPF. OSPF поддерживает широковещательную и точка-точка. APIC по умолчанию устанавливает unspecified при отсутствии настроек при создании. |
| ospf строка | Имя политики интерфейса OSPF. Это имя может содержать от 1 до 64 буквенно-цифровых символов. Обратите внимание, что вы не можете изменить это имя после сохранения объекта. псевдонимы: ospf_interface, name | |
| output_level строка |
| Влияние на вывод этого модуля ACI. normal означает стандартный вывод, включая current dict.info добавляет информативный вывод, включая previous, proposed и sent dicts.debug добавляет отладочный вывод, включая filter_string, method, response, status и url информацию.Если значение не указано в задаче, используется значение переменной окружения ACI_OUTPUT_LEVEL. |
| output_path строка | Путь к файлу, который будет использоваться для выгрузки объектов конфигурации ACI JSON, сгенерированных модулем. Если значение не указано в задаче, используется значение переменной окружения ACI_OUTPUT_PATH. | |
| owner_key строка | Пользовательская строка для атрибута ownerKey объекта ACI. Этот атрибут представляет собой ключ, который позволяет клиентам владеть своими данными для корреляции сущностей. Если значение не указано в задаче, используется значение переменной окружения ACI_OWNER_KEY. | |
| owner_tag строка | Пользовательская строка для атрибута ownerTag объекта ACI. Этот атрибут представляет тег, который позволяет клиентам добавлять свои собственные данные. Например, для указания того, кто создал этот объект. Если значение не указано в задаче, используется значение переменной окружения ACI_OWNER_TAG. | |
| password строка | Пароль для аутентификации. Этот параметр взаимоисключает private_key. Если указан и private_key, будет использоваться он.Если значение не указано в задаче, используются переменные окружения ACI_PASSWORD или ANSIBLE_NET_PASSWORD. | |
| port целое число | Номер порта, используемый для подключения REST. Значение по умолчанию зависит от параметра use_ssl. Если значение не указано в задаче, используется значение переменной окружения ACI_PORT. | |
| prefix_suppression булево |
| Включить или отключить подавление префиксов. APIC по умолчанию устанавливает inherit при отсутствии настроек при создании. |
| priority целое число | Приоритет профиля интерфейса OSPF. Допустимые значения находятся в диапазоне от 0 до 255. APIC по умолчанию устанавливает 1 при отсутствии настроек при создании. | |
| private_key строка | Файл закрытого ключа в формате PEM или содержимое закрытого ключа, используемого для аутентификации на основе подписи. Это значение также влияет на значение по умолчанию certificate_name, которое используется.Этот параметр взаимоисключает password. Если указан и password, он будет проигнорирован.Если значение не указано в задаче, используется значение переменной окружения ACI_PRIVATE_KEY. псевдонимы: cert_key | |
| retransmit_interval целое число | Интервал между повторными отправками LSA. Интервал повторной отправки возникает, пока маршрутизатор ожидает подтверждения от соседнего маршрутизатора о получении LSA. Если подтверждение не получено в конце интервала, LSA повторно отправляется. Допустимые значения находятся в диапазоне от 1 до 65535. APIC по умолчанию устанавливает 5 при отсутствии настроек при создании. | |
| state строка |
| Используйте present или absent для добавления или удаления.Используйте query для перечисления объекта или нескольких объектов. |
| tenant строка | Имя арендатора, к которому должна принадлежать политика интерфейса OSPF. псевдонимы: tenant_name | |
| timeout целое число | По умолчанию: 30 | Таймаут уровня сокета в секундах. Если значение не указано в задаче, используется значение переменной окружения ACI_TIMEOUT. |
| transmit_delay целое число | Время задержки, необходимое для отправки пакета обновления LSA. OSPF увеличивает время жизни LSA на величину задержки передачи перед отправкой обновления LSA. При установке этого значения необходимо учитывать задержки передачи и распространения для интерфейса. Допустимые значения находятся в диапазоне между 1 и 450. По умолчанию APIC устанавливает значение 1, если оно не задано при создании. | |
| use_proxy булево |
| Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах.Если значение не указано в задаче, будет использовано значение переменной среды ACI_USE_PROXY. |
| use_ssl булево |
| Если no, вместо стандартного HTTPS соединения будет использовано HTTP-соединение.Если значение не указано в задаче, будет использовано значение переменной среды ACI_USE_SSL. |
| username строка | По умолчанию: "admin" | Имя пользователя для аутентификации. Если значение не указано в задаче, будет использовано значение переменных среды ACI_USERNAME или ANSIBLE_NET_USERNAME.псевдонимы: user |
| validate_certs булево |
| Если no, сертификаты SSL не будут проверяться.Это значение должно быть установлено в no только при использовании на сайтах, контролируемых пользователем, с самозаверяющимися сертификатами.Если значение не указано в задаче, будет использовано значение переменной среды ACI_VALIDATE_CERTS. |
См. также
См. также
- APIC Management Information Model reference
-
Дополнительная информация о внутреннем классе APIC ospf:IfPol.
- Руководство по Cisco ACI
-
Подробная информация о том, как управлять инфраструктурой ACI с помощью Ansible.
- Разработка модулей Cisco ACI
-
Подробное руководство по написанию собственных модулей Cisco ACI для внесения вклада.
Примеры
- name: Ensure ospf interface policy exists
cisco.aci.aci_interface_policy_ospf:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
ospf: ospf1
state: present
delegate_to: localhost
- name: Ensure ospf interface policy does not exist
cisco.aci.aci_interface_policy_ospf:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
ospf: ospf1
state: present
delegate_to: localhost
- name: Query an ospf interface policy
cisco.aci.aci_interface_policy_ospf:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
ospf: ospf1
state: query
delegate_to: localhost
register: query_result
- name: Query all ospf interface policies in tenant production
cisco.aci.aci_interface_policy_ospf:
host: apic
username: admin
password: SomeSecretPassword
tenant: production
state: query
delegate_to: localhost
register: query_result
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| current список / элементы=строка | успех | Текущая конфигурация из APIC после завершения модуля Пример: [{'fvTenant': {'attributes': {'descr': 'Производственная среда', 'dn': 'uni/tn-production', 'name': 'production', 'nameAlias': '', 'ownerKey': '', 'ownerTag': ''}}}] |
| error словарь | ошибка | Информация об ошибке, возвращенная из APIC Пример: {'code': '122', 'text': 'неизвестный класс управляемого объекта foo'} |
| filter_string строка | ошибка или отладка | Строка фильтра, используемая для запроса Пример: ?rsp-prop-include=config-only |
| method строка | ошибка или отладка | Метод HTTP, используемый для запроса к APIC Пример: POST |
| previous список / элементы=строка | информация | Оригинальная конфигурация из APIC до запуска модуля Пример: [{'fvTenant': {'attributes': {'descr': 'Производство', 'dn': 'uni/tn-production', 'name': 'production', 'nameAlias': '', 'ownerKey': '', 'ownerTag': ''}}}] |
| proposed словарь | информация | Сборка конфигурации из предоставленных пользователем параметров Пример: {'fvTenant': {'attributes': {'descr': 'Производственная среда', 'name': 'production'}}} |
| raw строка | ошибка разбора | Необработанный вывод, возвращенный APIC REST API (xml или json) Пример: <?xml version="1.0" encoding="UTF-8"?><imdata totalCount="1"><error code="122" text="неизвестный класс управляемого объекта foo"/></imdata> |
| response строка | ошибка или отладка | HTTP-ответ от APIC Пример: OK (30 байт) |
| sent список / элементы=строка | информация | Фактическая/минимальная конфигурация, отправленная в APIC Пример: {'fvTenant': {'attributes': {'descr': 'Производственная среда'}}} |
| status целое число | ошибка или отладка | HTTP-код состояния от APIC Пример: 200 |
| url строка | ошибка или отладка | HTTP-URL, используемый для запроса к APIC Пример: https://10.11.12.13/api/mo/uni/tn-production.json |
Авторы
- 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.10/collections/cisco/aci/aci_interface_policy_ospf_module.html
