community.dns.get_registrable_domain фильтр – Возвращает доменное имя, подлежащее регистрации, для имени DNS

Примечание

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

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

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

Для использования в playbook укажите: 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 в списке общедоступных суффиксов или также записи из раздела 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`. Этот параметр соответствует тому, используется ли глобальное правило подстановки `` в списке общедоступных суффиксов или нет. Варианты:* `false` `true` ← (по умолчанию)
normalize_result логическое	Управляет тем, перестраивается ли результат из нормализованного имени, используемого во время поиска. При нормализации ulabels преобразуются в alabels, а каждый метка преобразуется в нижний регистр. Например, ulabel `ëçãmplê` преобразуется в `xn--mpl-llatwb` (puny-code), а `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'

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

Ключ	Описание
Возвращаемое значение строка	Домен, подлежащий регистрации. Возвращается: успех

Авторы

Фёликс Фонтейн (@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_registrable_domain_filter.html