community.general.nios_txt_record – Настройка записей Infoblox NIOS txt

Примечание

Этот плагин входит в состав коллекции community.general (версия 2.0.1).

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

Для использования в плейбуке укажите: community.general.nios_txt_record.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

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

Требования

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

infoblox_client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
comment строка			Настраивает текстовую строку комментария, которая будет ассоциироваться с экземпляром этого объекта. Предоставленная текстовая строка будет настроена в экземпляре объекта.
extattrs словарь			Позволяет настроить расширяемые атрибуты в экземпляре объекта. Этот аргумент принимает набор пар "ключ/значение" для настройки.
name строка / обязательно			Указывает полное доменное имя хоста для добавления или удаления из системы
provider словарь			Объект словаря, содержащий данные подключения.
	host строка		Указывает имя или адрес хоста DNS для подключения к удаленному экземпляру NIOS WAPI через REST Значение также можно указать с помощью переменной среды `INFOBLOX_HOST`.
	http_pool_connections целое число	По умолчанию: 10	Количество пулов, которые будут использоваться объектом `infoblox_client.Connector`. Это передается в неизменном виде в базовый класс `requests.adapters.HTTPAdapter`.
	http_pool_maxsize целое число	По умолчанию: 10	Максимальное количество подключений на пул, которое будет использоваться объектом `infoblox_client.Connector`. Это передается в неизменном виде в базовый класс `requests.adapters.HTTPAdapter`.
	http_request_timeout целое число	По умолчанию: 10	Время ожидания ответа Значение также можно указать с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`.
	max_results целое число	По умолчанию: 1000	Указывает максимальное количество возвращаемых объектов. Если установлено отрицательное число, прибор выдаст ошибку, если число возвращаемых объектов превысит установленное значение. Значение также можно указать с помощью переменной среды `INFOBLOX_MAX_RESULTS`.
	max_retries целое число	По умолчанию: 3	Настраивает количество попыток повтора перед тем, как подключение будет объявлено работоспособным Значение также можно указать с помощью переменной среды `INFOBLOX_MAX_RETRIES`.
	password строка		Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_PASSWORD`.
	silent_ssl_warnings булево	Варианты: нет да ←	Отключить предупреждения SSL `urllib3` в объекте `infoblox_client.Connector`. Это передается в неизменном виде в базовый класс `requests.adapters.HTTPAdapter`.
	username строка		Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_USERNAME`.
	validate_certs булево	Варианты: нет ← да	Булево значение для включения или отключения проверки SSL-сертификатов Значение также можно указать с помощью переменной среды `INFOBLOX_SSL_VERIFY`. псевдонимы: ssl_verify
	wapi_version строка	По умолчанию: "2.1"	Указывает версию WAPI для использования Значение также можно указать с помощью переменной среды `INFOBLOX_WAP_VERSION`. До версии ansible 2.8 по умолчанию использовалась WAPI 1.4
state строка		Варианты: present ← absent	Настраивает предполагаемое состояние экземпляра объекта на сервере NIOS. При этом значении, равном `present`, объект настраивается на устройстве, а при значении `absent` значение удаляется (при необходимости) с устройства.
text строка			Текст, связанный с записью. Он может содержать до 255 байт на подстроку, до 512 байт в целом. Чтобы ввести начальные, конечные или вложенные пробелы в текст, добавьте кавычки вокруг текста, чтобы сохранить пробелы.
ttl целое число			Настраивает TTL для этой записи tst
view строка		По умолчанию: "default"	Устанавливает представление DNS для ассоциации этой записи tst. Представление DNS должно быть уже настроено в системе псевдонимы: dns_view

Примечания

Примечание

Этот модуль должен выполняться локально, что можно достичь, указав connection: local.
Для получения более подробной информации о том, как использовать Infoblox с Ansible, обратитесь к Руководству по Infoblox.

Примеры

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

- name: Ensure a text Record does not exist
  community.general.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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/nios_txt_record_module.html