ce_vrrp - Manages VRRP interfaces on HUAWEI CloudEngine devices.
New in version 2.4.
Synopsis
- Manages VRRP interface attributes on HUAWEI CloudEngine devices.
Options
| parameter | required | default | choices | comments |
|---|---|---|---|---|
| admin_flowdown | no | Disable the flowdown function for service VRRP. | ||
| admin_ignore_if_down | no | mVRRP ignores an interface Down event. | ||
| admin_interface | no | Tracked mVRRP interface name. The value is a string of 1 to 63 characters. | ||
| admin_vrid | no | Tracked mVRRP ID. The value is an integer ranging from 1 to 255. | ||
| advertise_interval | no | Configured interval between sending advertisements, in milliseconds. Only the master router sends VRRP advertisements. The default value is 1000 milliseconds. | ||
| auth_key | no | This object is set based on the authentication type. When noAuthentication is specified, the value is empty. When simpleTextPassword or md5Authentication is specified, the value is a string of 1 to 8 characters in plaintext and displayed as a blank text for security. | ||
| auth_mode | no |
| Authentication type used for VRRP packet exchanges between virtual routers. The values are noAuthentication, simpleTextPassword, md5Authentication. The default value is noAuthentication. | |
| fast_resume | no |
| mVRRP's fast resume mode. | |
| gratuitous_arp_interval | no | Interval at which gratuitous ARP packets are sent, in seconds. The value ranges from 30 to 1200.The default value is 300. | ||
| holding_multiplier | no | The configured holdMultiplier.The value is an integer ranging from 3 to 10. The default value is 3. | ||
| interface | no | Name of an interface. The value is a string of 1 to 63 characters. | ||
| is_plain | no | Select the display mode of an authentication key. By default, an authentication key is displayed in ciphertext. | ||
| preempt_timer_delay | no | Preemption delay. The value is an integer ranging from 0 to 3600. The default value is 0. | ||
| priority | no | Configured VRRP priority. The value ranges from 1 to 254. The default value is 100. A larger value indicates a higher priority. | ||
| recover_delay | no | Delay in recovering after an interface goes Up. The delay is used for interface flapping suppression. The value is an integer ranging from 0 to 3600. The default value is 0 seconds. | ||
| state | no | present |
| Specify desired state of the resource. |
| version | no |
| VRRP version. The default version is v2. | |
| virtual_ip | no | Virtual IP address. The value is a string of 0 to 255 characters. | ||
| vrid | no | present | VRRP backup group ID. The value is an integer ranging from 1 to 255. | |
| vrrp_type | no |
| Type of a VRRP backup group. |
Examples
- name: vrrp module test
hosts: cloudengine
connection: local
gather_facts: no
vars:
cli:
host: "{{ inventory_hostname }}"
port: "{{ ansible_ssh_port }}"
username: "{{ username }}"
password: "{{ password }}"
transport: cli
tasks:
- name: Set vrrp version
ce_vrrp:
version: v3
provider: "{{ cli }}"
- name: Set vrrp gratuitous-arp interval
ce_vrrp:
gratuitous_arp_interval: 40
mlag_id: 4
provider: "{{ cli }}"
- name: Set vrrp recover-delay
ce_vrrp:
recover_delay: 10
provider: "{{ cli }}"
- name: Set vrrp vrid virtual-ip
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
virtual_ip: 10.14.2.7
provider: "{{ cli }}"
- name: Set vrrp vrid admin
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
vrrp_type: admin
provider: "{{ cli }}"
- name: Set vrrp vrid fast_resume
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
fast_resume: enable
provider: "{{ cli }}"
- name: Set vrrp vrid holding-multiplier
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
holding_multiplier: 4
provider: "{{ cli }}"
- name: Set vrrp vrid preempt timer delay
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
preempt_timer_delay: 10
provider: "{{ cli }}"
- name: Set vrrp vrid admin-vrrp
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
admin_interface: 40GE2/0/9
admin_vrid: 2
vrrp_type: member
provider: "{{ cli }}"
- name: Set vrrp vrid authentication-mode
ce_vrrp:
interface: 40GE2/0/8
vrid: 1
is_plain: true
auth_mode: simple
auth_key: aaa
provider: "{{ cli }}"
Return Values
Common return values are documented here Return Values, the following are the fields unique to this module:
| name | description | returned | type | sample |
|---|---|---|---|---|
| changed | check to see if a change was made on the device | always | boolean | True |
| end_state | k/v pairs of aaa params after module execution | always | dict | {'interface': '40GE2/0/8', 'vrid': '1', 'vrrp_type': 'normal', 'auth_mode': 'simple', 'is_plain': 'true'} |
| existing | k/v pairs of existing aaa server | always | dict | {'interface': '40GE2/0/8', 'vrid': '1', 'vrrp_type': 'normal', 'auth_mode': 'none', 'is_plain': 'false'} |
| proposed | k/v pairs of parameters passed into module | always | dict | {'state': 'present', 'is_plain': True, 'auth_key': 'aaa', 'interface': '40GE2/0/8', 'vrid': '1', 'auth_mode': 'simple'} |
| updates | command sent to the device | always | list | {'interface 40GE2/0/8': None, 'vrrp vrid 1 authentication-mode simple plain aaa': None} |
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/ce_vrrp_module.html