Модуль f5networks.f5_modules.bigip_dns_cache_resolver – Управление кэшем DNS-резолвера на BIG-IP

Примечание

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

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

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

Чтобы использовать его в playbook, укажите: f5networks.f5_modules.bigip_dns_cache_resolver.

Новый в f5networks.f5_modules 1.0.0

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

Описание

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

Параметры

Параметр	Комментарии
answer_default_zones boolean	Указывает, отвечает ли система на запросы DNS для локальных зон, обратных 127.0.0.1 и ::1, и AS112. При создании нового кэширующего решателя, если этот параметр не указан, значение по умолчанию — `false`. Варианты: `false` `true`
forward_zones any	Прямые зоны, связанные с кэшем. Чтобы удалить все прямые зоны, укажите значение `none`.
name string	Указывает FQDN для прямой зоны.
nameservers list / elements=dictionary	Указывает IP-адрес и сервисный порт рекурсивного сервера имен, который отвечает на запросы DNS для зоны, когда ответ не найден в кэше DNS.
address string	Адрес рекурсивного сервера имен.
port integer	Порт рекурсивного сервера имен. При указании новых серверов имен, если это значение не указано, используется значение по умолчанию `53`.
name string / обязательно	Указывает имя кэша.
partition string	Раздел устройства для управления ресурсами. По умолчанию: `"Common"`
provider dictionary добавлен в f5networks.f5_modules 1.0.0	Объект словаря, содержащий данные соединения.
auth_provider string	Настраивает поставщик аутентификации для получения маркеров аутентификации с удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ.
no_f5_teem boolean	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную среды `F5_TELEMETRY_OFF`. Ранее используемая переменная `F5_TEEM` устарела, так как ее имя вызывало недопонимание. Варианты: `false` ← (по умолчанию) `true`
password aliases: 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` ← (по умолчанию)
route_domain string	Указывает домен маршрутизации, который использует решатель для исходящего трафика.

state

string

Когда present, гарантирует существование ресурса.

Когда absent, гарантирует удаление ресурса.

Варианты:

"present" ← (по умолчанию)
"absent"

Примечания

Примечание

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

Примеры

- name: Create a DNS resolver cache
  bigip_dns_cache:
    name: foo
    answer_default_zones: true
    forward_zones:
      - name: foo.bar.com
        nameservers:
          - address: 1.2.3.4
            port: 53
          - address: 5.6.7.8
    route_domain: 0
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Значения возврата

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

Ключ	Описание
param1 boolean	Новое значение param1 ресурса. Возвращается: changed Пример: `true`
param2 string	Новое значение param2 ресурса. Возвращается: changed Пример: `"Foo is bar"`

Авторы

Tim Rupp (@caphrim007)

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

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