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. псевдонимы: dns | |
| extattrs - | Позволяет настроить расширенные атрибуты для экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки. | ||
| ipv4addrs - | Настраивает IPv4-адреса для этой записи хоста. Этот аргумент принимает список значений (см. подварианты) псевдонимы: ipv4 | ||
| configure_for_dhcp - | Настройка записи хоста через DHCP вместо DNS. Если пользователь изменяет значение на true, ему необходимо указать MAC-адрес для настройки. псевдонимы: dhcp | ||
| ipv4addr - / обязательно | Настраивает IPv4-адрес для записи хоста псевдонимы: адрес | ||
| mac - | Настраивает аппаратный MAC-адрес для записи хоста. Если пользователь устанавливает DHCP в значение true, ему необходимо указать MAC-адрес. псевдонимы: mac | ||
| ipv6addrs - | Настраивает IPv6-адреса для записи хоста. Этот аргумент принимает список значений (см. опции) псевдонимы: ipv6 | ||
| configure_for_dhcp - | Настройка записи хоста через DHCP вместо DNS. Если пользователь изменяет значение на true, ему необходимо указать MAC-адрес для настройки. псевдонимы: dhcp | ||
| ipv6addr - / обязательно | Настраивает IPv6-адрес для записи хоста псевдонимы: адрес | ||
| 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. | ||
| ssl_verify boolean |
| Логическое значение для включения или отключения проверки сертификатов SSL. Значение также можно указать с помощью переменной окружения INFOBLOX_SSL_VERIFY. | |
| username - | Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной окружения INFOBLOX_USERNAME. | ||
| wapi_version - | По умолчанию: 1.4 | Указывает используемую версию WAPI Значение также можно указать с помощью переменной окружения INFOBLOX_WAP_VERSION. | |
| state - |
| Настраивает требуемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а когда это значение установлено в absent, значение удаляется (при необходимости) с устройства. | |
| ttl - | Настраивает TTL, который будет связан с этой записью хоста. | ||
| view - / обязательно | По умолчанию: "default" | Устанавливает DNS-зону, с которой нужно связать эту запись хоста. DNS-зона должна быть уже настроена в системе. псевдонимы: dns_view | |
Примечания
Примечание
- Этот модуль должен быть запущен локально, что можно сделать, указав
connection: local. - Для получения более подробной информации о работе с Infoblox с Ansible, обратитесь к Руководству Infoblox.
Примеры
- 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
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается партнером Ansible. [сертифицировано]
Авторы
- 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.7/modules/nios_host_record_module.html