cisco.nxos.nxos_lacp_interfaces 模块 – LACP 接口资源模块

注意

此模块是 cisco.nxos 集合 (版本 9.2.1) 的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install cisco.nxos。

要在 playbook 中使用它，请指定：cisco.nxos.nxos_lacp_interfaces。

cisco.nxos 1.0.0 版本新增

概要

  • 此模块管理 NX-OS 接口的链路聚合控制协议 (LACP) 属性。

参数

参数

注释

config

列表 / 元素=字典

LACP 接口选项的字典。

convergence

字典

此字典包含与收敛相关的可配置选项。仅适用于端口通道。

graceful

布尔值

端口通道 LACP 优雅收敛。仅当 LACP 端口连接到非 Nexus 对等设备时才禁用此选项。如果与 Nexus 对等设备一起禁用此选项，可能会导致端口暂停。

选择

  • false

  • true

vpc

布尔值

为 vPC 端口通道启用 LACP 收敛。

选择

  • false

  • true

字典

此字典包含与端口通道的最大和最小链路相关的可配置选项。仅适用于端口通道。

整数

端口通道最大捆绑数。

整数

端口通道最小链路数。

mode

字符串

LACP 模式。仅适用于端口通道。

选择

  • "delay"

name

字符串 / 必需

接口的名称。

port_priority

整数

接口的 LACP 端口优先级。范围 1-65535。仅适用于以太网。

rate

字符串

LACP 发送 PDU 的速率。仅适用于以太网。在快速速率下，LACP 每 1 秒传输一次。在正常速率下，LACP 在链路捆绑后每 30 秒传输一次。

选择

  • "fast"

  • "normal"

suspend_individual

布尔值

端口通道 LACP 状态。禁用此选项将导致 LACP 将端口置于单独状态，并且在端口通道中没有收到来自对等端口的 LACP BPDU 时，不会暂停端口。

选择

  • false

  • true

running_config

字符串

此选项仅与状态 *parsed* 一起使用。

此选项的值应是通过执行命令 **show running-config | section ^interface** 从 NX-OS 设备收到的输出。

状态 *parsed* 从 running_config 选项读取配置，并根据资源模块的 argspec 将其转换为 Ansible 结构化数据，然后该值将返回到结果中的 *parsed* 键中。

state

字符串

模块完成后的配置状态。

选择

  • "merged" ←（默认）

  • "replaced"

  • "overridden"

  • "deleted"

  • "gathered"

  • "rendered"

  • "parsed"

备注

注意

  • 在 VIRL 上针对 NXOS 7.3.(0)D1(1) 进行了测试

  • 不支持 Cisco MDS

示例

# Using merged

# Before state:
# -------------
#

- name: Merge provided configuration with device configuration.
  cisco.nxos.nxos_lacp_interfaces:
    config:
      - name: Ethernet1/3
        port_priority: 5
        rate: fast
    state: merged

# After state:
# ------------
#
# interface Ethernet1/3
# lacp port-priority 5
# lacp rate fast


# Using replaced

# Before state:
# -------------
#
# interface Ethernet1/3
#   lacp port-priority 5
# interface port-channel11
#   lacp mode delay

- name: Replace device lacp interfaces configuration with the given configuration.
  cisco.nxos.nxos_lacp_interfaces:
    config:
      - name: port-channel11
        links:
          min: 4
    state: replaced

# After state:
# ------------
#
# interface Ethernet1/3
#   lacp port-priority 5
# interface port-channel11
#   lacp min-links 4


# Using overridden

# Before state:
# -------------
#
# interface Ethernet1/3
#   lacp port-priority 5
# interface port-channel11
#   lacp mode delay

- name: Override device configuration of all LACP interfaces attributes of given interfaces
    on device with provided configuration.
  cisco.nxos.nxos_lacp_interfaces:
    config:
      - name: port-channel11
        links:
          min: 4
    state: overridden

# After state:
# ------------
#
# interface port-channel11
# lacp min-links 4


# Using deleted

# Before state:
# -------------
#
# interface Ethernet1/3
#   lacp port-priority 5
# interface port-channel11
#   lacp mode delay

- name: Delete LACP interfaces configurations.
  cisco.nxos.nxos_lacp_interfaces:
    state: deleted

# After state:
# ------------
#

# Using rendered

- name: Use rendered state to convert task input to device specific commands
  cisco.nxos.nxos_lacp_interfaces:
    config:
      - name: Ethernet1/800
        rate: fast
      - name: Ethernet1/801
        rate: fast
        port_priority: 32
      - name: port-channel10
        links:
          max: 15
          min: 2
        convergence:
          graceful: true
    state: rendered

# Task Output (redacted)
# -----------------------

# rendered:
#  - "interface Ethernet1/800"
#  - "lacp rate fast"
#  - "interface Ethernet1/801"
#  - "lacp port-priority 32"
#  - "lacp rate fast"
#  - "interface port-channel10"
#  - "lacp min-links 2"
#  - "lacp max-bundle 15"
#  - "lacp graceful-convergence"

# Using parsed

# parsed.cfg
# ------------

# interface port-channel10
#   lacp min-links 10
#   lacp max-bundle 15
# interface Ethernet1/800
#   lacp port-priority 100
#   lacp rate fast

- name: Use parsed state to convert externally supplied config to structured format
  cisco.nxos.nxos_lacp_interfaces:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Task output (redacted)
# -----------------------

# parsed:
#   - name: port-channel10
#     links:
#       max: 15
#       min: 10
#   - name: Ethernet1/800
#     port_priority: 100
#     rate: fast

# Using gathered

# Existing device config state
# -------------------------------
# interface Ethernet1/1
#   lacp port-priority 5
#   lacp rate fast
# interface port-channel10
#   lacp mode delay
# interface port-channel11
#   lacp max-bundle 10
#   lacp min-links 5

- name: Gather lacp_interfaces facts from the device using nxos_lacp_interfaces
  cisco.nxos.nxos_lacp_interfaces:
    state: gathered

# Task output (redacted)
# -----------------------
# gathered:
#  - name: Ethernet1/1
#    port_priority: 5
#    rate: fast
#  - name: port-channel10
#    mode: delay
#  - name: port-channel11
#    links:
#      max: 10
#      min: 5

返回值

常见的返回值记录在此处，以下是此模块特有的字段

键

描述

after

列表 / 元素=字符串

模块完成后，配置将作为结构化数据。

返回: 当发生更改时

示例: ["返回的配置将始终与上述参数的格式相同。\n"]

before

列表 / 元素=字符串

调用模块之前的配置作为结构化数据。

返回: 始终

示例: ["返回的配置将始终与上述参数的格式相同。\n"]

commands

列表 / 元素=字符串

推送到远程设备的命令集。

返回: 始终

示例: ["interface port-channel10", "lacp min-links 5", "lacp mode delay"]

作者

  • Trishna Guha (@trishnaguha)