Фильтр community.dns.get_registrable_domain — возвращает регистрируемое доменное имя DNS-имени

Примечание

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

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

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

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

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

Краткое описание
Входные данные
Параметры-ключевые слова
Примеры
Возвращаемое значение

Краткое описание

Возвращает регистрируемое доменное имя DNS-имени.

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

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

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

Параметры-ключевые слова

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

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

Примеры

- name: Extract the registrable domain from a DNS name
  ansible.builtin.set_fact:
    public_suffix: "{{ 'www.ansible.co.uk' | community.dns.get_registrable_domain }}"
    # Should result in 'ansible.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_registrable_domain_filter.html