cisco.ios.ios_lacp 模块 – 配置 LACP 的资源模块。

注意

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

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

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

要在 playbook 中使用它，请指定： cisco.ios.ios_lacp。

cisco.ios 1.0.0 中的新增功能

概要 

此模块提供对 Cisco IOS 网络设备上的全局 LACP 的声明式管理。

参数 

参数	注释
config 字典	提供的配置。
system 字典	此选项设置 LACP 的默认系统参数。
priority 整数 / 必需	系统的 LACP 优先级。请参阅供应商文档以了解有效值。
running_config 字符串	此选项仅与 state parsed 一起使用。此选项的值应为通过执行命令 show lacp sys-id 从 IOS 设备接收到的输出。 state parsed 从 `running_config` 选项读取配置，并根据资源模块的 argspec 将其转换为 Ansible 结构化数据，然后该值将返回到结果中的 parsed 密钥中。
state 字符串	配置应保留的状态该模块对替换和覆盖状态具有声明式类似的行为。状态 rendered、gathered 和 parsed 不对设备进行任何更改。状态 rendered 将 `config` 选项中的配置转换为特定于平台的 CLI 命令，这些命令将返回到结果中的 rendered 密钥中。对于状态 rendered，不需要与远程主机的活动连接。状态 gathered 将从设备获取运行配置，并根据资源模块 argspec 将其转换为结构化数据，该值将返回到结果中的 gathered 密钥中。状态 parsed 从 `running_config` 选项读取配置，并根据资源模块参数将其转换为 JSON 格式，该值将返回到结果中的 parsed 密钥中。`running_config` 选项的值应与在设备上执行的命令 show running-config \| include ip route\|ipv6 route 的输出格式相同。对于状态 parsed，不需要与远程主机的活动连接。选项 `"merged"` ← (默认) `"replaced"` `"overridden"` `"deleted"` `"rendered"` `"parsed"` `"gathered"`

备注 

注意

在 CML 上针对 Cisco IOS XE 版本 17.3 进行了测试。
此模块与连接 network_cli 配合使用。请参阅 https://docs.ansible.org.cn/ansible/latest/network/user_guide/platform_ios.html

示例 

# Using merged
#
# Before state:
# -------------
#
# vios#show lacp sys-id
# 32768, 5e00.0000.8000

- name: Merge provided configuration with device configuration
  cisco.ios.ios_lacp:
    config:
      system:
        priority: 123
    state: merged

# After state:
# ------------
#
# vios#show lacp sys-id
# 123, 5e00.0000.8000

# Using replaced
#
# Before state:
# -------------
#
# vios#show lacp sys-id
# 500, 5e00.0000.8000

- name: Replaces Global LACP configuration
  cisco.ios.ios_lacp:
    config:
      system:
        priority: 123
    state: replaced

# After state:
# ------------
#
# vios#show lacp sys-id
# 123, 5e00.0000.8000

# Using Deleted
#
# Before state:
# -------------
#
# vios#show lacp sys-id
# 500, 5e00.0000.8000

- name: Delete Global LACP attribute
  cisco.ios.ios_lacp:
    state: deleted

# After state:
# -------------
#
# vios#show lacp sys-id
# 32768, 5e00.0000.8000

# Using Gathered

# Before state:
# -------------
#
# vios#show lacp sys-id
# 123, 5e00.0000.8000

- name: Gather listed LACP with provided configurations
  cisco.ios.ios_lacp:
    config:
    state: gathered

# Module Execution Result:
# ------------------------
#
# "gathered": {
#         "system": {
#             "priority": 500
#         }
#     }

# After state:
# ------------
#
# vios#show lacp sys-id
# 123, 5e00.0000.8000

# Using Rendered

- name: Render the commands for provided  configuration
  cisco.ios.ios_lacp:
    config:
      system:
        priority: 123
    state: rendered

# Module Execution Result:
# ------------------------
#
# "rendered": [
#         "lacp system-priority 10"
#     ]

# Using Parsed

# File: parsed.cfg
# ----------------
#
# lacp system-priority 123

- name: Parse the commands for provided configuration
  cisco.ios.ios_lacp:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Module Execution Result:
# ------------------------
#
# "parsed": {
#         "system": {
#             "priority": 123
#         }
#     }

返回值 

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

键	描述
after 列表 / 元素=字符串	模块完成后的结构化数据配置。返回：发生更改时示例： `["The configuration returned will always be in the same format\n of the parameters above.\n"]`
before 列表 / 元素=字符串	模块调用之前的结构化数据配置。返回：始终返回示例： `["The configuration returned will always be in the same format\n of the parameters above.\n"]`
commands 列表 / 元素=字符串	推送到远程设备的命令集。返回：始终返回示例： `["lacp system-priority 10"]`

作者

Sumit Jaiswal (@justjais)