community.network.ce_vrrp – Manages VRRP interfaces on HUAWEI CloudEngine devices.
community.network.ce_vrrp – Manages VRRP interfaces on HUAWEI CloudEngine devices.
Note
This plugin is part of the community.network collection (version 2.0.1).
To install it use: ansible-galaxy collection install community.network
.
To use it in a playbook, specify: community.network.ce_vrrp
.
Synopsis
- Manages VRRP interface attributes on HUAWEI CloudEngine devices.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
admin_flowdown boolean |
Default: "false" |
Disable the flowdown function for service VRRP. |
admin_ignore_if_down boolean |
Default: "false" |
mVRRP ignores an interface Down event. |
admin_interface string |
Tracked mVRRP interface name. The value is a string of 1 to 63 characters. | |
admin_vrid string |
Tracked mVRRP ID. The value is an integer ranging from 1 to 255. | |
advertise_interval string |
Configured interval between sending advertisements, in milliseconds. Only the master router sends VRRP advertisements. The default value is 1000 milliseconds. | |
auth_key string |
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 string |
|
Authentication type used for VRRP packet exchanges between virtual routers. The values are noAuthentication, simpleTextPassword, md5Authentication. The default value is noAuthentication. |
fast_resume string |
|
mVRRP's fast resume mode. |
gratuitous_arp_interval string |
Interval at which gratuitous ARP packets are sent, in seconds. The value ranges from 30 to 1200.The default value is 300. | |
holding_multiplier string |
The configured holdMultiplier.The value is an integer ranging from 3 to 10. The default value is 3. | |
interface string |
Name of an interface. The value is a string of 1 to 63 characters. | |
is_plain boolean |
Default: "false" |
Select the display mode of an authentication key. By default, an authentication key is displayed in ciphertext. |
preempt_timer_delay string |
Preemption delay. The value is an integer ranging from 0 to 3600. The default value is 0. | |
priority string |
Configured VRRP priority. The value ranges from 1 to 254. The default value is 100. A larger value indicates a higher priority. | |
recover_delay string |
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 string |
|
Specify desired state of the resource. |
version string |
|
VRRP version. The default version is v2. |
virtual_ip string |
Virtual IP address. The value is a string of 0 to 255 characters. | |
vrid string |
Default: "present" |
VRRP backup group ID. The value is an integer ranging from 1 to 255. |
vrrp_type string |
|
Type of a VRRP backup group. |
Notes
Note
- This module requires the netconf system service be enabled on the remote device being managed.
- Recommended connection is
netconf
. - This module also works with
local
connections for legacy playbooks.
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
community.network.ce_vrrp:
version: v3
provider: "{{ cli }}"
- name: Set vrrp gratuitous-arp interval
community.network.ce_vrrp:
gratuitous_arp_interval: 40
mlag_id: 4
provider: "{{ cli }}"
- name: Set vrrp recover-delay
community.network.ce_vrrp:
recover_delay: 10
provider: "{{ cli }}"
- name: Set vrrp vrid virtual-ip
community.network.ce_vrrp:
interface: 40GE2/0/8
vrid: 1
virtual_ip: 10.14.2.7
provider: "{{ cli }}"
- name: Set vrrp vrid admin
community.network.ce_vrrp:
interface: 40GE2/0/8
vrid: 1
vrrp_type: admin
provider: "{{ cli }}"
- name: Set vrrp vrid fast_resume
community.network.ce_vrrp:
interface: 40GE2/0/8
vrid: 1
fast_resume: enable
provider: "{{ cli }}"
- name: Set vrrp vrid holding-multiplier
community.network.ce_vrrp:
interface: 40GE2/0/8
vrid: 1
holding_multiplier: 4
provider: "{{ cli }}"
- name: Set vrrp vrid preempt timer delay
community.network.ce_vrrp:
interface: 40GE2/0/8
vrid: 1
preempt_timer_delay: 10
provider: "{{ cli }}"
- name: Set vrrp vrid admin-vrrp
community.network.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
community.network.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, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
changed boolean |
always |
check to see if a change was made on the device
Sample: True |
end_state dictionary |
always |
k/v pairs of aaa params after module execution
Sample: {'auth_mode': 'simple', 'interface': '40GE2/0/8', 'is_plain': 'true', 'vrid': '1', 'vrrp_type': 'normal'} |
existing dictionary |
always |
k/v pairs of existing aaa server
Sample: {'auth_mode': 'none', 'interface': '40GE2/0/8', 'is_plain': 'false', 'vrid': '1', 'vrrp_type': 'normal'} |
proposed dictionary |
always |
k/v pairs of parameters passed into module
Sample: {'auth_key': 'aaa', 'auth_mode': 'simple', 'interface': '40GE2/0/8', 'is_plain': True, 'state': 'present', 'vrid': '1'} |
updates list / elements=string |
always |
command sent to the device
Sample: {'interface 40GE2/0/8': None, 'vrrp vrid 1 authentication-mode simple plain aaa': None} |
Authors
- Li Yanfeng (@numone213)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/ce_vrrp_module.html