community.network.ce_vrf – Manages VPN instance on HUAWEI CloudEngine switches.
Note
This plugin is part of the community.network collection (version 3.0.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.network
.
To use it in a playbook, specify: community.network.ce_vrf
.
Parameters
Parameter |
Comments |
---|---|
Description of the vrf, the string length is 1 - 242 . |
|
Manage the state of the resource. Choices:
|
|
VPN instance, the length of vrf name is 1 - 31, i.e. “test”, but can not be |
Notes
Note
If state=absent, the route will be removed, regardless of the non-required options.
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: Vrf 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: Config a vpn install named vpna, description is test
community.network.ce_vrf:
vrf: vpna
description: test
state: present
provider: "{{ cli }}"
- name: Delete a vpn install named vpna
community.network.ce_vrf:
vrf: vpna
state: absent
provider: "{{ cli }}"
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
check to see if a change was made on the device Returned: always Sample: true |
|
k/v pairs of switchport after module execution Returned: always Sample: {“description”: “test”, “present”: “present”, “vrf”: “vpna”} |
|
k/v pairs of existing switchport Returned: always Sample: {} |
|
k/v pairs of parameters passed into module Returned: always Sample: {“description”: “test”, “state”: “present”, “vrf”: “vpna”} |
|
command list sent to the device Returned: always Sample: [“ip vpn-instance vpna”, “description test”] |
Authors
Yang yang (@QijunPan)