Test if something appears to be a valid MAC address
Version added: 2.2.0
- This plugin checks if the provided value is a valid MAC address that follows the industry level standards
- name: Check if 02:16:3e:e4:16:f3 is a valid MAC address
ansible.builtin.set_fact:
data: "{{ '02:16:3e:e4:16:f3' is ansible.utils.mac }}"
# TASK [Check if 02:16:3e:e4:16:f3 is a valid MAC address] ********************
# ok: [localhost] => {
# "ansible_facts": {
# "data": true
# },
# "changed": false
# }
- name: Check if 02-16-3e-e4-16-f3 is a valid MAC address
ansible.builtin.set_fact:
data: "{{ '02-16-3e-e4-16-f3' is ansible.utils.mac }}"
# TASK [Check if 02-16-3e-e4-16-f3 is a valid MAC address] ********************
# ok: [localhost] => {
# "ansible_facts": {
# "data": true
# },
# "changed": false
# }
- name: Check if 0216.3ee4.16f3 is a valid MAC address
ansible.builtin.set_fact:
data: "{{ '0216.3ee4.16f3' is ansible.utils.mac }}"
# TASK [Check if 0216.3ee4.16f3 is a valid MAC address] ***********************
# ok: [localhost] => {
# "ansible_facts": {
# "data": true
# },
# "changed": false
# }
- name: Check if 02163ee416f3 is a valid MAC address
ansible.builtin.set_fact:
data: "{{ '02163ee416f3' is ansible.utils.mac }}"
# TASK [Check if 02163ee416f3 is a valid MAC address] *************************
# ok: [localhost] => {
# "ansible_facts": {
# "data": true
# },
# "changed": false
# }
- name: Check if helloworld is not a valid MAC address
ansible.builtin.set_fact:
data: "{{ 'helloworld' is not ansible.utils.mac }}"
# TASK [Check if helloworld is not a valid MAC address] ***********************
# ok: [localhost] => {
# "ansible_facts": {
# "data": true
# },
# "changed": false
# }
Common return values are documented here, the following are the fields unique to this test:
Key | Returned | Description |
---|---|---|
data
-
|
If jinja test satisfies plugin expression
true If jinja test does not satisfy plugin expression
false |
- Priyam Sahoo (@priyamsahoo)
Hint
Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.