nios_zone — Настройка зон DNS Infoblox NIOS
Новая в версии 2.5.
Обзор
- Добавляет и/или удаляет экземпляры объектов зон DNS с серверов Infoblox NIOS. Этот модуль управляет объектами NIOS
zone_authс использованием интерфейса Infoblox WAPI через REST.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment | Настраивает строку комментария, которая будет ассоциирована с экземпляром этого объекта. Указанная строка будет настроена на экземпляре объекта. | ||
| extattrs | Позволяет настроить расширяемые атрибуты на экземпляре объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки. | ||
| fqdn обязательно | Указывает полное доменное имя, которое нужно добавить или удалить с экземпляра NIOS в зависимости от настроенного значения state.псевдонимы: имя | ||
| grid_primary | Настраивает первичные серверы сетки для этой зоны. | ||
| name обязательно | Имя первичного сервера сетки | ||
| grid_secondaries | Настраивает вторичные серверы сетки для этой зоны. | ||
| name обязательно | Имя вторичного сервера сетки | ||
| provider | Объект словаря, содержащий данные подключения. | ||
| host обязательно | Указывает имя или адрес хоста DNS для подключения к удаленному экземпляру NIOS WAPI через REST Значение также можно указать с помощью переменной среды INFOBLOX_HOST. | ||
| username | Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной среды INFOBLOX_USERNAME. | ||
| password | Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной среды INFOBLOX_PASSWORD. | ||
| ssl_verify bool |
| Булево значение для включения или отключения проверки сертификатов SSL Значение также можно указать с помощью переменной среды INFOBLOX_SSL_VERIFY. | |
| http_request_timeout | По умолчанию: 10 | Время ожидания ответа Значение также можно указать с помощью переменной среды INFOBLOX_HTTP_REQUEST_TIMEOUT. | |
| max_retries | По умолчанию: 3 | Настраивает количество попыток повторных подключений до объявления подключения работоспособным Значение также можно указать с помощью переменной среды INFOBLOX_MAX_RETRIES. | |
| wapi_version | По умолчанию: 1.4 | Указывает используемую версию WAPI Значение также можно указать с помощью переменной среды INFOBLOX_WAP_VERSION. | |
| max_results | По умолчанию: 1000 | Указывает максимальное количество возвращаемых объектов. Если установлено отрицательное значение, при превышении числа возвращаемых объектов приложение вернет ошибку. Значение также можно указать с помощью переменной среды INFOBLOX_MAX_RESULTS. | |
| state |
| Настраивает требуемое состояние экземпляра объекта на сервере NIOS. При значении present, объект настраивается на устройстве, а при значении absent, значение удаляется (при необходимости) с устройства. | |
| view обязательно | По умолчанию: "default" | Настраивает имя представления DNS для настроенного ресурса. Указанная зона DNS должна уже существовать на работающем экземпляре NIOS до настройки зон. псевдонимы: dns_view | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно сделать, указав
connection: local.
Примеры
- name: configure a zone on the system
nios_zone:
name: ansible.com
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: update the comment and ext attributes for an existing zone
nios_zone:
name: ansible.com
comment: this is an example comment
extattrs:
Site: west-dc
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: remove the dns zone
nios_zone:
name: ansible.com
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
Статус
Этот модуль помечен как предварительная версия, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как ядровое, что означает, что он поддерживается Командой по поддержке Ansible Core. См. Техническое обслуживание модулей и поддержка для получения дополнительной информации.
Список других модулей, которые также поддерживаются Командой по поддержке Ansible Core, см. в здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний
Автор
- Peter Sprygada (@privateip)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/nios_zone_module.html