cisco.nxos.nxos_gir_profile_management 模块 – 为 GIR 创建维护模式或正常模式配置文件。

注意

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

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

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

要在剧本中使用它，请指定： cisco.nxos.nxos_gir_profile_management。

cisco.nxos 1.0.0 中的新增功能

概要

  • 使用可在优雅移除或优雅插入期间应用的配置命令来管理维护模式或正常模式配置文件。

参数

参数

注释

commands

列表 / 元素=字符串

要包含在配置文件中的命令列表。

mode

字符串 / 必需

将配置文件配置为维护模式或正常模式。

选项

  • "maintenance"

  • "normal"

state

字符串

指定资源的所需状态。

选项

  • "present" ← (默认)

  • "absent"

注释

注意

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

  • 不支持 Cisco MDS

  • state=absent 将删除整个配置文件。

  • 有关使用 CLI 和 NX-API 的信息，请参阅：ref:`NXOS 平台选项指南 <nxos_platform_options>`

  • 有关使用 Ansible 管理网络设备的更多信息，请参阅：ref:`Ansible 网络指南 <network_guide>`

  • 有关使用 Ansible 管理 Cisco 设备的更多信息，请参阅 `Cisco 集成页面 <https://ansible.org.cn/integrations/networks/cisco>`_。

示例

# Create a maintenance-mode profile
- cisco.nxos.nxos_gir_profile_management:
    mode: maintenance
    commands:
      - router eigrp 11
      - isolate

# Remove the maintenance-mode profile
- cisco.nxos.nxos_gir_profile_management:
    mode: maintenance
    state: absent

返回值

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

键

描述

changed

布尔值

检查设备上是否进行了更改

返回：始终

示例： true

end_state

列表 / 元素=字符串

模块执行后配置文件条目的列表。

返回：详细模式

示例： ["router bgp 65535", "isolate", "router eigrp 10", "isolate", "diagnostic bootup level complete", "router eigrp 11", "isolate"]

existing

列表 / 元素=字符串

现有配置文件命令的列表。

返回：详细模式

示例： ["router bgp 65535", "isolate", "router eigrp 10", "isolate", "diagnostic bootup level complete"]

proposed

列表 / 元素=字符串

传递到模块的命令列表。

返回：详细模式

示例： ["router eigrp 11", "isolate"]

updates

列表 / 元素=字符串

发送到设备的命令

返回：始终

示例： ["configure maintenance profile maintenance-mode", "router eigrp 11", "isolate"]

作者

  • Gabriele Gerbino (@GGabriele)