ce_bgp_neighbor_af - Управляет конфигурацией семейства адресов BGP-соседа на коммутаторах HUAWEI CloudEngine.
Новая в версии 2.4.
Краткое описание
- Управляет конфигурациями семейства адресов 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 | нет | no_use |
| Если значение равно true, рекламируемые маршруты ARP различаются. Если значение равно false, рекламируемые маршруты ARP не различаются. |
| advertise_community | нет | no_use |
| Если значение равно true, атрибут сообщества рекламируется соседним устройствам. Если значение равно false, атрибут сообщества не рекламируется соседним устройствам. |
| advertise_ext_community | нет | no_use |
| Если значение равно true, расширенный атрибут сообщества рекламируется соседним устройствам. Если значение равно false, расширенный атрибут сообщества не рекламируется соседним устройствам. |
| advertise_irb | нет | no_use |
| Если значение равно true, рекламируемые маршруты IRB различаются. Если значение равно false, рекламируемые маршруты IRB не различаются. |
| advertise_remote_nexthop | нет | no_use |
| Если значение равно true, атрибут удалённого следующего узла рекламируется соседним устройствам. Если значение равно false, атрибут удалённого следующего узла не рекламируется соседним устройствам. |
| af_type | да |
| Тип семейства адресов BGP-инстанса. | |
| allow_as_loop_enable | нет | no_use |
| Если значение равно true, разрешаются повторяющиеся локальные номера AS. Если значение равно false, повторяющиеся локальные номера AS запрещены. |
| allow_as_loop_limit | нет | Устанавливает максимальное количество повторяющихся локальных номеров AS. Значение — целое число от 1 до 10. | ||
| default_rt_adv_enable | нет | no_use |
| Если значение равно true, функция рекламы маршрутов по умолчанию для соседних устройств включена. Если значение равно false, функция рекламы маршрутов по умолчанию для соседних устройств выключена. |
| default_rt_adv_policy | нет | Указывает имя используемой политики. Значение — строка от 1 до 40 символов. | ||
| default_rt_match_mode | нет |
| null, Нулевое значение. matchall, Маршрут по умолчанию рекламируется, если выполнены все условия сопоставления. matchany, Маршрут по умолчанию рекламируется, если выполнено любое условие сопоставления. | |
| discard_ext_community | нет | no_use |
| Если значение равно 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-путей для маршрутизации указанному соседу. | ||
| 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-путей для маршрутов, полученных от указанного соседа. | ||
| import_pref_filt_name | нет | Указывает политику фильтрации IPv4, применяемую к маршрутам, полученным от указанного соседа. Значение — строка от 1 до 169 символов. | ||
| import_rt_policy_name | нет | Указывает политику фильтрации, применяемую к маршрутам, полученным от соседа. Значение — строка от 1 до 40 символов. | ||
| ipprefix_orf_enable | нет | no_use |
| Если значение равно true, функция фильтрации исходящих маршрутов (ORF) на основе префикса адреса включена для соседей. Если значение равно false, функция фильтрации исходящих маршрутов (ORF) на основе префикса адреса выключена для соседей. |
| is_nonstd_ipprefix_mod | нет | no_use |
| Если значение равно true, используются нестандартные коды возможностей при согласовании возможностей. Если значение равно false, используются стандартные коды возможностей ORF, определённые в RFC, при согласовании возможностей. |
| keep_all_routes | нет | no_use |
| Если значение равно 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 | нет | no_use |
| Если значение равно true, результаты применения объявления маршрута. Если значение равно false, результаты применения маршрутизации не уведомляются. |
| preferred_value | нет | Назначает предпочтительное значение для маршрутов, полученных от указанного соседа. Значение — целое число от 0 до 65535. | ||
| public_as_only | нет | no_use |
| Если значение равно true, отправляемые сообщения BGP обновлений содержат только общедоступный номер AS, но не содержат частные номера AS. Если значение равно false, отправляемые сообщения BGP обновлений могут содержать частные номера AS. |
| public_as_only_force | нет | no_use |
| Если значение равно true, отправляемые сообщения BGP обновлений содержат только общедоступный номер AS, но не содержат частные номера AS. Если значение равно false, отправляемые сообщения BGP обновлений могут содержать частные номера AS. |
| public_as_only_limited | нет | no_use |
| Ограниченное использование общедоступного номера AS. |
| public_as_only_replace | нет | no_use |
| Замена частного номера AS на общедоступный. |
| public_as_only_skip_peer_as | нет | no_use |
| Пропускать номер AS соседа при использовании только общедоступного номера AS. |
| redirect_ip | нет | no_use |
| Перенаправление IP. |
| redirect_ip_vaildation | нет | no_use |
| Валидация перенаправления IP. |
| reflect_client | нет | no_use |
| Если значение равно true, локальное устройство работает как отражатель маршрутов, а сосед — как клиент отражателя маршрутов. Если значение равно false, функции отражателя маршрутов и клиента не настроены. |
| remote_address | да | IP-адрес соседа (IPv4 или IPv6) для подключения. | ||
| route_limit | нет | Настройка максимального количества маршрутов, которые могут быть приняты от соседа. Значение — целое число от 1 до 4294967295. | ||
| route_limit_idle_timeout | нет | Указывает значение таймера простоя 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 | нет | no_use |
| Если значение равно true, функция замены указанного номера AS-маршрутизатора в атрибуте AS-Path на локальный номер AS включена. Если значение равно false, функция замены указанного номера AS-маршрутизатора в атрибуте AS-Path на локальный номер AS отключена. |
| update_pkt_standard_compatible | нет | no_use |
| Если значение равно true, при получении и обновлении сообщения VPNv4 мульти-маршрутизатором метка отсутствует. Если значение равно false, при получении и обновлении сообщения VPNv4 мульти-маршрутизатором метка присутствует. |
| vpls_ad_disable | нет | no_use |
| Если значение равно true, включить vpls-ad. Если значение равно false, отключить vpls-ad. |
| vpls_enable | нет | no_use |
| Если значение равно true, включить vpls. Если значение равно false, отключить vpls. |
| vrf_name | да | Имя экземпляра BGP. Имя — это чувствительная к регистру строка символов. Экземпляр BGP можно использовать только после создания соответствующего экземпляра VPN. |
Примеры
- 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"
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"
ce_bgp_neighbor_af:
state: absent
vrf_name: js
af_type: ipv4uni
remote_address: 192.168.10.10
nexthop_configure: local
provider: "{{ cli }}"
Значения возврата
Общие значения возврата описаны здесь Значения возврата, следующие поля уникальны для данного модуля:
| имя | описание | возвращаемое | тип | пример |
|---|---|---|---|---|
| changed | проверка, было ли произведено изменение на устройстве | всегда | boolean | True |
| end_state | параметры aaa в формате k/v после выполнения модуля | всегда | dict | {'bgp neighbor af': {'vrf_name': 'js', 'remote_address': '192.168.10.10', 'af_type': 'ipv4uni'}, 'bgp neighbor af other': {'nexthop_configure': 'local', 'vrf_name': 'js', 'af_type': 'ipv4uni'}} |
| existing | параметры существующего сервера aaa в формате k/v | всегда | dict | {'bgp neighbor af': {'vrf_name': 'js', 'remote_address': '192.168.10.10', 'af_type': 'ipv4uni'}, 'bgp neighbor af other': {'nexthop_configure': 'null', 'vrf_name': 'js', 'af_type': 'ipv4uni'}} |
| proposed | переданные в модуль параметры в формате k/v | всегда | dict | {'nexthop_configure': 'local', 'state': 'present', 'vrf_name': 'js', 'remote_address': '192.168.10.10', 'af_type': 'ipv4uni'} |
| updates | команда, отправленная на устройство | всегда | list | ['peer 192.168.10.10 next-hop-local'] |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Для получения помощи в разработке модулей, если вам это интересно, пожалуйста, прочтите Информацию о сообществе и участие в разработке, Тестирование 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/ce_bgp_neighbor_af_module.html