bgp_element_facts - Facts about BGP based elements in the SMC

New in version 2.5.

Synopsis

• BGP elements are the building blocks to building a BGP configuration on a layer 3 engine. Use this module to obtain available elements and their values.

Requirements (on host that executes module)

• smc-python

Options

parameter	required	default	choices	comments
case_sensitive	no	True		Whether to do a case sensitive match on the filter specified
element	yes		ip_access_list ip_prefix_list ipv6_access_list ipv6_prefix_list as_path_access_list community_access_list extended_community_access_list external_bgp_peer bgp_peering autonomous_system	Type of bgp element to retrieve
exact_match	no			Whether to do an exact match on the filter specified
filter	no	*		String value to match against when making query. Matches all if not specified. A filter will attempt to find a match in the name, primary key field or comment field of a given record.
limit	no	10		Limit the number of results. Set to 0 to remove limit.
smc_address	no			FQDN with port of SMC. The default value is the environment variable SMC_ADDRESS
smc_alt_filepath	no			Provide an alternate path location to read the credentials from. File is expected to be stored in ~.smcrc. If provided, url and api_key settings are not required and will be ignored.
smc_api_key	no			API key for api client. The default value is the environment variable SMC_API_KEY Required if url
smc_api_version	no			Optional API version to connect to. If none is provided, the latest SMC version API will be used based on the Management Center version. Can be set though the environment variable SMC_API_VERSION
smc_domain	no			Optional domain to log in to. If no domain is provided, 'Shared Domain' is used. Can be set throuh the environment variable SMC_DOMAIN
smc_extra_args	no			Extra arguments to pass to login constructor. These are generally only used if specifically requested by support personnel.
	Dictionary object smc_extra_args parameter required default choices comments verify no True yes no Is the connection to SMC is HTTPS, you can set this to True, or provide a path to a client certificate to verify the SMC SSL certificate. You can also explicitly set this to False.
smc_logging	no			Optionally enable SMC API logging to a file
	Dictionary object smc_logging parameter required default choices comments path yes Full path to the log file level no Log level as specified by the standard python logging library, in int format. Default setting is logging.DEBUG.
smc_timeout	no			Optional timeout for connections to the SMC. Can be set through environment SMC_TIMEOUT

Examples

- name: BGP Facts
  hosts: localhost
  gather_facts: no
  tasks:
  - name: Retrieve all data about ane external bgp peer
    bgp_facts:
      element: external_bgp_peer
      filter: externalpeer

- name: BGP Facts
  hosts: localhost
  gather_facts: no
  tasks:
  - name: Return all data about specified autonomous system
    bgp_facts:
      element: autonomous_system
      filter: remoteas

- name: Routing facts about an engine
  hosts: localhost
  gather_facts: no
  tasks:
  - name: Find details about specific profile
    bgp_facts:
      element: bgp_profile
      filter: Default BGP Profile
      case_sensitive: no

Return Values

Common return values are documented Return Values, the following are the fields unique to this module:

name	description	returned	type	sample
elements	Details about BGP Peering profile	always	list	[{'comment': None, 'default_originate': False, 'send_community': 'no', 'connection_profile': {'session_hold_timer': 180, 'connect_retry': 120, 'session_keep_alive': 60, 'name': 'Default BGP Connection Profile', 'type': 'bgp_connection_profile'}, 'orf_option': 'disabled', 'route_reflector_client': False, 'next_hop_self': True, 'max_prefix_option': 'not_enabled', 'remove_private_as': False, 'connected_check': 'disabled', 'read_only': False, 'soft_reconfiguration': True, 'name': 'mypeering', 'override_capability': False, 'local_as_option': 'not_set', 'system': False, 'ttl_option': 'disabled', 'type': 'bgp_peering', 'dont_capability_negotiate': False}]

Notes

Note

• If a filter is not used in the query, this will return all results for the element type specified. The return data in this case will only contain the metadata for the element which will be name and type. To get detailed information about an element, use a filter. When using filters on network or service elements, the filter value will search the element fields, for example, you could use a filter of ‘1.1.1.1’ when searching for hosts and all hosts with this IP will be returned. The same applies for services. If you are unsure of the service name but know the port you require, your filter can be by port.

Author

• David LePage (@gabstopper)

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.