cisco.nxos.nxos_l3_interfaces 模块 – L3 接口资源模块
注意
此模块是 cisco.nxos 集合（版本 9.2.1）的一部分。
如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install cisco.nxos。
要在剧本中使用它，请指定：cisco.nxos.nxos_l3_interfaces。
cisco.nxos 1.0.0 中的新增功能
概要
此模块管理 NX-OS 接口的 Layer-3 接口属性。
参数
参数 |
注释 |
|---|---|
Layer-3 接口选项的字典 |
|
在子接口上配置 IEEE 802.1Q VLAN 封装。 |
|
VxLAN evpn 多站点接口跟踪。仅在选定的模型上支持。 选择
|
|
L3 接口的 IPv4 地址和属性。 |
|
L3 接口的 IPv4 地址。 |
|
一个布尔属性，用于管理辅助 IP 地址的添加。 选择
|
|
本地/直接路由的 URI 路由标签值。 |
|
L3 接口的 IPv6 地址和属性。 |
|
L3 接口的 IPv6 地址。 |
|
本地/直接路由的 URI 路由标签值。 |
|
启用/禁用 ipv6 重定向。 选择
|
|
L3 接口的全名，例如 Ethernet1/1。 |
|
启用/禁用 ipv4 重定向。 选择
|
|
启用/禁用 ip 重定向。 选择
|
|
此选项仅与状态 parsed 一起使用。 此选项的值应该是通过执行命令 show running-config | section ‘^interface’ 从 NX-OS 设备接收的输出。 状态 parsed 从 |
|
模块完成后配置的状态。 状态 overridden 会使用任务中提供的配置覆盖设备上所有接口的 IP 地址配置。使用此状态时请谨慎，因为您可能会失去对设备的访问权限。 选择
|
注意
注意
在 VIRL 上针对 NXOS 7.3.(0)D1(1) 进行了测试
不支持 Cisco MDS
示例
# Using merged
# Before state:
# -------------
#
# router# show running-config | section interface
# interface Ethernet1/6
# description Configured by Ansible Network
# no switchport
# no shutdown
# interface Ethernet1/7
# description Configured by Ansible
# no switchport
# no shutdown
# interface mgmt0
# description mgmt interface
# ip address dhcp
# vrf member management
- name: Merge provided configuration with device configuration.
cisco.nxos.nxos_l3_interfaces:
config:
- name: Ethernet1/6
ipv4:
- address: 192.168.1.1/24
tag: 5
- address: 10.1.1.1/24
secondary: true
tag: 10
ipv6:
- address: fd5d:12c9:2201:2::1/64
tag: 6
- name: Ethernet1/7.42
redirects: false
unreachables: false
state: merged
# Task Output
# -----------
#
# before:
# - name: Ethernet1/6
# - name: Ethernet1/7
# - ipv4:
# - address: dhcp
# name: mgmt0
# commands:
# - interface Ethernet1/6
# - ip address 192.168.1.1/24 tag 5
# - ip address 10.1.1.1/24 secondary tag 10
# - ipv6 address fd5d:12c9:2201:2::1/64 tag 6
# - interface Ethernet1/7
# - no ip redirects
# after:
# - ipv4:
# - address: 192.168.1.1/24
# tag: 5
# - address: 10.1.1.1/24
# secondary: true
# tag: 10
# ipv6:
# - address: fd5d:12c9:2201:2::1/64
# tag: 6
# name: Ethernet1/6
# redirects: false
# - name: Ethernet1/7
# redirects: false
# - ipv4:
# - address: dhcp
# name: mgmt0
# After state:
# ------------
#
# router# show running-config | section interface
# interface Ethernet1/6
# description Configured by Ansible Network
# no switchport
# no ip redirects
# ip address 192.168.1.1/24 tag 5
# ip address 10.1.1.1/24 secondary tag 10
# ipv6 address fd5d:12c9:2201:2::1/64 tag 6
# no shutdown
# interface Ethernet1/7
# description Configured by Ansible
# no switchport
# no ip redirects
# no shutdown
# interface mgmt0
# description mgmt interface
# ip address dhcp
# vrf member management
# Using replaced
# Before state:
# -------------
#
# router# show running-config | section interface
# interface Ethernet1/6
# description Configured by Ansible Network
# no switchport
# no ip redirects
# ip address 192.168.1.1/24 tag 5
# ip address 10.1.1.1/24 secondary tag 10
# ipv6 address fd5d:12c9:2201:2::1/64 tag 6
# no shutdown
# interface Ethernet1/7
# description Configured by Ansible
# no switchport
# no ip redirects
# no shutdown
# interface mgmt0
# description mgmt interface
# ip address dhcp
# vrf member management
- name: Replace device configuration of specified L3 interfaces with provided configuration.
cisco.nxos.nxos_l3_interfaces:
config:
- name: Ethernet1/6
ipv4:
- address: 192.168.22.3/24
state: replaced
# Task Output
# -----------
#
# before:
# - ipv4:
# - address: 192.168.1.1/24
# tag: 5
# - address: 10.1.1.1/24
# secondary: true
# tag: 10
# ipv6:
# - address: fd5d:12c9:2201:2::1/64
# tag: 6
# name: Ethernet1/6
# redirects: false
# - name: Ethernet1/7
# redirects: false
# - ipv4:
# - address: dhcp
# name: mgmt0
# commands:
# - interface Ethernet1/6
# - ip address 192.168.22.3/24
# - no ipv6 address fd5d:12c9:2201:2::1/64
# - ip redirects
# after:
# - ipv4:
# - address: 192.168.22.3/24
# - address: 10.1.1.1/24
# secondary: true
# tag: 10
# name: Ethernet1/6
# redirects: false
# - name: Ethernet1/7
# redirects: false
# - ipv4:
# - address: dhcp
# name: mgmt0
# After state:
# ------------
#
# router# show running-config | section interface
# interface Ethernet1/6
# description Configured by Ansible Network
# no switchport
# no ip redirects
# ip address 192.168.22.3/24
# ip address 10.1.1.1/24 secondary tag 10
# no shutdown
# interface Ethernet1/7
# description Configured by Ansible
# no switchport
# no ip redirects
# no shutdown
# interface mgmt0
# description mgmt interface
# ip address dhcp
# vrf member management
# Using overridden
# Before state:
# -------------
#
# router# show running-config | section interface
# interface Ethernet1/6
# description Configured by Ansible Network
# no switchport
# no ip redirects
# ip address 192.168.1.1/24 tag 5
# ip address 10.1.1.1/24 secondary tag 10
# ipv6 address fd5d:12c9:2201:2::1/64 tag 6
# no shutdown
# interface Ethernet1/7
# description Configured by Ansible
# no switchport
# no ip redirects
# no shutdown
# interface Ethernet1/7.42
# no ip redirects
# interface mgmt0
# description mgmt interface
# ip address dhcp
# vrf member management
- name: Override device configuration with provided configuration.
cisco.nxos.nxos_l3_interfaces:
config:
- ipv4:
- address: dhcp
name: mgmt0
- name: Ethernet1/6
ipv4:
- address: 192.168.22.3/24
state: overridden
# Task Output
# -----------
#
# before:
# - ipv4:
# - address: 192.168.1.1/24
# tag: 5
# - address: 10.1.1.1/24
# secondary: true
# tag: 10
# ipv6:
# - address: fd5d:12c9:2201:2::1/64
# tag: 6
# name: Ethernet1/6
# redirects: false
# - name: Ethernet1/7
# redirects: false
# - name: Ethernet1/7.42
# redirects: false
# - ipv4:
# - address: dhcp
# name: mgmt0
# commands:
# - interface Ethernet1/6
# - no ipv6 address fd5d:12c9:2201:2::1/64
# - no ip address 10.1.1.1/24 secondary
# - ip address 192.168.22.3/24
# - ip redirects
# - interface Ethernet1/7
# - ip redirects
# - interface Ethernet1/7.42
# - ip redirects
# after:
# - ipv4:
# - address: 192.168.22.3/24
# name: Ethernet1/6
# - name: Ethernet1/7
# - name: Ethernet1/7.42
# - ipv4:
# - address: dhcp
# name: mgmt0
# After state:
# ------------
#
# router# show running-config | section interface
# interface Ethernet1/6
# description Configured by Ansible Network
# no switchport
# ip address 192.168.22.3/24
# no shutdown
# interface Ethernet1/7
# description Configured by Ansible
# no switchport
# no shutdown
# interface Ethernet1/7.42
# interface mgmt0
# description mgmt interface
# ip address dhcp
# vrf member management
# Using deleted
# Before state:
# -------------
#
# router# show running-config | section interface
# interface Ethernet1/6
# description Configured by Ansible Network
# no switchport
# ip address 192.168.22.3/24
# no shutdown
# interface Ethernet1/7
# description Configured by Ansible
# no switchport
# no shutdown
# interface Ethernet1/7.42
# interface mgmt0
# description mgmt interface
# ip address dhcp
# vrf member management
- name: Delete L3 attributes of given interfaces (This won't delete the interface
itself).
cisco.nxos.nxos_l3_interfaces:
config:
- name: Ethernet1/6
- name: Ethernet1/2
state: deleted
# Task Output
# -----------
#
# before:
# - name: Ethernet1/2
# - ipv4:
# - address: 192.168.22.3/24
# name: Ethernet1/6
# - name: Ethernet1/7
# - name: Ethernet1/7.42
# - ipv4:
# - address: dhcp
# name: mgmt0
# commands:
# - interface Ethernet1/6
# - no ip address
# after:
# - name: Ethernet1/2
# - name: Ethernet1/7
# - name: Ethernet1/7.42
# - ipv4:
# - address: dhcp
# name: mgmt0
# After state:
# ------------
#
# router# show running-config | section interface
# interface Ethernet1/6
# description Configured by Ansible Network
# no switchport
# no shutdown
# interface Ethernet1/7
# description Configured by Ansible
# no switchport
# no shutdown
# interface Ethernet1/7.42
# interface mgmt0
# description mgmt interface
# ip address dhcp
# vrf member management
# Using rendered
- name: Use rendered state to convert task input to device specific commands
cisco.nxos.nxos_l3_interfaces:
config:
- name: Ethernet1/800
ipv4:
- address: 192.168.1.100/24
tag: 5
- address: 10.1.1.1/24
secondary: true
tag: 10
- name: Ethernet1/800
ipv6:
- address: fd5d:12c9:2201:2::1/64
tag: 6
state: rendered
# Task Output
# -----------
#
# rendered:
# - interface Ethernet1/800
# - ip address 192.168.1.100/24 tag 5
# - ip address 10.1.1.1/24 secondary tag 10
# - interface Ethernet1/800
# - ipv6 address fd5d:12c9:2201:2::1/64 tag 6
# Using parsed
# parsed.cfg
# ----------
#
# interface Ethernet1/800
# ip address 192.168.1.100/24 tag 5
# ip address 10.1.1.1/24 secondary tag 10
# no ip redirects
# interface Ethernet1/801
# ipv6 address fd5d:12c9:2201:2::1/64 tag 6
# ip unreachables
# interface mgmt0
# ip address dhcp
# vrf member management
- name: Use parsed state to convert externally supplied config to structured format
cisco.nxos.nxos_l3_interfaces:
running_config: "{{ lookup('file', 'parsed.cfg') }}"
state: parsed
# Task output
# -----------
#
# parsed:
# - name: Ethernet1/800
# ipv4:
# - address: 192.168.1.100/24
# tag: 5
# - address: 10.1.1.1/24
# secondary: True
# tag: 10
# redirects: False
# - name: Ethernet1/801
# ipv6:
# - address: fd5d:12c9:2201:2::1/64
# tag: 6
# unreachables: True
# Using gathered
# Before state:
# -------------
#
# interface Ethernet1/1
# ip address 192.0.2.100/24
# interface Ethernet1/2
# no ip redirects
# ip address 203.0.113.10/24
# ip unreachables
# ipv6 address 2001:db8::1/32
- name: Gather l3_interfaces facts from the device using nxos_l3_interfaces
cisco.nxos.nxos_l3_interfaces:
state: gathered
# Task output
# -----------
#
# gathered:
# - name: Ethernet1/1
# ipv4:
# - address: 192.0.2.100/24
# - name: Ethernet1/2
# ipv4:
# - address: 203.0.113.10/24
# ipv6:
# - address: 2001:db8::1/32
# redirects: False
# unreachables: True
返回值
常见的返回值记录在 此处，以下是此模块特有的字段
键 |
描述 |
|---|---|
模块完成后配置的结构化数据。 已返回：当更改时 示例： |
|
调用模块之前的配置结构化数据。 已返回：始终 示例： |
|
推送到远程设备的命令集。 已返回：始终 示例： |