nios_host_record – Настройка записей хостов Infoblox NIOS
Новое в версии 2.5.
Обзор
- Добавляет и/или удаляет экземпляры объектов записей хостов на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS
record:hostс использованием интерфейса Infoblox WAPI через REST. - Обновляет экземпляры объекта записи хоста на серверах Infoblox NIOS.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| aliases - Добавлен в 2.6 | Настраивает необязательный список дополнительных псевдонимов для добавления в запись хоста. Они эквивалентны CNAME, но хранятся в записи хоста. Должны быть в формате списка. | ||
| comment - | Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная строка текста будет настроена на экземпляре объекта. | ||
| configure_for_dns boolean Добавлен в 2.7 |
| Устанавливает DNS для конкретного родительского элемента. Если пользователю нужно обойти DNS, он может установить значение в false. aliases: dns | |
| extattrs - | Позволяет настроить расширенные атрибуты на экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки. | ||
| ipv4addrs - | Настраивает IPv4-адреса для этой записи хоста. Этот аргумент принимает список значений (см. подварианты) aliases: ipv4 | ||
| configure_for_dhcp - | Настроить запись хоста через DHCP вместо DNS, если пользователь изменит значение на true, ему нужно указать MAC-адрес для настройки aliases: dhcp | ||
| ipv4addr - / обязательно | Настраивает IPv4-адрес для записи хоста. Пользователи могут динамически выделять IPv4-адрес для записи хоста, передавая словарь, содержащий nios_next_ip и диапазон сети CIDR. См. пример aliases: address | ||
| mac - | Настраивает аппаратный MAC-адрес для записи хоста. Если пользователь устанавливает DHCP в true, ему нужно указать MAC-адрес. aliases: mac | ||
| ipv6addrs - | Настраивает IPv6-адреса для записи хоста. Этот аргумент принимает список значений (см. параметры) aliases: ipv6 | ||
| configure_for_dhcp - | Настроить запись хоста через DHCP вместо DNS, если пользователь изменит значение на true, ему нужно указать MAC-адрес для настройки aliases: dhcp | ||
| ipv6addr - / обязательно | Настраивает IPv6-адрес для записи хоста aliases: address | ||
| name - / обязательно | Указывает полное имя хоста для добавления или удаления из системы. Пользователь также может обновить имя хоста, передав словарь, содержащий new_name, old_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 boolean |
| Булево значение для включения или выключения проверки сертификатов SSL Значение также можно указать с помощью INFOBLOX_SSL_VERIFY переменной окружения.aliases: ssl_verify | |
| wapi_version строка | По умолчанию: "2.1" | Указывает используемую версию WAPI Значение также можно указать с помощью INFOBLOX_WAP_VERSION переменной окружения.До Ansible 2.8 по умолчанию использовалась версия WAPI 1.4 | |
| state - |
| Настраивает желаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а когда это значение установлено в absent, значение удаляется (при необходимости) с устройства. | |
| ttl - | Настраивает TTL, который будет ассоциироваться с этой записью хоста | ||
| view - / обязательно | По умолчанию: "default" | Устанавливает представление DNS для ассоциации с этой записью хоста. Представление DNS должно быть уже настроено в системе aliases: dns_view | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно достичь путем указания
connection: local. - Пожалуйста, ознакомьтесь с Руководством по Infoblox, чтобы получить более подробную информацию о том, как использовать Infoblox с Ansible.
Примеры
- name: configure an ipv4 host record
nios_host_record:
name: host.ansible.com
ipv4:
- address: 192.168.10.1
aliases:
- cname.ansible.com
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: add a comment to an existing host record
nios_host_record:
name: host.ansible.com
ipv4:
- address: 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 a host record from the system
nios_host_record:
name: host.ansible.com
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: update an ipv4 host record
nios_host_record:
name: {new_name: host-new.ansible.com, old_name: host.ansible.com}
ipv4:
- address: 192.168.10.1
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: create an ipv4 host record bypassing DNS
nios_host_record:
name: new_host
ipv4:
- address: 192.168.10.1
dns: false
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: create an ipv4 host record over DHCP
nios_host_record:
name: host.ansible.com
ipv4:
- address: 192.168.10.1
dhcp: true
mac: 00-80-C8-E3-4C-BD
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: dynamically add host record to next available ip
nios_host_record:
name: host.ansible.com
ipv4:
- address: {nios_next_ip: 192.168.10.0/24}
comment: this is a test comment
state: present
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [preview]
- Этот модуль поддерживается партнёром Ansible. [certified]
Авторы
- Питер Спрыгада (@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.8/modules/nios_host_record_module.html