community.network.ce_bgp_neighbor_af – Управляет конфигурацией семейства адресов BGP-соседа на коммутаторах HUAWEI CloudEngine.
Примечание
Этот плагин входит в коллекцию community.network (версия 2.0.1).
Для установки используйте: ansible-galaxy collection install community.network.
Чтобы использовать его в плейбуке, укажите: community.network.ce_bgp_neighbor_af.
Обзор
- Управляет конфигурацией семейства адресов BGP-соседа на коммутаторах HUAWEI CloudEngine.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| add_path_mode строка |
| null, Нет. receive, Поддержка получения маршрутов Add-Path. send, Поддержка отправки маршрутов Add-Path. both, Поддержка получения и отправки маршрутов Add-Path. |
| adv_add_path_num строка | Количество рекламируемых маршрутов addPath. Значение — целое число от 2 до 64. | |
| advertise_arp строка |
| Если значение true, рекламируемые маршруты ARP различаются. Если значение false, рекламируемые маршруты ARP не различаются. |
| advertise_community строка |
| Если значение true, атрибут сообщества рекламируется соседним устройствам. Если значение false, атрибут сообщества не рекламируется соседним устройствам. |
| advertise_ext_community строка |
| Если значение true, расширенный атрибут сообщества рекламируется соседним устройствам. Если значение false, расширенный атрибут сообщества не рекламируется соседним устройствам. |
| advertise_irb строка |
| Если значение true, рекламируемые маршруты IRB различаются. Если значение false, рекламируемые маршруты IRB не различаются. |
| advertise_remote_nexthop строка |
| Если значение true, атрибут удалённого следующего узла рекламируется соседним устройствам. Если значение false, атрибут удалённого следующего узла не рекламируется соседним устройствам. |
| af_type строка / обязательно |
| Тип семейства адресов BGP-инстанса. |
| allow_as_loop_enable строка |
| Если значение true, разрешаются повторяющиеся локальные номера AS. Если значение false, повторяющиеся локальные номера AS не разрешаются. |
| allow_as_loop_limit строка | Устанавливает максимальное количество повторяющихся локальных номеров AS. Значение — целое число от 1 до 10. | |
| default_rt_adv_enable строка |
| Если значение true, функция рекламы маршрутов по умолчанию соседним устройствам включена. Если значение false, функция рекламы маршрутов по умолчанию соседним устройствам выключена. |
| default_rt_adv_policy строка | Указывает имя используемой политики. Значение — строка длиной от 1 до 40 символов. | |
| default_rt_match_mode строка |
| null, Нет. matchall, Маршрут по умолчанию рекламируется, если выполнены все условия соответствия. matchany, Маршрут по умолчанию рекламируется, если выполнено хотя бы одно условие соответствия. |
| discard_ext_community строка |
| Если значение true, атрибут расширенного сообщества в информации о маршруте соседа отбрасывается. Если значение false, атрибут расширенного сообщества в информации о маршруте соседа не отбрасывается. |
| export_acl_name_or_num строка | Применение политики фильтрации маршрутов на основе IPv4 ACL для маршрутов, рекламируемых указанному соседу. Значение — строка длиной от 1 до 32 символов. | |
| export_as_path_filter строка | Применение политики фильтрации маршрутов на основе AS_Path для маршрутов, рекламируемых указанному соседу. Значение — целое число от 1 до 256. | |
| export_as_path_name_or_num строка | Применение политики фильтрации маршрутов на основе списка AS_Path для маршрутов, рекламируемых указанному соседу. | |
| export_pref_filt_name строка | Указывает политику фильтрации IPv4, применяемую к маршрутам, которые рекламируются указанному соседу. Значение — строка длиной от 1 до 169 символов. | |
| export_rt_policy_name строка | Указывает политику фильтрации, применяемую к маршрутам, которые рекламируются соседу. Значение — строка длиной от 1 до 40 символов. | |
| import_acl_name_or_num строка | Применение политики фильтрации маршрутов на основе IPv4 ACL для маршрутов, полученных от указанного соседа. Значение — строка длиной от 1 до 32 символов. | |
| import_as_path_filter строка | Применение политики фильтрации маршрутов на основе AS_Path для маршрутов, полученных от указанного соседа. Значение — целое число от 1 до 256. | |
| import_as_path_name_or_num строка | Стратегия маршрутизации на основе списка AS_Path для маршрутов, полученных от указанного соседа. | |
| import_pref_filt_name строка | Указывает политику фильтрации IPv4, применяемую к маршрутам, полученным от указанного соседа. Значение — строка длиной от 1 до 169 символов. | |
| import_rt_policy_name строка | Указывает политику фильтрации, применяемую к маршрутам, полученным от соседа. Значение — строка длиной от 1 до 40 символов. | |
| ipprefix_orf_enable строка |
| Если значение true, функция фильтрации исходящих маршрутов по префиксу адреса (ORF) включена для соседей. Если значение false, функция фильтрации исходящих маршрутов по префиксу адреса (ORF) выключена для соседей. |
| is_nonstd_ipprefix_mod строка |
| Если значение true, при переговорах о поддержке используются нестандартные коды. Если значение false, используются стандартные коды ORF, определённые в RFC, при переговорах о поддержке. |
| keep_all_routes строка |
| Если значение true, система сохраняет все сообщения о маршрутизации, полученные от всех соседей (групп) после установки соединения BGP. Если значение false, система сохраняет только те сообщения BGP, которые получены от соседей и соответствуют заданной политике импорта. |
| nexthop_configure строка |
| null, Следующий узел не изменяется. local, Следующий узел изменяется на локальный IP-адрес. invariable, Предотвращает изменение устройством следующего узла каждого импортированного маршрута IGP при его рекламе соседним BGP-устройствам. |
| orf_mode строка |
| Режим ORF. null, Значение по умолчанию. receive, ORF для входящих пакетов. send, ORF для исходящих пакетов. both, ORF для входящих и исходящих пакетов. |
| orftype строка | Тип ORF. Значение — целое число от 0 до 65535. | |
| origin_as_valid строка |
| Если значение true, приложение результата объявления маршрута. Если значение false, результаты приложения маршрутизации не уведомляются. |
| preferred_value строка | Назначьте предпочтительное значение для маршрутов, полученных от указанного соседа. Значение — целое число от 0 до 65535. | |
| public_as_only строка |
| Если значение true, отправляемые сообщения BGP содержат только общедоступный номер AS, но не содержат частные номера AS. Если значение false, отправляемые сообщения BGP могут содержать частные номера AS. |
| public_as_only_force строка |
| Если значение true, отправляемые сообщения BGP содержат только общедоступный номер AS, но не содержат частные номера AS. Если значение false, отправляемые сообщения BGP могут содержать частные номера AS. |
| public_as_only_limited строка |
| Ограниченное использование общедоступного номера AS. |
| public_as_only_replace строка |
| Частный AS заменяется общедоступным номером AS. |
| public_as_only_skip_peer_as строка |
| Общедоступный AS только пропуск номера AS соседа. |
| redirect_ip строка |
| Адрес перенаправления IP. |
| redirect_ip_validation строка |
| Валидация адреса перенаправления IP. псевдонимы: redirect_ip_vaildation |
| reflect_client строка |
| Если значение true, локальное устройство работает как отражатель маршрутов, а узел-партнёр — как клиент отражателя маршрутов. Если значение false, функции отражателя маршрутов и клиента не настроены. |
| remote_address строка / обязательно | Адрес подключения к узлу-партнёру IPv4 или IPv6. | |
| route_limit строка | Настройка максимального количества маршрутов, которые могут быть приняты от узла-партнёра. Значение — целое число от 1 до 4294967295. | |
| route_limit_idle_timeout строка | Укажите значение таймера простоя, чтобы автоматически восстановить соединения после их разрыва, когда количество маршрутов превысит заданный порог. Значение — целое число от 1 до 1200. | |
| route_limit_percent строка | Укажите процент маршрутов, когда маршрутизатор начинает генерировать сигнал тревоги. Значение — целое число от 1 до 100. | |
| route_limit_type строка |
| Noparameter, После того как количество полученных маршрутов превысит порог, и таймер ожидания истечёт, никаких действий. AlertOnly, Генерируется сигнал тревоги, и дополнительные маршруты не будут приниматься, если было получено максимальное количество разрешённых маршрутов. IdleForever, Прерванное соединение не восстанавливается автоматически, если максимальное количество разрешённых маршрутов было получено. IdleTimeout, После того как количество полученных маршрутов превысит порог и истечёт таймер ожидания, прерванное соединение восстанавливается автоматически. |
| rt_updt_interval строка | Укажите минимальный интервал, через который отправляются пакеты обновления. Значение — целое число в секундах. Значение — целое число от 0 до 600. | |
| soostring строка | Настройка атрибута расширенного сообщества Site-of-Origin (SoO). Значение — строка длиной от 3 до 21 символа. | |
| substitute_as_enable строка |
| Если значение true, включена функция замены номера AS указанного узла-партнёра в атрибуте AS-Path номером локального AS. Если значение false, функция замены номера AS указанного узла-партнёра в атрибуте AS-Path номером локального AS отключена. |
| update_pkt_standard_compatible строка |
| Если значение true, при получении и обновлении сообщения VPNv4 multicast-соседом сообщение не имеет метки. Если значение false, при получении и обновлении сообщения VPNv4 multicast-соседом сообщение имеет метку. |
| vpls_ad_disable строка |
| Если значение true, включить vpls-ad. Если значение false, отключить vpls-ad. |
| vpls_enable строка |
| Если значение true, включить vpls. Если значение false, отключить vpls. |
| vrf_name строка / обязательно | Имя экземпляра BGP. Имя — чувствительная к регистру строка символов. Экземпляр BGP можно использовать только после создания соответствующего экземпляра VPN. |
Примечания
Примечание
- Для этого модуля требуется, чтобы служба netconf была включена на удалённом управляемом устройстве.
- Рекомендуемое соединение —
netconf. - Этот модуль также работает с
localсоединениями для устаревших playbooks.
Примеры
- name: CloudEngine BGP neighbor address family test
hosts: cloudengine
connection: local
gather_facts: no
vars:
cli:
host: "{{ inventory_hostname }}"
port: "{{ ansible_ssh_port }}"
username: "{{ username }}"
password: "{{ password }}"
transport: cli
tasks:
- name: "Config BGP peer Address_Family"
community.network.ce_bgp_neighbor_af:
state: present
vrf_name: js
af_type: ipv4uni
remote_address: 192.168.10.10
nexthop_configure: local
provider: "{{ cli }}"
- name: "Undo BGP peer Address_Family"
community.network.ce_bgp_neighbor_af:
state: absent
vrf_name: js
af_type: ipv4uni
remote_address: 192.168.10.10
nexthop_configure: local
provider: "{{ cli }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| changed логическое | всегда | проверка, были ли внесены изменения на устройстве Пример: True |
| end_state словарь | всегда | параметры aaa в формате ключ/значение после выполнения модуля Пример: {'bgp neighbor af': {'af_type': 'ipv4uni', 'remote_address': '192.168.10.10', 'vrf_name': 'js'}, 'bgp neighbor af other': {'af_type': 'ipv4uni', 'nexthop_configure': 'local', 'vrf_name': 'js'}} |
| existing словарь | всегда | параметры существующего сервера aaa в формате ключ/значение Пример: {'bgp neighbor af': {'af_type': 'ipv4uni', 'remote_address': '192.168.10.10', 'vrf_name': 'js'}, 'bgp neighbor af other': {'af_type': 'ipv4uni', 'nexthop_configure': 'null', 'vrf_name': 'js'}} |
| proposed словарь | всегда | параметры, переданные в модуль, в формате ключ/значение Пример: {'af_type': 'ipv4uni', 'nexthop_configure': 'local', 'remote_address': '192.168.10.10', 'state': 'present', 'vrf_name': 'js'} |
| updates список / элементы=строка | всегда | команда, отправленная на устройство Пример: ['peer 192.168.10.10 next-hop-local'] |
Авторы
- wangdezhuang (@QijunPan)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/ce_bgp_neighbor_af_module.html
