cisco.nxos.nxos_hsrp (7.0.0) — module

Install collection

Install with ansible-galaxy collection install cisco.nxos:==7.0.0

Add to requirements.yml

  collections:
    - name: cisco.nxos
      version: 7.0.0

Description

Manages HSRP configuration on NX-OS switches.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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

Inputs

    
vip:
    description:
    - HSRP virtual IP address or keyword 'default'
    type: str

group:
    description:
    - HSRP group number.
    required: true
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Specify desired state of the resource.
    type: str

preempt:
    choices:
    - enabled
    - disabled
    description:
    - Enable/Disable preempt.
    type: str

version:
    choices:
    - '1'
    - '2'
    default: '1'
    description:
    - HSRP version.
    type: str

priority:
    description:
    - HSRP priority or keyword 'default'.
    type: str

auth_type:
    choices:
    - text
    - md5
    description:
    - Authentication type.
    type: str

interface:
    description:
    - Full name of interface that is being managed for HSRP.
    required: true
    type: str

auth_string:
    description:
    - Authentication string. If this needs to be hidden(for md5 type), the string should
      be 7 followed by the key string. Otherwise, it can be 0 followed by key string or
      just key string (for backward compatibility). For text type, this should be just
      be a key string. if this is 'default', authentication is removed.
    type: str

Outputs

commands:
  description: commands sent to the device
  returned: always
  sample:
  - interface vlan10
  - hsrp version 2
  - hsrp 30
  - ip 10.30.1.1
  type: list