ansible.utils.macaddr 过滤器 – macaddr / MAC 地址过滤器

注意

此过滤器插件是 ansible.utils 集合（版本 5.1.2）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install ansible.utils。

要在 playbook 中使用它，请指定：ansible.utils.macaddr。

ansible.utils 2.5.0 中的新功能

概要

  • 此过滤器检查字符串是否为 MAC 地址并对其进行过滤

  • 您可以使用 macaddr() 过滤器来检查给定的字符串是否为 MAC 地址，或者在各种格式之间进行转换。

关键字参数

这描述了过滤器的关键字参数。这些是以下示例中的值 key1=value1、key2=value2 等：input | ansible.utils.macaddr(key1=value1, key2=value2, ...)

参数

注释

query

字符串

查询字符串。例如。cisco、linux、unix 等

默认值： ""

value

字符串 / 必需

HW/MAC 地址。

示例

#### examples
- name: Check if given string is a MAC address
  debug:
    msg: "{{ '1a:2b:3c:4d:5e:6f' | ansible.utils.macaddr }}"

- name: Convert MAC address to Cisco format
  debug:
    msg: "{{ '1a:2b:3c:4d:5e:6f' | ansible.utils.macaddr('cisco') }}"

# TASK [Check if given string is a MAC address] ***************************************************************
# ok: [localhost] => {
#     "msg": "1a:2b:3c:4d:5e:6f"
# }
#
# TASK [Convert MAC address to Cisco format] ******************************************************************
# ok: [localhost] => {
#     "msg": "1a2b.3c4d.5e6f"
# }

返回值

键

描述

数据

字符串

mac/Hw 地址

已返回：成功

作者

  • Ashwini Mhatre (@amhatre)

提示

每个条目类型的配置条目都具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。