cisco.nxos.nxos_hsrp 模块 – 管理 NX-OS 交换机上的 HSRP 配置。

注意

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

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

要安装它,请使用: ansible-galaxy collection install cisco.nxos

要在 playbook 中使用它,请指定: cisco.nxos.nxos_hsrp

cisco.nxos 1.0.0 中的新增功能

概要

  • 管理 NX-OS 交换机上的 HSRP 配置。

参数

参数

注释

auth_string

字符串

身份验证字符串。如果需要隐藏此字符串(对于 md5 类型),则字符串应以 7 开头,后跟密钥字符串。否则,它可以以 0 开头,后跟密钥字符串,或者只是密钥字符串(为了向后兼容)。对于文本类型,这应该只是一个密钥字符串。如果这是“default”,则身份验证将被移除。

auth_type

字符串

身份验证类型。

选项

  • "text"

  • "md5"

group

字符串 / 必需

HSRP 组号。

interface

字符串 / 必需

正在为 HSRP 管理的接口的全名。

preempt

字符串

启用/禁用抢占。

选项

  • "enabled"

  • "disabled"

priority

字符串

HSRP 优先级或关键字“default”。

state

字符串

指定资源的所需状态。

选项

  • "present" ← (默认)

  • "absent"

version

字符串

HSRP 版本。

选项

  • "1" ← (默认)

  • "2"

vip

字符串

HSRP 虚拟 IP 地址或关键字“default”。

备注

注意

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

  • 不支持 Cisco MDS

  • 需要首先在系统上启用 HSRP 功能。

  • 使用此模块之前必须存在 SVI。

  • 使用此模块之前,接口必须是 L3 端口。

  • 无法在环回接口上配置 HSRP。

  • MD5 身份验证仅适用于 HSRPv2,如果改为使用 HSRPv1,则会被忽略,并且不会引发任何错误。为了强制执行最佳实践,我们在此仅允许在 HSRPv2 中进行 MD5 身份验证。

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

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

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

示例

- name: Ensure HSRP is configured with following params on a SVI
  cisco.nxos.nxos_hsrp:
    group: 10
    vip: 10.1.1.1
    priority: 150
    interface: vlan10
    preempt: enabled

- name: Ensure HSRP is configured with following params on a SVI with clear text authentication
  cisco.nxos.nxos_hsrp:
    group: 10
    vip: 10.1.1.1
    priority: 150
    interface: vlan10
    preempt: enabled
    auth_type: text
    auth_string: CISCO

- name: Ensure HSRP is configured with md5 authentication and clear authentication
    string
  cisco.nxos.nxos_hsrp:
    group: 10
    vip: 10.1.1.1
    priority: 150
    interface: vlan10
    preempt: enabled
    auth_type: md5
    auth_string: 0 1234

- name: Ensure HSRP is configured with md5 authentication and hidden authentication
    string
  cisco.nxos.nxos_hsrp:
    group: 10
    vip: 10.1.1.1
    priority: 150
    interface: vlan10
    preempt: enabled
    auth_type: md5
    auth_string: 7 1234

- name: Remove HSRP config for given interface, group, and VIP
  cisco.nxos.nxos_hsrp:
    group: 10
    interface: vlan10
    vip: 10.1.1.1
    state: absent

返回值

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

描述

commands

列表 / 元素=字符串

发送到设备的命令

返回:始终

示例: ["interface vlan10", "hsrp version 2", "hsrp 30", "ip 10.30.1.1"]

作者

  • Jason Edelman (@jedelman8)

  • Gabriele Gerbino (@GGabriele)