nios_host_record - Настройка записей хостов Infoblox NIOS
Новое в версии 2.5.
Обзор
- Добавляет и/или удаляет экземпляры объектов записей хостов на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS
record:hostс использованием интерфейса Infoblox WAPI через REST.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- infoblox_client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment | Назначает строку комментария, которая будет связана с экземпляром этого объекта. Предоставленная строка текста будет настроена в объекте. | ||
| extattrs | Позволяет настроить расширенные атрибуты для экземпляра объекта. Этот аргумент принимает набор пар "ключ/значение" для настройки. | ||
| ipv4addrs | По умолчанию: Нет | Настраивает IP-адреса IPv4 для записи хоста. Этот аргумент принимает список значений (см. подварианты). Псевдонимы: ipv4 | |
| mac | Настраивает аппаратный MAC-адрес для записи хоста. | ||
| ipv4addr обязательно | По умолчанию: Нет | Настраивает IP-адрес IPv4 для записи хоста. Псевдонимы: адрес | |
| ipv6addrs | По умолчанию: Нет | Настраивает IP-адреса IPv6 для записи хоста. Этот аргумент принимает список значений (см. варианты). Псевдонимы: ipv6 | |
| ipv6addr обязательно | По умолчанию: Нет | Настраивает IP-адрес IPv6 для записи хоста. Псевдонимы: адрес | |
| name обязательно | По умолчанию: Нет | Указывает полное доменное имя хоста для добавления или удаления из системы. | |
| provider | По умолчанию: Нет | Объект типа dict, содержащий данные подключения. | |
| username | Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать, используя переменную среды INFOBLOX_USERNAME. | ||
| http_request_timeout | По умолчанию: 10 | Время ожидания ответа перед подключением. Значение также можно указать, используя переменную среды INFOBLOX_HTTP_REQUEST_TIMEOUT. | |
| max_retries | По умолчанию: 3 | Настраивает количество попыток повторного подключения перед объявлением подключения успешным. Значение также можно указать, используя переменную среды INFOBLOX_MAX_RETRIES. | |
| wapi_version | По умолчанию: 1.4 | Указывает версию WAPI для использования. Значение также можно указать, используя переменную среды INFOBLOX_WAP_VERSION. | |
| ssl_verify | По умолчанию: нет | Булево значение для включения или выключения проверки сертификатов SSL. Значение также можно указать, используя переменную среды INFOBLOX_SSL_VERIFY. | |
| max_results | По умолчанию: 1000 | Указывает максимальное количество возвращаемых объектов. Если значение отрицательное, при превышении лимита объектов, возвращаемых приложением, будет возвращено сообщение об ошибке. Значение также можно указать, используя переменную среды INFOBLOX_MAX_RESULTS. | |
| host обязательно | Указывает имя хоста DNS или адрес для подключения к удаленному экземпляру NIOS WAPI через REST. Значение также можно указать, используя переменную среды INFOBLOX_HOST. | ||
| password | По умолчанию: Нет | Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать, используя переменную среды INFOBLOX_PASSWORD. | |
| state |
| Настраивает желаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а при установке в absent значение удаляется (при необходимости) с устройства. | |
| ttl | По умолчанию: Нет | Настраивает TTL, который будет связан с этой записью хоста. | |
| view обязательно | По умолчанию: default | Устанавливает представление DNS для связи с этой записью хоста. Представление DNS должно быть уже настроено в системе. Псевдонимы: представление_dns | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно сделать, указав
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
Статус
Этот модуль помечен как preview, что означает, что гарантии обратной совместимости интерфейса нет.
Автор
- 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.5/modules/nios_host_record_module.html
