range_expand¶
Note
Always use the FQCN (Fully Qualified Collection Name) arista.avd.range_expand
when using this plugin.
Expand a range of interfaces or list of ranges and return as a list of strings.
Synopsis¶
Provides the capabilities to expand a range of interfaces or list of ranges and return as a list of strings.
The filter supports VLANs, interfaces, modules, sub-interfaces, and ranges are expanded at all levels.
Within a single range, prefixes ex. Ethernet, Eth, Po are carried over to items without prefixes see examples.
Parameters¶
Argument | Type | Required | Default | Value Restrictions | Description |
---|---|---|---|---|---|
_input | any | True | None | Range as string or list of ranges. |
Examples¶
---
- "{{ 'Ethernet1' | range_expand }}"
# -> ["Ethernet1"]
- "{{ 'Ethernet1-2' | range_expand }}"
# -> ["Ethernet1", "Ethernet2"]
- "{{ 'Eth 3-5,7-8' | range_expand }}"
# -> ["Eth 3", "Eth 4", "Eth 5", "Eth 7", "Eth 8"]
- "{{ 'et2-6,po1-2' | range_expand }}"
# -> ["et2", "et3", "et4", "et5", "et6", "po1", "po2"]
- "{{ ['Ethernet1'] | range_expand }}"
# -> ["Ethernet1"]
- "{{ ['Ethernet 1-2', 'Eth3-5', '7-8'] | range_expand }}"
# -> ["Ethernet 1", "Ethernet 2", "Eth3", "Eth4", "Eth5", "7", "8"]
- "{{ ['Ethernet2-6', 'Port-channel1-2'] | range_expand }}"
# -> ["Ethernet2", "Ethernet3", "Ethernet4", "Ethernet5", "Ethernet6", "Port-channel1", "Port-channel2"]
- "{{ ['Ethernet1/1-2', 'Eth1-2/3-5,5/1-2'] | range_expand }}"
# -> ["Ethernet1/1", "Ethernet1/2", "Eth1/3", "Eth1/4", "Eth1/5", "Eth2/3", "Eth2/4", "Eth2/5", "Eth5/1", "Eth5/2"]
- "{{ ['Eth1.1,9-10.1', 'Eth2.2-3', 'Eth3/1-2.3-4'] | range_expand }}"
# -> ["Eth1.1", "Eth9.1", "Eth10.1", "Eth2.2", "Eth2.3", "Eth3/1.3", "Eth3/1.4", "Eth3/2.3", "Eth3/2.4"]
- "{{ '1-3' | range_expand }}"
# -> ["1", "2", "3"]
- "{{ ['1', '2', '3'] | range_expand }}"
# -> ["1", "2", "3"]
- "{{ 'vlan1-3' | range_expand }}"
# -> ["vlan1", "vlan2", "vlan3"]
- "{{ 'Et1-2/3-4/5-6' | range_expand }}"
# -> ["Et1/3/5", "Et1/3/6", "Et1/4/5", "Et1/4/6", "Et2/3/5", "Et2/3/6", "Et2/4/5", "Et2/4/6"]
Return Values¶
Name | Type | Description |
---|---|---|
_value | list | List of strings from all ranges. |
Authors¶
- Arista Ansible Team (@aristanetworks)