nios_txt_record – Настройка записей Infoblox NIOS txt
Новое в версии 2.7.
Обзор
- Добавляет и/или удаляет экземпляры объектов записей txt из серверов Infoblox NIOS. Этот модуль управляет объектами NIOS
record:txtс использованием интерфейса Infoblox WAPI через REST.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- infoblox_client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment - | Настраивает текстовую строку комментария, которая должна быть связана с экземпляром этого объекта. Предоставленная текстовая строка будет настроена в экземпляре объекта. | ||
| extattrs - | Позволяет настроить расширяемые атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки. | ||
| name - / обязательно | Указывает полностью квалифицированное имя хоста для добавления или удаления из системы | ||
| provider словарь | Объект словаря, содержащий данные подключения. | ||
| host строка / обязательно | Указывает имя DNS-хоста или адрес для подключения к удаленному экземпляру NIOS WAPI через REST Значение также может быть задано с помощью переменной среды INFOBLOX_HOST. | ||
| http_request_timeout целое число | По умолчанию: 10 | Время ожидания ответа Значение также может быть задано с помощью переменной среды INFOBLOX_HTTP_REQUEST_TIMEOUT. | |
| max_results целое число | По умолчанию: 1000 | Указывает максимальное количество возвращаемых объектов. Если значение отрицательное, прибор вернёт ошибку, если количество возвращенных объектов превысит значение. Значение также может быть задано с помощью переменной среды INFOBLOX_MAX_RESULTS. | |
| max_retries целое число | По умолчанию: 3 | Настраивает количество попыток повтора, прежде чем подключение считается работоспособным Значение также может быть задано с помощью переменной среды INFOBLOX_MAX_RETRIES. | |
| password строка | Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также может быть задано с помощью переменной среды INFOBLOX_PASSWORD. | ||
| 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 - |
| Настраивает предполагаемое состояние экземпляра объекта на сервере 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
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
nios_txt_record:
name: fqdn.txt.record.com
text: mytext
state: absent
view: External
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается партнером Ansible. [сертифицировано]
Авторы
- Corey Wanless (@coreywan)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/nios_txt_record_module.html