Модуль infoblox.nios_modules.nios_txt_record — настройка TXT-записей Infoblox NIOS

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install infoblox.nios_modules. Для использования этого модуля могут потребоваться дополнительные компоненты; подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: infoblox.nios_modules.nios_txt_record.

Добавлено в infoblox.nios_modules 1.0.0

Краткое описание
Требования
Параметры
Примечания
Примеры

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

Добавляет и/или удаляет экземпляры объектов TXT-записей на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS record:txt с помощью интерфейса Infoblox WAPI через REST.

Требования

Следующие компоненты должны быть установлены на хосте, на котором выполняется этот модуль.

infoblox_client

Параметры

Параметр	Комментарии
comment string	Задаёт текстовый комментарий, связанный с экземпляром этого объекта. Указанная текстовая строка будет добавлена к экземпляру объекта.
extattrs dictionary	Позволяет настроить расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар «ключ — значение» для настройки.
name string / обязательный	Указывает полное доменное имя узла, которое нужно добавить в систему или удалить из неё. Также можно обновить имя, передав словарь, содержащий new_name и old_name. См. примеры.
provider dictionary	Словарь с параметрами подключения.
cert string	Указывает файл сертификата клиента с дайджестом конфигурации x509 для дополнительного уровня защиты соединения с удалённым экземпляром NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_CERT`.
host string	Указывает DNS-имя узла или адрес для подключения к удалённому экземпляру NIOS WAPI через REST Значение также можно задать с помощью переменной среды `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте описание здесь Значение по умолчанию: `10`
http_pool_maxsize integer	Вставьте описание здесь Значение по умолчанию: `10`
http_request_timeout integer	Время ожидания ответа Значение также можно задать с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`. Значение по умолчанию: `10`
key string	Указывает файл закрытого ключа для шифрования сертификатом при подключении к удалённому экземпляру NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_KEY`.
max_results integer	Указывает максимальное количество возвращаемых объектов. Если задано отрицательное число, устройство выдаст ошибку, когда количество возвращаемых объектов превысит указанное значение. Значение также можно задать с помощью переменной среды `INFOBLOX_MAX_RESULTS`. Значение по умолчанию: `1000`
max_retries integer	Задаёт количество повторных попыток, выполняемых до того, как соединение будет признано работоспособным. Значение также можно задать с помощью переменной среды `INFOBLOX_MAX_RETRIES`. Значение по умолчанию: `3`
password string	Указывает пароль для аутентификации при подключении к удалённому экземпляру NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание здесь Варианты: `false` `true` ← (по умолчанию)
username string	Задаёт имя пользователя для аутентификации при подключении к удалённому экземпляру NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify boolean	Логическое значение, включающее или отключающее проверку сертификатов SSL Значение также можно задать с помощью переменной среды `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Указывает версию WAPI, которую следует использовать Значение также можно задать с помощью переменной среды `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версией WAPI по умолчанию была 1.4 Значение по умолчанию: `"2.12.3"`
state string	Задаёт требуемое состояние экземпляра объекта на сервере NIOS. Если этому параметру присвоено значение `present`, объект будет настроен на устройстве; если значение равно `absent`, объект будет удалён с устройства (если он там есть). Варианты: `"present"` ← (по умолчанию) `"absent"`
text string / обязательный	Текст, связанный с записью. Каждая подстрока может содержать до 255 байт, а общий размер — до 512 байт. Чтобы сохранить начальные, конечные или внутренние пробелы в тексте, заключите его в кавычки.
ttl integer	Задаёт TTL для этой TXT-записи.
view псевдонимы: dns_view string	Задаёт DNS-представление, с которым связывается эта TXT-запись. DNS-представление должно быть предварительно настроено в системе. Значение по умолчанию: `"default"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль необходимо запускать локально. Для этого можно указать connection: local.
Более подробную информацию об использовании Infoblox с Ansible см. в руководстве :ref:`nios_guide`.

Примеры

- name: Ensure a text Record Exists
  infoblox.nios_modules.nios_txt_record:
    name: fqdn.txt.record.com
    text: mytext
    state: present
    view: External
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin

- name: Update name of TXT record
  infoblox.nios_modules.nios_txt_record:
    name: {old_name: sample.txtrecord.com, new_name: newsample.txtrecord.com}
    text: mytext
    state: present
    view: External
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Ensure a text Record does not exist
  infoblox.nios_modules.nios_txt_record:
    name: fqdn.txt.record.com
    text: mytext
    state: absent
    view: External
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin

Авторы

Corey Wanless (@coreywan)

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

© 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/infoblox/nios_modules/nios_txt_record_module.html