community.general.nios_a_record – Настройка записей Infoblox NIOS A
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач, укажите: community.general.nios_a_record.
Обзор
- Добавляет и/или удаляет экземпляры объектов записей 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 словарь | Объект словаря, содержащий данные подключения. | ||
| 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 строка |
| Настраивает желаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а когда это значение установлено в absent, значение удаляется (при необходимости) с устройства. | |
| ttl целое число | Настраивает значение TTL, которое будет связано с этой записью A | ||
| view строка | Значение по умолчанию: "default" | Устанавливает DNS-представление для связи этой записи A. DNS-представление должно быть уже настроено в системе. псевдонимы: dns_view | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно сделать, указав
connection: local. - Для получения более подробной информации об использовании Infoblox с Ansible обратитесь к Руководству Infoblox.
Примеры
- name: Configure an A record
community.general.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
community.general.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
community.general.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
community.general.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
community.general.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
Авторы
- Blair Rampling (@brampling)
© 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_a_record_module.html
