Фильтр community.dns.get_public_suffix – Возвращает общедоступное доменное имя DNS

Примечание

Этот плагин фильтра является частью коллекции community.dns (версия 3.0.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 логический тип	Определяет, восстанавливается ли результат из нормализованного имени, используемого во время поиска. Во время нормализации метки ulabels преобразуются в метки alabels, а каждая метка преобразуется в нижний регистр. Например, метка ulabel `ëçã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'

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

Ключ	Описание
Возвращаемое значение строка	Общедоступное доменное имя. Возвращаемое значение: success

Авторы

Филикс Фонтейн (@felixfontein)

Подсказка

Параметры конфигурации для каждого типа записи имеют порядок приоритетов от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.

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

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