addBGP

The addBGP operation handles configuration related to BGP model. 

Description

This API call is not allowed on the standby unit in an HA pair.

Data Parameters

Parameter Required Type Description
name True string A string that represents the name of the object
description False string User defined description for this object.
Field level constraints: length must be between 0 and 200 (inclusive). (Note: Additional constraints might exist)
asNumber True string Unique Autonomous number that enables bgp process. Valid values for autonomous number are from 1-4294967295 and 1.0-XX.YY.
Field level constraints: cannot be null, must match pattern [1-9]\d{0,8}|[1-3]\d{9}|4[0-2]\d[0-4]\d[0-6][0-7][0-2]\d[0-5]|(?:(?:[1-9]\d{0,3}|[1-5]\d{4}|6[0-5][0-5][0-3][0-5]).(?:0|[1-9]\d{0,3}|[1-5]\d{4}|6[0-5][0-5][0-3][0-5])). (Note: Additional constraints might exist)
maxasLimit False integer Specifies the maximum number of Autonomous system segments allowed. Valid value is from 1 to 254.
Field level constraints: must be between 1 and 254 (inclusive). (Note: Additional constraints might exist)
logNeighborChanges True boolean Logs the neighbor status. If true, enables the logging of neighbor change messages. Default value is true.
Field level constraints: cannot be null. (Note: Additional constraints might exist)
transportPathMtuDiscovery True boolean If true, enables BGP to automatically discover the best TCP path MTU for each BGP session. Default value is true.
Field level constraints: cannot be null. (Note: Additional constraints might exist)
fastExternalFallOver True boolean Enable BGP to terminate external BGP sessions of any directly adjacent peer if the link used to reach the peer goes down; without waiting for the hold-down timer to expire. Default value is true.
Field level constraints: cannot be null. (Note: Additional constraints might exist)
enforceFirstAs True boolean Allow a BGP routing process to discard updates received from an external BGP (eBGP) peers that do not list their autonomous system (AS) number as the first AS path segment in the AS_PATH attribute of the incoming route. Default value is true.
Field level constraints: cannot be null. (Note: Additional constraints might exist)
asnotationDot True boolean Change the default display and regular expression match format of BGP 4-byte autonomous system numbers from asplain (decimal values) to dot notation. Default value is false.
Field level constraints: cannot be null. (Note: Additional constraints might exist)
bgpTimers True object An instance of type BGPTimers that represents the configuration of timer values for this process.
Field level constraints: cannot be null. (Note: Additional constraints might exist)
bgpGracefulRestart False object An instance of type BGPGracefulRestart that enable or disable the BGP graceful restart capability for a BGP neighbor.
bgpBestPath True object An instance of type BGPBestPath that represents comparision between similar routes received from external BGP (eBGP) peers during the best path selection process and switch the best path to the route with the lowest router ID.
Field level constraints: cannot be null. (Note: Additional constraints might exist)
routerId False string Represents a fixed router ID for the local BGP routing process.
Field level constraints: must be a valid IP address, must match pattern (?:(?:\d|[1-9]\d{1,2}|2[0-4]\d|25[0-5]).){3}(?:\d|[1-9]\d{1,2}|2[0-4]\d|25[0-5]). (Note: Additional constraints might exist)
addressFamilyIPv4 False object An instance of type AFIPv4 that represents the address family configuration to configure a routing session using standard IPv4 address prefixes
addressFamilyIPv6 False object An instance of type AFIPv6 that represents the address family configuration to configure a routing session using standard IPv6 address prefixes
type True string A UTF8 string, all letters lower-case, that represents the class-type. This corresponds to the class name.

Example

- name: Execute 'addBGP' operation
  ftd_configuration:
    operation: "addBGP"
    data:
        name: "{{ name }}"
        description: "{{ description }}"
        asNumber: "{{ as_number }}"
        maxasLimit: "{{ maxas_limit }}"
        logNeighborChanges: "{{ log_neighbor_changes }}"
        transportPathMtuDiscovery: "{{ transport_path_mtu_discovery }}"
        fastExternalFallOver: "{{ fast_external_fall_over }}"
        enforceFirstAs: "{{ enforce_first_as }}"
        asnotationDot: "{{ asnotation_dot }}"
        bgpTimers: "{{ bgp_timers }}"
        bgpGracefulRestart: "{{ bgp_graceful_restart }}"
        bgpBestPath: "{{ bgp_best_path }}"
        routerId: "{{ router_id }}"
        addressFamilyIPv4: "{{ address_family_i_pv4 }}"
        addressFamilyIPv6: "{{ address_family_i_pv6 }}"
        type: "{{ type }}"