cisco.ios.ios_ospfv3_module.rst

cisco.ios.ios_ospfv3

Resource module to configure OSPFv3.

Version added: 1.1.0

• Synopsis
• Parameters
• Notes
• Examples
• Return Values
• Status

Synopsis

• This module configures and manages the Open Shortest Path First (OSPF) version 3 on IOS platforms.

Parameters

Parameter							Choices/Defaults	Comments
config dictionary								A list of configurations for ospfv3.
	processes list / elements=dictionary							List of OSPF instance configurations.
		address_family list / elements=dictionary						Enter Address Family command mode
			adjacency dictionary					Control adjacency formation
				disable boolean			Choices: no yes	Disable adjacency staggering
				max_adjacency integer				Maximum number of adjacencies allowed to be forming Please refer vendor documentation for valid values
				min_adjacency integer				Initial number of adjacencies allowed to be forming in an area Please refer vendor documentation for valid values
				none boolean			Choices: no yes	No initial
			afi string				Choices: ipv4 ipv6	Enter Address Family command mode
			areas list / elements=dictionary					OSPF area parameters
				area_id string				OSPF area ID as a decimal value. Please refer vendor documentation of Valid values. OSPF area ID in IP address format(e.g. A.B.C.D)
				authentication dictionary				Authentication parameters
					key_chain string			Use a key-chain for cryptographic authentication keys
					null boolean		Choices: no yes	Use no authentication
				default_cost integer				Set the summary default-cost of a NSSA/stub area Stub's advertised external route metric Note, please refer vendor documentation for respective valid values
				filter_list list / elements=dictionary				Filter networks between OSPFv3 areas
					direction string / required		Choices: in out	The direction to apply on the filter networks sent to and from this area.
					name string			Name of an IP prefix-list
				normal boolean			Choices: no yes	Specify a normal area type
				nssa dictionary				Specify a NSSA area
					default_information_originate dictionary			Originate Type 7 default into NSSA area
						metric integer		OSPF default metric
						metric_type integer	Choices: 1 2	OSPF metric type for default routes OSPF Link State type
						nssa_only boolean	Choices: no yes	Limit default advertisement to this NSSA area
					no_redistribution boolean		Choices: no yes	No redistribution into this NSSA area
					no_summary boolean		Choices: no yes	Do not send summary LSA into NSSA
					set boolean		Choices: no yes	Enable a NSSA area
					translate string		Choices: always suppress-fa	Translate LSA Always translate LSAs on this ABR Suppress forwarding address in translated LSAs
				ranges list / elements=dictionary				Summarize routes matching address/mask (border routers only)
					address string			IP address to match
					advertise boolean		Choices: no yes	Advertise this range (default) Since, advertise when enabled is not shown in running-config idempotency won't be maintained for the play in the second or next run of the play.
					cost integer			User specified metric for this range
					netmask string			IP mask for address
					not_advertise boolean		Choices: no yes	DoNotAdvertise this range
				sham_link dictionary				Define a sham link and its parameters
					authentication dictionary			Authentication parameters
						key_chain string		Use a key-chain for cryptographic authentication keys
						null boolean	Choices: no yes	Use no authentication
					cost integer			Associate a cost with the sham-link Cost of the sham-link
					destination string			IPv6 address associated with sham-link destination (X:X:X:X::X)
					source string			IPv6 address associated with sham-link source (X:X:X:X::X)
					ttl_security integer			TTL security check maximum number of hops allowed
				stub dictionary				Specify a stub area Backbone can not be configured as stub area
					no_summary boolean		Choices: no yes	Do not send summary LSA into stub area
					set boolean		Choices: no yes	Enable a stub area
			authentication dictionary					Authentication parameters Authentication operation mode
				deployment boolean			Choices: no yes	Deployment mode of operation
				normal boolean			Choices: no yes	Normal mode of operation
			auto_cost dictionary					Calculate OSPF interface cost according to bandwidth
				reference_bandwidth integer				Use reference bandwidth method to assign OSPF cost Note, refer vendor documentation for respective valid values
				set boolean			Choices: no yes	Enable OSPF auto-cost
			bfd dictionary					BFD configuration commands
				all_interfaces boolean			Choices: no yes	Enable BFD on all interfaces
				disable boolean			Choices: no yes	Disable BFD on all interfaces
			capability boolean				Choices: no yes	Enable a specific feature Do not perform PE specific checks
			compatible dictionary					OSPFv3 router compatibility list
				rfc1583 boolean			Choices: no yes	compatible with RFC 1583
				rfc1587 boolean			Choices: no yes	compatible with RFC 1587
				rfc5243 boolean			Choices: no yes	supports DBD exchange optimization
			default_information dictionary					Control distribution of default information
				always boolean			Choices: no yes	Always advertise default route
				metric integer				OSPF default metric Note, refer vendor documentation for respective valid values
				metric_type integer				OSPF metric type for default routes Note, please refer vendor documentation for respective valid range
				originate boolean			Choices: no yes	Distribute a default route
				route_map string				Route-map reference name
			default_metric integer					Set metric of redistributed routes
			discard_route dictionary					Enable or disable discard-route installation
				external boolean			Choices: no yes	Discard route for summarised redistributed routes
				internal boolean			Choices: no yes	Discard route for summarised inter-area routes
				sham_link boolean			Choices: no yes	Discard route for sham-link routes
			distance integer					Define an administrative distance Note, please refer vendor documentation for respective valid range
			distribute_list dictionary					Filter networks in routing updates
				acls list / elements=dictionary				IP access list
					direction string / required		Choices: in out	Filter incoming and outgoing routing updates.
					interface string			Interface configuration (GigabitEthernet A/B) Valid with incoming traffic
					name string / required			IP access list name/number
					protocol string			Protocol config (bgp 1). Valid with outgoing traffic
				prefix dictionary				Filter prefixes in routing updates
					direction string / required		Choices: in out	Filter incoming and outgoing routing updates.
					gateway_name string			Gateway name for filtering incoming updates based on gateway
					interface string			Interface configuration (GigabitEthernet A/B) Valid with incoming traffic
					name string / required			Name of an IP prefix-list
					protocol string			Protocol config (bgp 1). Valid with outgoing traffic
				route_map dictionary				Filter prefixes in routing updates
					name string / required			Route-map name
			event_log dictionary					Event Logging
				enable boolean			Choices: no yes	Enable event Logging
				one_shot boolean			Choices: no yes	Disable Logging When Log Buffer Becomes Full
				pause boolean			Choices: no yes	Pause Event Logging
				size integer				Maximum Number of Events Stored in the Event Log Note, refer vendor documentation for respective valid values
			graceful_restart dictionary					Graceful-restart options helper support
				disable boolean			Choices: no yes	disable helper support
				enable boolean			Choices: no yes	helper support enabled
				strict_lsa_checking boolean			Choices: no yes	enable helper strict LSA checking
			interface_id dictionary					Source of the interface ID
				ios_if_index boolean			Choices: no yes	IOS interface number
				snmp_if_index boolean			Choices: no yes	SNMP MIB ifIndex
			limit dictionary					Limit a specific OSPF feature
				dc dictionary				Demand circuit retransmissions
					disable boolean		Choices: no yes	Disble the feature
					number integer			The maximum number of retransmissions
				non_dc dictionary				Non-demand-circuit retransmissions
					disable boolean		Choices: no yes	Disble the feature
					number integer			The maximum number of retransmissions
			local_rib_criteria dictionary					Enable or disable usage of local RIB as route criteria
				enable boolean			Choices: no yes	Enable usage of local RIB as route criteria
				forwarding_address boolean			Choices: no yes	Local RIB used to validate external/NSSA forwarding addresses
				inter_area_summary boolean			Choices: no yes	Local RIB used as criteria for inter-area summaries
				nssa_translation boolean			Choices: no yes	Local RIB used as criteria for NSSA translation
			log_adjacency_changes dictionary					Log changes in adjacency state
				detail boolean			Choices: no yes	Log all state changes
				set boolean			Choices: no yes	Log changes in adjacency state
			manet dictionary					Specify MANET OSPF parameters
				cache dictionary				Specify MANET cache sizes
					acknowledgement integer			Specify MANET acknowledgement cache size Maximum number of acknowledgements in cache
					update integer			Specify MANET LSA cache size Maximum number of LSAs in cache
				hello dictionary				Unicast Hellos rather than multicast
					multicast boolean		Choices: no yes	Multicast Hello requests and responses rather than unicast
					unicast boolean		Choices: no yes	Unicast Hello requests and responses rather than multicast
				peering dictionary				MANET OSPF Smart Peering
					disable boolean		Choices: no yes	Disable selective peering
					per_interface boolean		Choices: no yes	Select peers per interface rather than per node
					redundancy integer			Redundant paths Number of redundant OSPF paths
					set boolean		Choices: no yes	Enable selective peering
				willingness integer				Specify and Relay willingness value
			max_lsa dictionary					Maximum number of non self-generated LSAs to accept
				ignore_count integer				Maximum number of times adjacencies can be suppressed Note, refer vendor documentation for respective valid values
				ignore_time integer				Number of minutes during which all adjacencies are suppressed Note, refer vendor documentation for respective valid values
				number integer				Maximum number of non self-generated LSAs to accept Note, refer vendor documentation for respective valid values
				reset_time integer				Number of minutes after which ignore-count is reset to zero Note, refer vendor documentation for respective valid values
				threshold_value integer				Threshold value (%) at which to generate a warning msg Note, refer vendor documentation for respective valid values
				warning_only boolean			Choices: no yes	Only give a warning message when limit is exceeded
			max_metric dictionary					Set maximum metric Maximum metric in self-originated router-LSAs
				disable boolean			Choices: no yes	disable maximum metric in self-originated router-LSAs
				external_lsa integer				Override external-lsa metric with max-metric value Overriding metric in external-LSAs Note, refer vendor documentation for respective valid values
				inter_area_lsas integer				Override inter-area-lsas metric with max-metric value Overriding metric in inter-area-LSAs Note, refer vendor documentation for respective valid values
				on_startup dictionary				Set maximum metric temporarily after reboot
					time integer			Time, in seconds, router-LSAs are originated with max-metric Note, please refer vendor documentation for respective valid range
					wait_for_bgp boolean		Choices: no yes	Let BGP decide when to originate router-LSA with normal metric
				stub_prefix_lsa boolean			Choices: no yes	Set maximum metric for stub links in prefix LSAs
			maximum_paths integer					Forward packets over multiple paths Number of paths
			passive_interface string					Suppress routing updates on an interface
			prefix_suppression dictionary					Prefix suppression
				disable boolean			Choices: no yes	Disable prefix suppression
				enable boolean			Choices: no yes	Enable prefix suppression
			queue_depth dictionary					Hello/Router process queue depth
				hello dictionary				OSPF Hello process queue depth
					max_packets integer			maximum number of packets in the queue
					unlimited boolean		Choices: no yes	Unlimited queue depth
				update dictionary				OSPF Router process queue depth
					max_packets integer			maximum number of packets in the queue
					unlimited boolean		Choices: no yes	Unlimited queue depth
			router_id string					Router-id address for this OSPF process OSPF router-id in IP address format (A.B.C.D)
			shutdown dictionary					Shutdown the router process
				disable boolean			Choices: no yes	Disable Shutdown
				enable boolean			Choices: no yes	Shutdown the router process
			summary_prefix dictionary					Configure IP address summaries
				address string				IP summary address (A.B.C.D) IP prefix <network>/<length> (A.B.C.D/nn)
				mask string				IP Summary mask
				not_advertise boolean			Choices: no yes	Do not advertise or translate
				nssa_only boolean			Choices: no yes	Limit summary to NSSA areas
				tag integer				Set tag
			timers dictionary					Adjust routing timers
				lsa integer				OSPF LSA timers, arrival timer The minimum interval in milliseconds between accepting the same LSA Note, refer vendor documentation for respective valid values
				manet dictionary				OSPF MANET timers
					cache dictionary			Specify MANET cache sizes
						acknowledgement integer		Specify MANET acknowledgement cache size
						redundancy integer		Specify MANET LSA cache size
					hello boolean		Choices: no yes	Unicast Hellos rather than multicast Unicast Hello requests and responses rather than multicast
					peering dictionary			MANET OSPF Smart Peering
						per_interface boolean	Choices: no yes	Select peers per interface rather than per node
						redundancy integer		Redundant paths Number of redundant OSPF paths
						set boolean	Choices: no yes	Enable selective peering
					willingness integer			Specify and Relay willingness value
				pacing dictionary				OSPF pacing timers
					flood integer			OSPF flood pacing timer The minimum interval in msec to pace limit flooding on interface Note, refer vendor documentation for respective valid values
					lsa_group integer			OSPF LSA group pacing timer Interval in sec between group of LSA being refreshed or maxaged Note, refer vendor documentation for respective valid values
					retransmission integer			OSPF retransmission pacing timer The minimum interval in msec between neighbor retransmissions Note, refer vendor documentation for respective valid values
				throttle dictionary				OSPF throttle timers
					lsa dictionary			OSPF LSA throttle timers
						first_delay integer		Delay to generate first occurrence of LSA in milliseconds Note, refer vendor documentation for respective valid values
						max_delay integer		Maximum delay between originating the same LSA in milliseconds Note, refer vendor documentation for respective valid values
						min_delay integer		Minimum delay between originating the same LSA in milliseconds Note, refer vendor documentation for respective valid values
					spf dictionary			OSPF SPF throttle timers - Delay between receiving a change to SPF calculation in milliseconds - Note, refer vendor documentation for respective valid values
						between_delay integer		Delay between first and second SPF calculation in milliseconds Note, refer vendor documentation for respective valid values
						max_delay integer		Maximum wait time in milliseconds for SPF calculations Note, refer vendor documentation for respective valid values
						receive_delay integer		Delay between receiving a change to SPF calculation in milliseconds Note, refer vendor documentation for respective valid values
			unicast boolean				Choices: no yes	Address Family modifier
			vrf string					Specify parameters for a VPN Routing/Forwarding instance
		adjacency dictionary						Control adjacency formation
			max_adjacency integer					Maximum number of adjacencies allowed to be forming Please refer vendor documentation for valid values
			min_adjacency integer					Initial number of adjacencies allowed to be forming in an area Please refer vendor documentation for valid values
			none boolean				Choices: no yes	No initial
		areas list / elements=dictionary						OSPF area parameters
			area_id string					OSPF area ID as a decimal value. Please refer vendor documentation of Valid values. OSPF area ID in IP address format(e.g. A.B.C.D)
			authentication dictionary					Authentication parameters
				ipsec dictionary				Use IPsec authentication
					hex_string string			SHA-1 key (40 chars)
					md5 integer			Use MD5 authentication
					sha1 integer			Use SHA-1 authentication
					spi integer			Set the SPI (Security Parameters Index)
				key_chain string				Use a key-chain for cryptographic authentication keys
			default_cost integer					Set the summary default-cost of a NSSA/stub area Stub's advertised external route metric Note, please refer vendor documentation for respective valid values
			nssa dictionary					Specify a NSSA area
				default_information_originate dictionary				Originate Type 7 default into NSSA area
					metric integer			OSPF default metric
					metric_type integer		Choices: 1 2	OSPF metric type for default routes OSPF Link State type
					nssa_only boolean		Choices: no yes	Limit default advertisement to this NSSA area
				no_redistribution boolean			Choices: no yes	No redistribution into this NSSA area
				no_summary boolean			Choices: no yes	Do not send summary LSA into NSSA
				set boolean			Choices: no yes	Enable a NSSA area
				translate string			Choices: always suppress-fa	Translate LSA Always translate LSAs on this ABR Suppress forwarding address in translated LSAs
			stub dictionary					Specify a stub area Backbone can not be configured as stub area
				no_summary boolean			Choices: no yes	Do not send summary LSA into stub area
				set boolean			Choices: no yes	Enable a stub area
		authentication boolean					Choices: no yes	Authentication parameter mode Deployment mode of operation
		auto_cost dictionary						Calculate OSPF interface cost according to bandwidth
			reference_bandwidth integer					Use reference bandwidth method to assign OSPF cost Note, refer vendor documentation for respective valid values
			set boolean				Choices: no yes	Enable OSPF auto-cost
		bfd boolean					Choices: no yes	BFD configuration commands Enable BFD on all interfaces
		compatible dictionary						OSPFv3 router compatibility list
			rfc1583 boolean				Choices: no yes	compatible with RFC 1583
			rfc1587 boolean				Choices: no yes	compatible with RFC 1587
			rfc5243 boolean				Choices: no yes	supports DBD exchange optimization
		event_log dictionary						Event Logging
			enable boolean				Choices: no yes	Enable event Logging
			one_shot boolean				Choices: no yes	Disable Logging When Log Buffer Becomes Full
			pause boolean				Choices: no yes	Pause Event Logging
			size integer					Maximum Number of Events Stored in the Event Log Note, refer vendor documentation for respective valid values
		graceful_restart dictionary						Graceful-restart options for helper support
			disable boolean				Choices: no yes	disable helper support
			strict_lsa_checking boolean				Choices: no yes	enable helper strict LSA checking
		help boolean					Choices: no yes	Description of the interactive help system
		interface_id boolean					Choices: no yes	Source of the interface ID SNMP MIB ifIndex
		limit dictionary						Limit a specific OSPF feature and LS update, DBD, and LS request retransmissions
			dc dictionary					Demand circuit retransmissions
				disable boolean			Choices: no yes	Disable the feature
				number integer				The maximum number of retransmissions
			non_dc dictionary					Non-demand-circuit retransmissions
				disable boolean			Choices: no yes	Disable the feature
				number integer				The maximum number of retransmissions
		local_rib_criteria dictionary						Enable or disable usage of local RIB as route criteria
			enable boolean				Choices: no yes	Enable usage of local RIB as route criteria
			forwarding_address boolean				Choices: no yes	Local RIB used to validate external/NSSA forwarding addresses
			inter_area_summary boolean				Choices: no yes	Local RIB used as criteria for inter-area summaries
			nssa_translation boolean				Choices: no yes	Local RIB used as criteria for NSSA translation
		log_adjacency_changes dictionary						Log changes in adjacency state
			detail boolean				Choices: no yes	Log all state changes
			set boolean				Choices: no yes	Log changes in adjacency state
		manet dictionary						Specify MANET OSPF parameters
			cache dictionary					Specify MANET cache sizes
				acknowledgement integer				Specify MANET acknowledgement cache size
				redundancy integer				Specify MANET LSA cache size
			hello boolean				Choices: no yes	Unicast Hellos rather than multicast Unicast Hello requests and responses rather than multicast
			peering dictionary					MANET OSPF Smart Peering
				per_interface boolean			Choices: no yes	Select peers per interface rather than per node
				redundancy integer				Redundant paths Number of redundant OSPF paths
				set boolean			Choices: no yes	Enable selective peering
			willingness integer					Specify and Relay willingness value
		max_lsa dictionary						Maximum number of non self-generated LSAs to accept
			ignore_count integer					Maximum number of times adjacencies can be suppressed Note, refer vendor documentation for respective valid values
			ignore_time integer					Number of minutes during which all adjacencies are suppressed Note, refer vendor documentation for respective valid values
			number integer					Maximum number of non self-generated LSAs to accept Note, refer vendor documentation for respective valid values
			reset_time integer					Number of minutes after which ignore-count is reset to zero Note, refer vendor documentation for respective valid values
			threshold_value integer					Threshold value (%) at which to generate a warning msg Note, refer vendor documentation for respective valid values
			warning_only boolean				Choices: no yes	Only give a warning message when limit is exceeded
		max_metric dictionary						Set maximum metric
			external_lsa integer					Override external-lsa metric with max-metric value Overriding metric in external-LSAs Note, refer vendor documentation for respective valid values
			include_stub boolean				Choices: no yes	Set maximum metric for stub links in router-LSAs
			on_startup dictionary					Set maximum metric temporarily after reboot
				time integer				Time, in seconds, router-LSAs are originated with max-metric Note, please refer vendor documentation for respective valid range
				wait_for_bgp boolean			Choices: no yes	Let BGP decide when to originate router-LSA with normal metric
			router_lsa boolean / required				Choices: no yes	Maximum metric in self-originated router-LSAs
			summary_lsa integer					Override summary-lsa metric with max-metric value Note, please refer vendor documentation for respective valid range
		passive_interface string						Suppress routing updates on an interface
		prefix_suppression boolean					Choices: no yes	Enable prefix suppression
		process_id integer / required						Process ID
		queue_depth dictionary						Hello/Router process queue depth
			hello dictionary					OSPF Hello process queue depth
				max_packets integer				maximum number of packets in the queue
				unlimited boolean			Choices: no yes	Unlimited queue depth
		router_id string						Router-id address for this OSPF process OSPF router-id in IP address format (A.B.C.D)
		shutdown boolean					Choices: no yes	Shutdown the router process
		timers dictionary						Adjust routing timers
			lsa integer					OSPF LSA timers, arrival timer The minimum interval in milliseconds between accepting the same LSA Note, refer vendor documentation for respective valid values
			manet dictionary					OSPF MANET timers
				cache dictionary				Specify MANET cache sizes
					acknowledgement integer			Specify MANET acknowledgement cache size
					redundancy integer			Specify MANET LSA cache size
				hello boolean			Choices: no yes	Unicast Hellos rather than multicast Unicast Hello requests and responses rather than multicast
				peering dictionary				MANET OSPF Smart Peering
					per_interface boolean		Choices: no yes	Select peers per interface rather than per node
					redundancy integer			Redundant paths Number of redundant OSPF paths
					set boolean		Choices: no yes	Enable selective peering
				willingness integer				Specify and Relay willingness value
			pacing dictionary					OSPF pacing timers
				flood integer				OSPF flood pacing timer The minimum interval in msec to pace limit flooding on interface Note, refer vendor documentation for respective valid values
				lsa_group integer				OSPF LSA group pacing timer Interval in sec between group of LSA being refreshed or maxaged Note, refer vendor documentation for respective valid values
				retransmission integer				OSPF retransmission pacing timer The minimum interval in msec between neighbor retransmissions Note, refer vendor documentation for respective valid values
			throttle dictionary					OSPF throttle timers
				lsa dictionary				OSPF LSA throttle timers
					first_delay integer			Delay to generate first occurrence of LSA in milliseconds Note, refer vendor documentation for respective valid values
					max_delay integer			Maximum delay between originating the same LSA in milliseconds Note, refer vendor documentation for respective valid values
					min_delay integer			Minimum delay between originating the same LSA in milliseconds Note, refer vendor documentation for respective valid values
				spf dictionary				OSPF SPF throttle timers - Delay between receiving a change to SPF calculation in milliseconds - Note, refer vendor documentation for respective valid values
					between_delay integer			Delay between first and second SPF calculation in milliseconds Note, refer vendor documentation for respective valid values
					max_delay integer			Maximum wait time in milliseconds for SPF calculations Note, refer vendor documentation for respective valid values
					receive_delay integer			Delay between receiving a change to SPF calculation in milliseconds Note, refer vendor documentation for respective valid values
running_config string								This option is used only with state parsed. The value of this option should be the output received from the IOS device by executing the command sh running-config | section ^router ospfv3. The state parsed reads the configuration from running_config option and transforms it into Ansible structured data as per the resource module's argspec and the value is then returned in the parsed key within the result.
state string							Choices: merged ← replaced overridden deleted gathered parsed rendered	The state the configuration should be left in The states rendered, gathered and parsed does not perform any change on the device. The state rendered will transform the configuration in config option to platform specific CLI commands which will be returned in the rendered key within the result. For state rendered active connection to remote host is not required. The state gathered will fetch the running configuration from device and transform it into structured data in the format as per the resource module argspec and the value is returned in the gathered key within the result. The state parsed reads the configuration from running_config option and transforms it into JSON format as per the resource module parameters and the value is returned in the parsed key within the result. The value of running_config option should be the same format as the output of command show running-config | include ip route|ipv6 route executed on device. For state parsed active connection to remote host is not required.

Notes

Note

• Tested against Cisco IOSXE Version 17.3 on CML.
• This module works with connection network_cli. See https://docs.ansible.com/ansible/latest/network/user_guide/platform_ios.html

Examples

# Using merged

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router-ios#

- name: Merge provided OSPFV3 configuration
  cisco.ios.ios_ospfv3:
    config:
      processes:
        - process_id: 1
          max_metric:
            router_lsa: true
            on_startup:
              time: 110
          address_family:
            - afi: ipv4
              unicast: true
              vrf: blue
              adjacency:
                min_adjacency: 50
                max_adjacency: 50
              areas:
                - area_id: 25
                  nssa:
                    default_information_originate:
                      metric: 25
                      nssa_only: true
          areas:
            - area_id: "10"
              nssa:
                default_information_originate:
                  metric: 10
          timers:
            throttle:
              lsa:
                first_delay: 12
                min_delay: 14
                max_delay: 16
        - process_id: 200
          address_family:
            - afi: ipv4
              unicast: true
              adjacency:
                min_adjacency: 200
                max_adjacency: 200
          max_metric:
            router_lsa: true
            on_startup:
              time: 100
          auto_cost:
            reference_bandwidth: 4
    state: merged

# Task Output:
# ------------

# before: {}
#
# commands:
# - router ospfv3 1
# - max-metric router-lsa on-startup 110
# - area 10 nssa default-information-originate metric 10
# - address-family ipv4 unicast vrf blue
# - adjacency stagger 50 50
# - area 25 nssa default-information-originate metric 25 nssa-only
# - exit-address-family
# - router ospfv3 200
# - auto-cost reference-bandwidth 4
# - max-metric router-lsa on-startup 100
# - address-family ipv4 unicast
# - adjacency stagger 200 200
# - exit-address-family
#
# after:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 50
#           min_adjacency: 50
#         afi: ipv4
#         areas:
#         - area_id: '25'
#           nssa:
#             default_information_originate:
#               metric: 25
#               nssa_only: true
#         unicast: true
#         vrf: blue
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 110
#         router_lsa: true
#       process_id: 1
#     - address_family:
#       - adjacency:
#           max_adjacency: 200
#           min_adjacency: 200
#         afi: ipv4
#         unicast: true
#       auto_cost:
#         reference_bandwidth: 4
#       max_metric:
#         on_startup:
#           time: 100
#         router_lsa: true
#       process_id: 200

# After state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

# Using deleted

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Delete provided OSPF V3 processes
  cisco.ios.ios_ospfv3:
    config:
      processes:
        - process_id: 1
    state: deleted

# Task Output:
# ------------

# before:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 50
#           min_adjacency: 50
#         afi: ipv4
#         areas:
#         - area_id: '25'
#           nssa:
#             default_information_originate:
#               metric: 25
#               nssa_only: true
#         unicast: true
#         vrf: blue
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 110
#         router_lsa: true
#       process_id: 1
#     - address_family:
#       - adjacency:
#           max_adjacency: 200
#           min_adjacency: 200
#         afi: ipv4
#         unicast: true
#       auto_cost:
#         reference_bandwidth: 4
#       max_metric:
#         on_startup:
#           time: 100
#         router_lsa: true
#       process_id: 200
#
# commands:
# - no router ospfv3 1
#
# parsed:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 200
#           min_adjacency: 200
#         afi: ipv4
#         unicast: true
#       auto_cost:
#         reference_bandwidth: 4
#       max_metric:
#         on_startup:
#           time: 100
#         router_lsa: true
#       process_id: 200
#
# After state:
# ------------
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

# Using deleted without any config passed (NOTE: This will delete all OSPFV3 configuration from device)

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Delete all OSPF processes
  cisco.ios.ios_ospfv3:
    state: deleted

# Task Output:
# ------------

# before:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 50
#           min_adjacency: 50
#         afi: ipv4
#         areas:
#         - area_id: '25'
#           nssa:
#             default_information_originate:
#               metric: 25
#               nssa_only: true
#         unicast: true
#         vrf: blue
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 110
#         router_lsa: true
#       process_id: 1
#     - address_family:
#       - adjacency:
#           max_adjacency: 200
#           min_adjacency: 200
#         afi: ipv4
#         unicast: true
#       auto_cost:
#         reference_bandwidth: 4
#       max_metric:
#         on_startup:
#           time: 100
#         router_lsa: true
#       process_id: 200
#
# commands:
# - no router ospfv3 200
# - no router ospfv3 1
#
# after: {}
#
# After state:
# ------------
# router-ios#sh running-config | section ^router ospfv3
# router-ios#


# Using overridden

# Before state:
# -------------
#
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Override provided OSPFV3 configuration
  cisco.ios.ios_ospfv3:
    config:
      processes:
        - process_id: 200
          max_metric:
            router_lsa: true
            on_startup:
              time: 200
          address_family:
            - afi: ipv4
              unicast: true
              adjacency:
                min_adjacency: 50
                max_adjacency: 50
              areas:
                - area_id: 200
                  nssa:
                    default_information_originate:
                      metric: 200
                      nssa_only: true
          areas:
            - area_id: "10"
              nssa:
                default_information_originate:
                  metric: 10
    state: overridden

# Task Output:
# ------------

# before:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 50
#           min_adjacency: 50
#         afi: ipv4
#         areas:
#         - area_id: '25'
#           nssa:
#             default_information_originate:
#               metric: 25
#               nssa_only: true
#         unicast: true
#         vrf: blue
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 110
#         router_lsa: true
#       process_id: 1
#     - address_family:
#       - adjacency:
#           max_adjacency: 200
#           min_adjacency: 200
#         afi: ipv4
#         unicast: true
#       auto_cost:
#         reference_bandwidth: 4
#       max_metric:
#         on_startup:
#           time: 100
#         router_lsa: true
#       process_id: 200
#
# commands:
# - no router ospfv3 1
# - router ospfv3 200
# - no auto-cost reference-bandwidth 4
# - max-metric router-lsa on-startup 200
# - area 10 nssa default-information-originate metric 10
# - address-family ipv4 unicast
# - adjacency stagger 50 50
# - area 200 nssa default-information-originate metric 200 nssa-only
# - exit-address-family
#
# after:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 50
#           min_adjacency: 50
#         afi: ipv4
#         areas:
#         - area_id: '200'
#           nssa:
#             default_information_originate:
#               metric: 200
#               nssa_only: true
#         unicast: true
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 200
#         router_lsa: true
#       process_id: 200

# After state:
# ------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 200
#  max-metric router-lsa on-startup 200
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast
#   adjacency stagger 50 50
#   area 200 nssa default-information-originate metric 200 nssa-only
#  exit-address-family

# Using replaced

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Perform replace with provided configurations.
  cisco.ios.ios_ospfv3:
    config:
      processes:
        - process_id: 200
          max_metric:
            router_lsa: true
            on_startup:
              time: 200
          address_family:
            - afi: ipv4
              unicast: true
              adjacency:
                min_adjacency: 50
                max_adjacency: 50
              areas:
                - area_id: 200
                  nssa:
                    default_information_originate:
                      metric: 200
                      nssa_only: true
          areas:
            - area_id: "10"
              nssa:
                default_information_originate:
                  metric: 10
    state: replaced

# Task Output:
# ------------

# before:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 50
#           min_adjacency: 50
#         afi: ipv4
#         areas:
#         - area_id: '25'
#           nssa:
#             default_information_originate:
#               metric: 25
#               nssa_only: true
#         unicast: true
#         vrf: blue
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 110
#         router_lsa: true
#       process_id: 1
#     - address_family:
#       - adjacency:
#           max_adjacency: 200
#           min_adjacency: 200
#         afi: ipv4
#         unicast: true
#       auto_cost:
#         reference_bandwidth: 4
#       max_metric:
#         on_startup:
#           time: 100
#         router_lsa: true
#       process_id: 200
#
# commands:
# - router ospfv3 200
# - no auto-cost reference-bandwidth 4
# - max-metric router-lsa on-startup 200
# - area 10 nssa default-information-originate metric 10
# - address-family ipv4 unicast
# - adjacency stagger 50 50
# - area 200 nssa default-information-originate metric 200 nssa-only
# - exit-address-family
#
# after:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 50
#           min_adjacency: 50
#         afi: ipv4
#         areas:
#         - area_id: '25'
#           nssa:
#             default_information_originate:
#               metric: 25
#               nssa_only: true
#         unicast: true
#         vrf: blue
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 110
#         router_lsa: true
#       process_id: 1
#     - address_family:
#       - afi: ipv4
#         areas:
#         - area_id: '200'
#           nssa:
#             default_information_originate:
#               metric: 200
#               nssa_only: true
#         unicast: true
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 200
#         router_lsa: true
#       process_id: 200
#
# After state:
# -------------
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 200
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast
#   adjacency stagger 50 50
#   area 200 nssa default-information-originate metric 200 nssa-only
#  exit-address-family

# Using Gathered

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Gather OSPFV3 provided configurations
  cisco.ios.ios_ospfv3:
    config:
    state: gathered

# Task Output:
# ------------
#
# parsed:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 50
#           min_adjacency: 50
#         afi: ipv4
#         areas:
#         - area_id: '25'
#           nssa:
#             default_information_originate:
#               metric: 25
#               nssa_only: true
#         unicast: true
#         vrf: blue
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 110
#         router_lsa: true
#       process_id: 1
#     - address_family:
#       - adjacency:
#           max_adjacency: 200
#           min_adjacency: 200
#         afi: ipv4
#         unicast: true
#       auto_cost:
#         reference_bandwidth: 4
#       max_metric:
#         on_startup:
#           time: 100
#         router_lsa: true
#       process_id: 200

# After state:
# ------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

# Using Rendered

- name: Render the commands for provided  configuration
  cisco.ios.ios_ospfv3:
    config:
      processes:
        - process_id: 1
          max_metric:
            router_lsa: true
            on_startup:
              time: 110
          address_family:
            - afi: ipv4
              unicast: true
              vrf: blue
              adjacency:
                min_adjacency: 50
                max_adjacency: 50
              areas:
                - area_id: 25
                  nssa:
                    default_information_originate:
                      metric: 25
                      nssa_only: true
          areas:
            - area_id: "10"
              nssa:
                default_information_originate:
                  metric: 10
          timers:
            throttle:
              lsa:
                first_delay: 12
                min_delay: 14
                max_delay: 16
        - process_id: 200
          address_family:
            - afi: ipv4
              unicast: true
              adjacency:
                min_adjacency: 200
                max_adjacency: 200
          max_metric:
            router_lsa: true
            on_startup:
              time: 100
          auto_cost:
            reference_bandwidth: 4
    state: rendered

# Task Output:
# ------------

# rendered:
# - router ospfv3 1
# - max-metric router-lsa on-startup 110
# - area 10 nssa default-information-originate metric 10
# - address-family ipv4 unicast vrf blue
# - adjacency stagger 50 50
# - area 25 nssa default-information-originate metric 25 nssa-only
# - exit-address-family
# - router ospfv3 200
# - auto-cost reference-bandwidth 4
# - max-metric router-lsa on-startup 100
# - address-family ipv4 unicast
# - adjacency stagger 200 200
# - exit-address-family


# Using Parsed

# File: parsed.cfg
# ----------------
#
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Parse the provided configuration and display structured ospfv3 facts.
  cisco.ios.ios_ospfv3:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Task Output:
# ------------
#
# parsed:
#     processes:
#     - address_family:
#       - adjacency:
#           max_adjacency: 50
#           min_adjacency: 50
#         afi: ipv4
#         areas:
#         - area_id: '25'
#           nssa:
#             default_information_originate:
#               metric: 25
#               nssa_only: true
#         unicast: true
#         vrf: blue
#       areas:
#       - area_id: '10'
#         nssa:
#           default_information_originate:
#             metric: 10
#       max_metric:
#         on_startup:
#           time: 110
#         router_lsa: true
#       process_id: 1
#     - address_family:
#       - adjacency:
#           max_adjacency: 200
#           min_adjacency: 200
#         afi: ipv4
#         unicast: true
#       auto_cost:
#         reference_bandwidth: 4
#       max_metric:
#         on_startup:
#           time: 100
#         router_lsa: true
#       process_id: 200

Return Values

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

Key	Returned	Description
after dictionary	when changed	The resulting configuration model invocation. Sample: The configuration returned will always be in the same format of the parameters above.
before dictionary	always	The configuration prior to the model invocation. Sample: The configuration returned will always be in the same format of the parameters above.
commands list	always	The set of commands pushed to the remote device. Sample: ['router ospfv3 1', 'address-family ipv4 unicast vrf blue', 'adjacency stagger 50 50']
gathered dictionary	when state is gathered	Facts about the network resource gathered from the remote device as structured data. Sample: This output will always be in the same format as the module argspec.
parsed dictionary	when state is parsed	The device native config provided in running_config option parsed into structured data as per module argspec. Sample: This output will always be in the same format as the module argspec.
rendered list	when state is rendered	The provided configuration in the task rendered in device-native format (offline). Sample: ['router ospfv3 1', 'max-metric router-lsa on-startup 110', 'area 10 nssa default-information-originate metric 10']

Status

Authors

• Sumit Jaiswal (@justjais)