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 接口的第 3 层接口属性。
参数
参数 |
注释 |
|---|---|
第 3 层接口选项的字典 |
|
在子接口上配置 IEEE 802.1Q VLAN 封装。 |
|
VxLAN evpn 多站点接口跟踪。仅在选定型号上受支持。 选项
|
|
L3 接口的 IPv4 地址和属性。 |
|
L3 接口的 IPv4 地址。 |
|
用于管理添加辅助 IP 地址的布尔属性。 选项
|
|
本地/直接路由的 URIB 路由标签值。 |
|
L3 接口的 IPv6 地址和属性。 |
|
L3 接口的 IPv6 地址。 |
|
本地/直接路由的 URIB 路由标签值。 |
|
启用/禁用 ipv6 重定向。 选项
|
|
L3 接口的全名，例如 Ethernet1/1。 |
|
启用/禁用 ipv4 重定向。 选项
|
|
启用/禁用 ip 重定向。 选项
|
|
此选项仅与 state *parsed* 一起使用。 此选项的值应为通过执行命令 **show running-config | section ‘^interface’** 从 NX-OS 设备接收到的输出。 state *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
返回值
常见的返回值已在此处记录，以下是此模块独有的字段
键 |
描述 |
|---|---|
模块完成后的配置作为结构化数据。 返回：已更改时 示例： |
|
模块调用之前的配置作为结构化数据。 返回：始终返回 示例： |
|
推送到远程设备的命令集。 返回：始终返回 示例： |