nios_host_record - Настройка записей хостов Infoblox NIOS
Новая версия 2.5.
Обзор
- Добавляет и/или удаляет экземпляры объектов записей хостов на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS
record:hostс использованием интерфейса Infoblox WAPI через REST. - Обновляет экземпляры объектов записей хостов на серверах Infoblox NIOS.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment | Настраивает текстовую строку комментария, которая будет связана с экземпляром этого объекта. Указанная строка будет настроена в экземпляре объекта. | ||
| extattrs | Позволяет настроить расширенные атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки. | ||
| ipv4addrs | Настраивает IPv4-адреса для этого записей хоста. Этот аргумент принимает список значений (см. подварианты) псевдонимы: ipv4 | ||
| ipv4addr обязательно | Настраивает IPv4-адрес для записи хоста псевдонимы: адрес | ||
| mac | Настраивает аппаратный MAC-адрес для записи хоста | ||
| ipv6addrs | Настраивает IPv6-адреса для записи хоста. Этот аргумент принимает список значений (см. варианты) псевдонимы: ipv6 | ||
| ipv6addr обязательно | Настраивает IPv6-адрес для записи хоста псевдонимы: адрес | ||
| name обязательно | Указывает полное доменное имя хоста для добавления или удаления из системы. Пользователь также может обновить имя хоста, передав словарь, содержащий new_name, old_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 значение удаляется (при необходимости) с устройства. | |
| ttl | Настраивает TTL для этой записи хоста | ||
| view обязательно | Значение по умолчанию: "default" | Устанавливает DNS-представление для ассоциации с этой записью хоста. DNS-представление должно быть уже настроено в системе псевдонимы: dns_view | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно сделать, указав
connection: local.
Примеры
- name: configure an ipv4 host record
nios_host_record:
name: host.ansible.com
ipv4:
- address: 192.168.10.1
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
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратной совместимости интерфейса.
Техническое обслуживание
Этот модуль помечен как основной, что означает, что он поддерживается Командой 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_host_record_module.html