Фильтр community.dns.get_public_suffix — возвращает публичный суффикс DNS-имени

Примечание

Этот плагин фильтра входит в коллекцию community.dns (версия 3.5.5).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.dns.

Чтобы использовать её в плейбуке, укажите: community.dns.get_public_suffix.

Добавлено в community.dns 0.1.0

Описание
Входные данные
Именованные параметры
Примеры
Возвращаемое значение

Описание

Возвращает публичный суффикс DNS-имени.

Входные данные

Здесь описаны входные данные фильтра — значение перед | community.dns.get_public_suffix.

Параметр	Комментарии
Входные данные строка / обязательный	DNS-имя.

Именованные параметры

Здесь описаны именованные параметры фильтра. Это значения key1=value1, key2=value2 и т. д. в следующем примере: input | community.dns.get_public_suffix(key1=value1, key2=value2, ...)

Параметр	Комментарии
icann_only логическое значение	Указывает, использовать ли только записи из раздела ICANN списка публичных суффиксов или также записи из раздела Private. Например, `.co.uk` находится в разделе ICANN, а `github.io` — в разделе Private. Варианты: `false` ← (по умолчанию) `true`
keep_leading_period логическое значение	Указывает, сохранять ли точку в начале публичного суффикса. Варианты: `false` `true` ← (по умолчанию)
keep_unknown_suffix логическое значение	Считает неизвестные домены верхнего уровня допустимыми публичными суффиксами. Например, публичным суффиксом для `example.tlddoesnotexist` будет `.tlddoesnotexist`, если значение этого параметра — `true`. Если указано `false`, в этом случае будет возвращена пустая строка. Этот параметр определяет, используется ли в списке публичных суффиксов правило глобального шаблона ``. Варианты:* `false` `true` ← (по умолчанию)
normalize_result логическое значение	Указывает, нужно ли формировать результат заново на основе нормализованного имени, использованного при поиске. При нормализации u-метки преобразуются в a-метки, а все метки переводятся в нижний регистр. Например, u-метка `ëçãmplê` преобразуется в `xn--mpl-llatwb` (puny-code), а `Example.COM` — в `example.com`. Варианты: `false` ← (по умолчанию) `true`

Примеры

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

Возвращаемое значение

Ключ	Описание
Возвращаемое значение строка	Публичный суффикс. Возвращается: при успешном выполнении

Авторы

Felix Fontein (@felixfontein)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/dns/get_public_suffix_filter.html