ansible / ansible.builtin / v2.4.6.0-1 / module / ce_bgp_neighbor_af Manages BGP neighbor Address-family configuration on HUAWEI CloudEngine switches. | "added in version" 2.4 of ansible.builtin" Authors: wangdezhuang (@CloudEngine-Ansible) preview | supported by communityansible.builtin.ce_bgp_neighbor_af (v2.4.6.0-1) — module
pip
Install with pip install ansible==2.4.6.0.post1
Manages BGP neighbor Address-family configurations on HUAWEI CloudEngine switches.
- 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 }}"
af_type: choices: - ipv4uni - ipv4multi - ipv4vpn - ipv6uni - ipv6vpn - evpn description: - Address family type of a BGP instance. required: true orftype: default: null description: - ORF Type. The value is an integer ranging from 0 to 65535. required: false orf_mode: choices: - 'null' - receive - send - both default: null description: - ORF mode. null, Default value. receive, ORF for incoming packets. send, ORF for outgoing packets. both, ORF for incoming and outgoing packets. required: false vrf_name: description: - Name of a BGP instance. The name is a case-sensitive string of characters. The BGP instance can be used only after the corresponding VPN instance is created. required: true soostring: default: null description: - Configure the Site-of-Origin (SoO) extended community attribute. The value is a string of 3 to 21 characters. required: false redirect_ip: choices: - no_use - 'true' - 'false' default: no_use description: - Redirect ip. required: false route_limit: default: null description: - Configure the maximum number of routes that can be accepted from a peer. The value is an integer ranging from 1 to 4294967295. required: false vpls_enable: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, vpls enable. If the value is false, vpls disable. required: false add_path_mode: choices: - 'null' - receive - send - both default: null description: - null, Null. receive, Support receiving Add-Path routes. send, Support sending Add-Path routes. both, Support receiving and sending Add-Path routes. required: false advertise_arp: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, advertised ARP routes are distinguished. If the value is false, advertised ARP routes are not distinguished. required: false advertise_irb: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, advertised IRB routes are distinguished. If the value is false, advertised IRB routes are not distinguished. required: false public_as_only: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, sent BGP update messages carry only the public AS number but do not carry private AS numbers. If the value is false, sent BGP update messages can carry private AS numbers. required: false reflect_client: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, the local device functions as the route reflector and a peer functions as a client of the route reflector. If the value is false, the route reflector and client functions are not configured. required: false remote_address: description: - IPv4 or IPv6 peer connection address. required: true keep_all_routes: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, the system stores all route update messages received from all peers (groups) after BGP connection setup. If the value is false, the system stores only BGP update messages that are received from peers and pass the configured import policy. required: false origin_as_valid: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, Application results of route announcement. If the value is false, Routing application results are not notified. required: false preferred_value: default: null description: - Assign a preferred value for the routes learned from a specified peer. The value is an integer ranging from 0 to 65535. required: false vpls_ad_disable: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, enable vpls-ad. If the value is false, disable vpls-ad. required: false adv_add_path_num: default: null description: - The number of addPath advertise route. The value is an integer ranging from 2 to 64. required: false route_limit_type: choices: - noparameter - alertOnly - idleForever - idleTimeout default: null description: - Noparameter, After the number of received routes exceeds the threshold and the timeout timer expires,no action. AlertOnly, An alarm is generated and no additional routes will be accepted if the maximum number of routes allowed have been received. IdleForever, The connection that is interrupted is not automatically re-established if the maximum number of routes allowed have been received. IdleTimeout, After the number of received routes exceeds the threshold and the timeout timer expires, the connection that is interrupted is automatically re-established. required: false rt_updt_interval: default: null description: - Specify the minimum interval at which Update packets are sent. The value is an integer, in seconds. The value is an integer ranging from 0 to 600. required: false nexthop_configure: choices: - 'null' - local - invariable default: null description: - null, The next hop is not changed. local, The next hop is changed to the local IP address. invariable, Prevent the device from changing the next hop of each imported IGP route when advertising it to its BGP peers. required: false advertise_community: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, the community attribute is advertised to peers. If the value is false, the community attribute is not advertised to peers. required: false allow_as_loop_limit: default: null description: - Set the maximum number of repetitive local AS number. The value is an integer ranging from 1 to 10. required: false ipprefix_orf_enable: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, the address prefix-based Outbound Route Filter (ORF) capability is enabled for peers. If the value is false, the address prefix-based Outbound Route Filter (ORF) capability is disabled for peers. required: false route_limit_percent: default: null description: - Specify the percentage of routes when a router starts to generate an alarm. The value is an integer ranging from 1 to 100. required: false allow_as_loop_enable: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, repetitive local AS numbers are allowed. If the value is false, repetitive local AS numbers are not allowed. required: false public_as_only_force: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, sent BGP update messages carry only the public AS number but do not carry private AS numbers. If the value is false, sent BGP update messages can carry private AS numbers. required: false substitute_as_enable: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, the function to replace a specified peer's AS number in the AS-Path attribute with the local AS number is enabled. If the value is false, the function to replace a specified peer's AS number in the AS-Path attribute with the local AS number is disabled. required: false default_rt_adv_enable: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, the function to advertise default routes to peers is enabled. If the value is false, the function to advertise default routes to peers is disabled. required: false default_rt_adv_policy: default: null description: - Specify the name of a used policy. The value is a string. The value is a string of 1 to 40 characters. required: false default_rt_match_mode: choices: - 'null' - matchall - matchany default: null description: - null, Null. matchall, Advertise the default route if all matching conditions are met. matchany, Advertise the default route if any matching condition is met. required: false discard_ext_community: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, the extended community attribute in the peer route information is discarded. If the value is false, the extended community attribute in the peer route information is not discarded. required: false export_as_path_filter: default: null description: - Apply an AS_Path-based filtering policy to the routes to be advertised to a specified peer. The value is an integer ranging from 1 to 256. required: false export_pref_filt_name: default: null description: - Specify the IPv4 filtering policy applied to the routes to be advertised to a specified peer. The value is a string of 1 to 169 characters. required: false export_rt_policy_name: default: null description: - Specify the filtering policy applied to the routes to be advertised to a peer. The value is a string of 1 to 40 characters. required: false import_as_path_filter: default: null description: - Apply an AS_Path-based filtering policy to the routes received from a specified peer. The value is an integer ranging from 1 to 256. required: false import_pref_filt_name: default: null description: - Specify the IPv4 filtering policy applied to the routes received from a specified peer. The value is a string of 1 to 169 characters. required: false import_rt_policy_name: default: null description: - Specify the filtering policy applied to the routes learned from a peer. The value is a string of 1 to 40 characters. required: false export_acl_name_or_num: default: null description: - Apply an IPv4 ACL-based filtering policy to the routes to be advertised to a specified peer. The value is a string of 1 to 32 characters. required: false import_acl_name_or_num: default: null description: - Apply an IPv4 ACL-based filtering policy to the routes received from a specified peer. The value is a string of 1 to 32 characters. required: false is_nonstd_ipprefix_mod: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, Non-standard capability codes are used during capability negotiation. If the value is false, RFC-defined standard ORF capability codes are used during capability negotiation. required: false public_as_only_limited: choices: - no_use - 'true' - 'false' default: no_use description: - Limited use public as number. required: false public_as_only_replace: choices: - no_use - 'true' - 'false' default: no_use description: - Private as replaced by public as number. required: false redirect_ip_vaildation: choices: - no_use - 'true' - 'false' default: no_use description: - Redirect ip vaildation. required: false advertise_ext_community: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, the extended community attribute is advertised to peers. If the value is false, the extended community attribute is not advertised to peers. required: false advertise_remote_nexthop: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, the remote next-hop attribute is advertised to peers. If the value is false, the remote next-hop attribute is not advertised to any peers. required: false route_limit_idle_timeout: default: null description: - Specify the value of the idle-timeout timer to automatically reestablish the connections after they are cut off when the number of routes exceeds the set threshold. The value is an integer ranging from 1 to 1200. required: false export_as_path_name_or_num: default: null description: - Application of a AS path list based filtering policy to the routing of a specified peer. required: false import_as_path_name_or_num: default: null description: - A routing strategy based on the AS path list for routing received by a designated peer. required: false public_as_only_skip_peer_as: choices: - no_use - 'true' - 'false' default: no_use description: - Public as only skip peer as. required: false update_pkt_standard_compatible: choices: - no_use - 'true' - 'false' default: no_use description: - If the value is true, When the vpnv4 multicast neighbor receives and updates the message, the message has no label. If the value is false, When the vpnv4 multicast neighbor receives and updates the message, the message has label. required: false
changed: description: check to see if a change was made on the device returned: always sample: true type: boolean end_state: description: k/v pairs of aaa params after module execution returned: always sample: 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 type: dict existing: description: k/v pairs of existing aaa server returned: always sample: 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 type: dict proposed: description: k/v pairs of parameters passed into module returned: always sample: af_type: ipv4uni nexthop_configure: local remote_address: 192.168.10.10 state: present vrf_name: js type: dict updates: description: command sent to the device returned: always sample: - peer 192.168.10.10 next-hop-local type: list