Модуль f5networks.f5_modules.bigip_device_dns — управление настройками DNS на BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать её в плейбуке, укажите: f5networks.f5_modules.bigip_device_dns.

Добавлено в f5networks.f5_modules 1.0.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

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

Управление настройками DNS на устройстве BIG-IP.

Параметры

Параметр	Комментарии
cache string	Указывает, кэширует ли система результаты DNS-запросов или выполняет операцию каждый раз, когда требуется поиск. Обратите внимание: это относится только к функциям Access Policy Manager (APM), таким как списки ACL, переписывание веб-приложений и аутентификация. Варианты: `"enabled"` `"disabled"` `"enable"` `"disable"`
ip_version integer	Указывает, использует ли DNS для указания IP-адресов IPv4 или IPv6. Варианты: `4` `6`
name_servers list / elements=string	Список серверов имён, используемых системой для проверки результатов DNS-запросов.
provider dictionary добавлено в f5networks.f5_modules 1.0.0	Объект dict с параметрами подключения.
auth_provider string	Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства. Этот параметр фактически используется при работе с устройствами BIG-IQ.
no_f5_teem boolean	Если `yes`, данные телеметрии TEEM не отправляются в F5. Этот параметр можно не указывать, задав переменную окружения `F5_TELEMETRY_OFF`. Переменная `F5_TEEM`, использовавшаяся ранее, устарела, так как её название вводило в заблуждение. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd string / обязательный	Пароль учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения `F5_PASSWORD`.
server string / обязательный	Хост BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения `F5_SERVER`.
server_port integer	Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную окружения `F5_SERVER_PORT`. По умолчанию: `443`
timeout integer	Задаёт время ожидания в секундах при обмене данными с сетевым устройством — как при подключении, так и при отправке команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку.
transport string	Настраивает транспортное соединение, используемое при подключении к удалённому устройству. Варианты: `"rest"` ← (по умолчанию)
user string / обязательный	Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную окружения `F5_USER`.
validate_certs boolean	Если `no`, SSL-сертификаты не проверяются. Используйте этот параметр только на лично контролируемых сайтах с самоподписанными сертификатами. Этот параметр можно не указывать, задав переменную окружения `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
search list / elements=string	Список доменов, в которых система выполняет поиск для локальных DNS-запросов, чтобы разрешать локальные имена хостов.
state string	Состояние переменной в системе. Если указано `present`, гарантируется, что существующей переменной будет присвоено значение `value`. Варианты: `"absent"` `"present"` ← (по умолчанию)

Примечания

Примечание

Дополнительные сведения об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется BIG-IP версии >= 12.
Модули F5 изменяют только работающую конфигурацию продукта F5. Чтобы сохранить на диске конфигурацию, относящуюся к BIG-IP, обязательно включите как минимум одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения работающей конфигурации. Инструкции по правильному использованию модуля для сохранения работающей конфигурации см. в документации модуля.

Примеры

- name: Set the DNS settings on the BIG-IP
  bigip_device_dns:
    name_servers:
      - 208.67.222.222
      - 208.67.220.220
    search:
      - localdomain
      - lab.local
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
cache string	Новое значение кэширования DNS. Возвращается: changed Пример: `"enabled"`
ip_version integer	Заданная версия IP; DNS будет указывать IP-адреса этой версии. Возвращается: changed Пример: `4`
name_servers list / elements=string	Список заданных серверов имён. Возвращается: changed Пример: `["192.0.2.10", "172.17.12.10"]`
search list / elements=string	Список заданных доменов поиска. Возвращается: changed Пример: `["192.0.2.10", "172.17.12.10"]`
warnings list / elements=string	Список предупреждений (если есть), сформированных модулем на основе аргументов. Возвращается: always Пример: `["...", "..."]`

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)

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

© 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/f5networks/f5_modules/bigip_device_dns_module.html