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 配置。
参数
参数 |
注释 |
---|---|
身份验证字符串。如果此字符串需要隐藏(对于 md5 类型),则字符串应以 7 开头,后跟密钥字符串。否则,它可以是 0 开头,后跟密钥字符串,或者只是密钥字符串(为了向后兼容)。对于文本类型,这应该只是一个密钥字符串。如果为“default”,则删除身份验证。 |
|
身份验证类型。 选择
|
|
HSRP 组号。 |
|
正在为 HSRP 管理的接口的完整名称。 |
|
启用/禁用抢占。 选择
|
|
HSRP 优先级或关键字“default”。 |
|
指定资源的所需状态。 选择
|
|
HSRP 版本。 选择
|
|
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
返回值
常见返回值记录在 此处,以下是此模块特有的字段
键 |
描述 |
---|---|
发送到设备的命令 返回:始终 示例: |