cisco.iosxr.iosxr_l3_interfaces module – Resource module to configure L3 interfaces.
Note
This module is part of the cisco.iosxr collection (version 9.0.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install cisco.iosxr
.
To use it in a playbook, specify: cisco.iosxr.iosxr_l3_interfaces
.
New in cisco.iosxr 1.0.0
Synopsis
This module provides declarative management of Layer-3 interface on Cisco IOS-XR devices.
Aliases: l3_interfaces
Parameters
Parameter |
Comments |
---|---|
A dictionary of Layer-3 interface options |
|
IPv4 address to be set for the Layer-3 interface mentioned in name option. The address format is <ipv4 address>/<mask>, the mask is number in range 0-32 eg. 192.168.0.1/24 |
|
Configures the IPv4 address for Interface. |
|
Configures the IP address as a secondary address. Choices:
|
|
IPv6 address to be set for the Layer-3 interface mentioned in name option. The address format is <ipv6 address>/<mask>, the mask is number in range 0-128 eg. fd5d:12c9:2201:1::1/64 |
|
Configures the IPv6 address for Interface. |
|
Full name of the interface excluding any logical unit number, i.e. GigabitEthernet0/1. |
|
This option is used only with state parsed. The value of this option should be the output received from the IOS-XR device by executing the command show running-config interface. The state parsed reads the configuration from |
|
The state of the configuration after module completion Choices:
|
Notes
Note
This module works with connection
network_cli
. See the IOS-XR Platform Options.
Examples
# Using merged
# Before state:
# -------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/2
# !
# interface preconfigure GigabitEthernet0/0/0/3
# !
- name: Merge provided configuration with device configuration
cisco.iosxr.iosxr_l3_interfaces:
config:
- name: GigabitEthernet0/0/0/2
ipv4:
- address: 192.168.0.1/24
- name: GigabitEthernet0/0/0/3
ipv4:
- address: 192.168.2.1/24
secondary: true
state: merged
# Task Output
# -----------
#
# before:
# - name: Loopback888
# - name: Loopback999
# - name: GigabitEthernet0/0/0/2
# - name: GigabitEthernet0/0/0/3
# commands:
# - interface GigabitEthernet0/0/0/2
# - ipv4 address 192.168.0.1 255.255.255.0
# - interface GigabitEthernet0/0/0/3
# - ipv4 address 192.168.2.1 255.255.255.0 secondary
# after:
# - name: Loopback888
# - name: Loopback999
# - ipv4:
# - address: 192.168.0.1/24
# name: GigabitEthernet0/0/0/2
# - ipv4:
# - address: 192.168.2.1/24
# secondary: true
# name: GigabitEthernet0/0/0/3
# After state:
# ------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/2
# ipv4 address 192.168.0.1 255.255.255.0
# !
# interface preconfigure GigabitEthernet0/0/0/3
# ipv4 address 192.168.2.1 255.255.255.0 secondary
# !
# Using overridden
# Before state:
# -------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/2
# ipv4 address 192.168.0.1 255.255.255.0
# !
# interface preconfigure GigabitEthernet0/0/0/3
# ipv4 address 192.168.2.1 255.255.255.0 secondary
# !
- name: Override device configuration of all interfaces with provided configuration
cisco.iosxr.iosxr_l3_interfaces:
config:
- name: GigabitEthernet0/0/0/3
ipv4:
- address: 192.168.0.2/24
- address: 192.168.2.1/24
secondary: true
state: overridden
# Task Output
# -----------
#
# before:
# - name: Loopback888
# - name: Loopback999
# - ipv4:
# - address: 192.168.0.1/24
# name: GigabitEthernet0/0/0/2
# - ipv4:
# - address: 192.168.2.1/24
# secondary: true
# name: GigabitEthernet0/0/0/3
# commands:
# - interface GigabitEthernet0/0/0/2
# - no ipv4 address
# - interface GigabitEthernet0/0/0/3
# - ipv4 address 192.168.0.2 255.255.255.0
# - ipv4 address 192.168.0.1 255.255.255.0
# after:
# - name: Loopback888
# - name: Loopback999
# - name: GigabitEthernet0/0/0/2
# - ipv4:
# - address: 192.168.0.1/24
# - address: 192.168.2.1/24
# secondary: true
# name: GigabitEthernet0/0/0/3
# After state:
# -------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/2
# !
# interface preconfigure GigabitEthernet0/0/0/3
# ipv4 address 192.168.0.1 255.255.255.0
# ipv4 address 192.168.2.1 255.255.255.0 secondary
# !
# Using replaced
# Before state:
# -------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/2
# !
# interface preconfigure GigabitEthernet0/0/0/3
# ipv4 address 192.168.0.1 255.255.255.0
# ipv4 address 192.168.2.1 255.255.255.0 secondary
# !
- name: >-
Replaces device configuration of listed interfaces with provided
configuration
cisco.iosxr.iosxr_l3_interfaces:
config:
- name: GigabitEthernet0/0/0/3
ipv6:
- address: 'fd5d:12c9:2201:1::1/64'
- name: GigabitEthernet0/0/0/2
ipv4:
- address: 192.168.0.2/24
state: replaced
# Task Output
# -----------
#
# before:
# - name: Loopback888
# - name: Loopback999
# - name: GigabitEthernet0/0/0/2
# - ipv4:
# - address: 192.168.0.1/24
# - address: 192.168.2.1/24
# secondary: true
# name: GigabitEthernet0/0/0/3
# commands:
# - interface GigabitEthernet0/0/0/3
# - no ipv4 address
# - ipv6 address fd5d:12c9:2201:1::1/64
# - interface GigabitEthernet0/0/0/2
# - ipv4 address 192.168.0.2 255.255.255.0
# after:
# - name: Loopback888
# - name: Loopback999
# - ipv4:
# - address: 192.168.0.2/24
# name: GigabitEthernet0/0/0/2
# - ipv6:
# - address: fd5d:12c9:2201:1::1/64
# name: GigabitEthernet0/0/0/3
# After state:
# -------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/2
# ipv4 address 192.168.0.2 255.255.255.0
# !
# interface preconfigure GigabitEthernet0/0/0/3
# ipv6 address fd5d:12c9:2201:1::1/64
# !
# Using deleted
# Before state:
# -------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/2
# ipv4 address 192.168.0.2 255.255.255.0
# !
# interface preconfigure GigabitEthernet0/0/0/3
# ipv6 address fd5d:12c9:2201:1::1/64
# !
- name: Delete attributes for interfaces (This won't delete the interface itself)
cisco.iosxr.iosxr_l3_interfaces:
config:
- name: GigabitEthernet0/0/0/3
- name: GigabitEthernet0/0/0/4
- name: GigabitEthernet0/0/0/3.700
state: deleted
# Task Output
# -----------
#
# before:
# - name: Loopback888
# - name: Loopback999
# - ipv4:
# - address: 192.168.0.2/24
# name: GigabitEthernet0/0/0/2
# - ipv6:
# - address: fd5d:12c9:2201:1::1/64
# name: GigabitEthernet0/0/0/3
# commands:
# - interface GigabitEthernet0/0/0/3
# - no ipv6 address
# after:
# - name: Loopback888
# - name: Loopback999
# - ipv4:
# - address: 192.168.0.2/24
# name: GigabitEthernet0/0/0/2
# - name: GigabitEthernet0/0/0/3
# After state:
# -------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/2
# ipv4 address 192.168.0.2 255.255.255.0
# !
# interface preconfigure GigabitEthernet0/0/0/3
# !
# Using deleted - will delete all interface configuration and not interface
# Before state:
# -------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/1
# ipv4 address 192.168.2.1 255.255.255.0
# shutdown
# !
# interface preconfigure GigabitEthernet0/0/0/2
# ipv4 address 192.168.3.1 255.255.255.0
# shutdown
# !
# interface preconfigure GigabitEthernet0/0/0/3
# ipv4 address 192.168.0.2 255.255.255.0
# shutdown
# !
# interface preconfigure GigabitEthernet0/0/0/3.700
# ipv4 address 192.168.0.1 255.255.255.0
# !
# interface preconfigure GigabitEthernet0/0/0/4
# ipv6 address fd5d:12c9:2201:1::1/64
# shutdown
# !
- name: "Delete L3 config of all interfaces (This won't delete the interface itself)"
cisco.iosxr.iosxr_l3_interfaces:
state: deleted
# Task Output
# -----------
#
# before:
# - name: Loopback888
# - name: Loopback999
# - ipv4:
# - address: 192.168.2.1/24
# name: GigabitEthernet0/0/0/1
# - ipv4:
# - address: 192.168.3.1/24
# name: GigabitEthernet0/0/0/2
# - ipv4:
# - address: 192.168.0.2/24
# name: GigabitEthernet0/0/0/3
# - ipv4:
# - address: 192.168.0.1/24
# name: GigabitEthernet0/0/0/3.700
# - ipv6:
# - address: fd5d:12c9:2201:1::1/64
# name: GigabitEthernet0/0/0/4
# commands:
# - interface GigabitEthernet0/0/0/1
# - no ipv4 address
# - interface GigabitEthernet0/0/0/2
# - no ipv4 address
# - interface GigabitEthernet0/0/0/3
# - no ipv4 address
# - interface GigabitEthernet0/0/0/3.700
# - no ipv4 address
# - interface GigabitEthernet0/0/0/4
# - no ipv6 address
# after:
# - name: Loopback888
# - name: Loopback999
# - name: GigabitEthernet0/0/0/1
# - name: GigabitEthernet0/0/0/2
# - name: GigabitEthernet0/0/0/3
# - name: GigabitEthernet0/0/0/3.700
# - name: GigabitEthernet0/0/0/4
# After state:
# -------------
#
# viosxr#show running-config interface
# interface Loopback888
# !
# interface Loopback999
# !
# interface MgmtEth0/RP0/CPU0/0
# ipv4 address dhcp
# !
# interface preconfigure GigabitEthernet0/0/0/1
# shutdown
# !
# interface preconfigure GigabitEthernet0/0/0/2
# shutdown
# !
# interface preconfigure GigabitEthernet0/0/0/3
# shutdown
# !
# interface preconfigure GigabitEthernet0/0/0/3.700
# !
# interface preconfigure GigabitEthernet0/0/0/4
# shutdown
# !
# Using parsed
# File: parsed.cfg
# ----------------
#
# interface Loopback888
# description test for ansible
# shutdown
# !
# interface MgmtEth0/0/CPU0/0
# ipv4 address 10.8.38.70 255.255.255.0
# !
# interface GigabitEthernet0/0/0/0
# description Configured and Merged by Ansible-Network
# mtu 66
# ipv4 address 192.0.2.1 255.255.255.0
# ipv4 address 192.0.2.2 255.255.255.0 secondary
# ipv6 address 2001:db8:0:3::/64
# duplex half
# !
# interface GigabitEthernet0/0/0/1
# description Configured and Merged by Ansible-Network
# mtu 66
# speed 100
# duplex full
# dot1q native vlan 10
# l2transport
# l2protocol cdp forward
# l2protocol pvst tunnel
# propagate remote-status
# !
# !
# interface GigabitEthernet0/0/0/3
# ipv4 address 192.0.22.1 255.255.255.0
# ipv4 address 192.0.23.1 255.255.255.0
# !
- name: Convert L3 interfaces config to argspec without connecting to the appliance
cisco.iosxr.iosxr_l3_interfaces:
running_config: "{{ lookup('file', './parsed.cfg') }}"
state: parsed
# Task Output
# -----------
#
# parsed:
# - ipv4:
# - address: 192.0.2.1 255.255.255.0
# - address: 192.0.2.2 255.255.255.0
# secondary: true
# ipv6:
# - address: 2001:db8:0:3::/64
# name: GigabitEthernet0/0/0/0
# - name: GigabitEthernet0/0/0/1
# - ipv4:
# - address: 192.0.22.1 255.255.255.0
# - address: 192.0.23.1 255.255.255.0
# name: GigabitEthernet0/0/0/3
# Using rendered
- name: Render platform specific commands from task input using rendered state
cisco.iosxr.iosxr_l3_interfaces:
config:
- name: GigabitEthernet0/0/0/0
ipv4:
- address: 198.51.100.1/24
- name: GigabitEthernet0/0/0/1
ipv6:
- address: '2001:db8:0:3::/64'
ipv4:
- address: 192.0.2.1/24
- address: 192.0.2.2/24
secondary: true
state: rendered
# Task Output
# -----------
#
# rendered:
# - interface GigabitEthernet0/0/0/0
# - ipv4 address 198.51.100.1 255.255.255.0
# - interface GigabitEthernet0/0/0/1
# - ipv4 address 192.0.2.2 255.255.255.0 secondary
# - ipv4 address 192.0.2.1 255.255.255.0
# - ipv6 address 2001:db8:0:3::/64
# Using gathered
# Before state:
# ------------
#
# RP/0/0/CPU0:an-iosxr-02#show running-config interface
# interface Loopback888
# description test for ansible
# shutdown
# !
# interface MgmtEth0/0/CPU0/0
# ipv4 address 10.8.38.70 255.255.255.0
# !
# interface GigabitEthernet0/0/0/0
# description Configured and Merged by Ansible-Network
# mtu 66
# ipv4 address 192.0.2.1 255.255.255.0
# ipv4 address 192.0.2.2 255.255.255.0 secondary
# ipv6 address 2001:db8:0:3::/64
# duplex half
# !
# interface GigabitEthernet0/0/0/1
# description Configured and Merged by Ansible-Network
# mtu 66
# speed 100
# duplex full
# dot1q native vlan 10
# l2transport
# l2protocol cdp forward
# l2protocol pvst tunnel
# propagate remote-status
# !
# !
# interface GigabitEthernet0/0/0/3
# shutdown
# !
# interface GigabitEthernet0/0/0/4
# shutdown
# dot1q native vlan 40
# !
- name: Gather l3 interfaces facts
cisco.iosxr.iosxr_l3_interfaces:
config:
state: gathered
# Task Output
# -----------
#
# gathered:
# - name: Loopback888
# - ipv4:
# - address: 192.0.2.1 255.255.255.0
# - address: 192.0.2.2 255.255.255.0
# secondary: true
# ipv6:
# - address: 2001:db8:0:3::/64
# name: GigabitEthernet0/0/0/0
# - name: GigabitEthernet0/0/0/1
# - name: GigabitEthernet0/0/0/3
# - name: GigabitEthernet0/0/0/4
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
The configuration as structured data after module completion. Returned: when changed Sample: |
|
The configuration as structured data prior to module invocation. Returned: always Sample: |
|
The set of commands pushed to the remote device Returned: always Sample: |