nios_a_record – Настройка записей A в Infoblox NIOS
Новое в версии 2.7.
Обзор
- Добавляет и/или удаляет экземпляры объектов записей A с серверов Infoblox NIOS. Этот модуль управляет объектами NIOS
record:aс использованием интерфейса Infoblox WAPI через REST.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment - | Настраивает текстовую строку комментария, которая будет ассоциирована с экземпляром этого объекта. Указанная текстовая строка будет настроена на экземпляре объекта. | ||
| extattrs - | Позволяет настроить расширяемые атрибуты на экземпляре объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки. | ||
| ipv4addr - / обязательно | Настраивает IPv4-адрес для этой записи A. Пользователи могут динамически назначать IPv4-адрес записи A, передавая словарь, содержащий nios_next_ip и диапазон сети CIDR. См. пример Псевдонимы: ipv4 | ||
| name - / обязательно | Указывает полное доменное имя хоста для добавления или удаления из системы | ||
| provider словарь | Объект типа dict, содержащий данные подключения. | ||
| 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, значение удаляется (при необходимости) с устройства. | |
| ttl - | Настраивает TTL для этой записи A | ||
| view - / обязательно | По умолчанию: "default" | Устанавливает DNS-вид для ассоциации этой записи A. DNS-вид должен быть уже настроен в системе Псевдонимы: dns_view | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что может быть достигнуто путём указания
connection: local. - Для получения более подробной информации о использовании Infoblox с Ansible, прочитайте Руководство по Infoblox.
Примеры
- name: configure an A record
nios_a_record:
name: a.ansible.com
ipv4: 192.168.10.1
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: add a comment to an existing A record
nios_a_record:
name: a.ansible.com
ipv4: 192.168.10.1
comment: this is a test comment
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: remove an A record from the system
nios_a_record:
name: a.ansible.com
ipv4: 192.168.10.1
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: update an A record name
nios_a_record:
name: {new_name: a_new.ansible.com, old_name: a.ansible.com}
ipv4: 192.168.10.1
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: dynamically add a record to next available ip
nios_a_record:
name: a.ansible.com
ipv4: {nios_next_ip: 192.168.10.0/24}
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [предварительный]
- Этот модуль поддерживается партнёром Ansible. [сертифицированный]
Авторы
- Blair Rampling (@brampling)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_a_record_module.html