community.dns.remove_public_suffix 过滤器 – 从 DNS 名称中删除公共后缀

注意

此过滤器插件是 community.dns 集合 (版本 3.1.0) 的一部分。

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

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

要在 playbook 中使用它，请指定：community.dns.remove_public_suffix。

community.dns 0.1.0 中的新功能

概要 

从 DNS 名称中删除公共后缀。

输入 

这描述了过滤器的输入，即 | community.dns.remove_public_suffix 之前的值。

参数	注释
输入字符串 / 必需	一个 DNS 名称。

关键字参数 

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

参数	注释
icann_only 布尔值	这控制是否仅使用公共后缀列表中 ICANN 部分的条目，或者也使用私有部分的条目。例如，`.co.uk` 在 ICANN 部分，但 `github.io` 在私有部分。选项 `false` ← (默认) `true`
keep_trailing_period 布尔值	这控制是否保留前缀的尾随句点（即公共后缀之前的部分）。选项 `false` ← (默认) `true`
keep_unknown_suffix 布尔值	这会将未知的 TLD 视为有效的公共后缀。因此，例如，如果此项为 `true`，则 `example.tlddoesnotexist` 的公共后缀为 `.tlddoesnotexist`。如果设置为 `false`，则在这种情况下将返回一个空字符串。此选项对应于是否使用公共后缀列表中的全局通配符规则 `*`。选项 `false` `true` ← (默认)

示例 

- name: Remove the public suffix from a DNS name
  ansible.builtin.set_fact:
    public_suffix: "{{ 'www.ansible.co.uk' | community.dns.remove_public_suffix }}"
    # Should result in 'www.ansible'

返回值 

键	描述
返回值字符串	DNS 名称中公共后缀之前的部分。已返回：成功

作者

Felix Fontein (@felixfontein)

提示

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