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
返回值
常见的返回值已记录在 此处,以下是此模块特有的字段
键 |
描述 |
---|---|
发送到设备的命令 返回:始终 示例: |