Модуль infoblox.nios_modules.nios_host_record — настройка записей хостов Infoblox NIOS

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Чтобы установить коллекцию, используйте: ansible-galaxy collection install infoblox.nios_modules. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: infoblox.nios_modules.nios_host_record.

Добавлено в infoblox.nios_modules 1.0.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Добавляет и/или удаляет экземпляры объектов записей хостов на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS record:host с помощью интерфейса Infoblox WAPI через REST.
Обновляет экземпляры объектов записей хостов на серверах Infoblox NIOS.

Требования

На узле, где выполняется этот модуль, требуются следующие компоненты.

infoblox-client

Параметры

Параметр	Комментарии
aliases list / elements=string	Настраивает необязательный список дополнительных псевдонимов для добавления к записи хоста. Они эквивалентны записям CNAME, но хранятся в записи хоста. Значение должно быть задано в виде списка.
comment string	Задает текстовый комментарий, связанный с экземпляром этого объекта. Указанная текстовая строка будет сохранена в экземпляре объекта.
configure_for_dns псевдонимы: dns boolean	Задает родительский DNS. Если пользователю нужно отключить DNS, он может установить значение false. Варианты: `false` `true` ← (по умолчанию)
extattrs dictionary	Позволяет настроить расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар «ключ — значение» для настройки.
ipv4addrs псевдонимы: ipv4 list / elements=dictionary	Настраивает адреса IPv4 для этой записи хоста. Аргумент принимает список значений (см. вложенные параметры).
add псевдонимы: add boolean добавлено в infoblox.nios_modules 1.0.0	Указывает, нужно ли добавить адрес IPv4 к существующей записи хоста. Обратите внимание: при использовании add необходимо установить для state значение present, так как новый IP-адрес назначается существующей записи хоста. См. примеры. Варианты: `false` `true`
configure_for_dhcp псевдонимы: dhcp boolean	Настраивает host_record через DHCP вместо DNS. Если установить значение true, необходимо указать MAC-адрес. Варианты: `false` `true`
ipv4addr псевдонимы: address string / обязательный	Настраивает адрес IPv4 для записи хоста. Пользователь может динамически назначить записи хоста адрес IPv4, передав словарь, содержащий nios_next_ip и CIDR network range. Если нужно добавить адрес IPv4 к существующей записи или удалить его из нее, следует использовать параметры add/remove. См. примеры.
mac псевдонимы: mac string	Настраивает аппаратный MAC-адрес для записи хоста. Если для DHCP задано значение true, необходимо указать MAC-адрес.
nextserver псевдонимы: pxe string добавлено в infoblox.nios_modules 1.0.0	Принимает имя в формате FQDN и/или адрес IPv4 следующего сервера, с которого должен загружаться хост.
remove псевдонимы: remove boolean добавлено в infoblox.nios_modules 1.0.0	Указывает, нужно ли удалить адрес IPv4 из существующей записи хоста. Обратите внимание: при использовании remove необходимо изменить значение state на absent, так как IP-адрес освобождается из существующей записи хоста. См. примеры. Варианты: `false` `true`
use_for_ea_inheritance boolean добавлено в infoblox.nios_modules 1.7.0	Если use_for_ea_inheritance имеет значение True, расширяемые атрибуты наследуются от адреса хоста. Значение по умолчанию — False. Варианты: `false` ← (по умолчанию) `true`
use_nextserver псевдонимы: use_pxe boolean добавлено в infoblox.nios_modules 1.0.0	Включает использование параметра nextserver Варианты: `false` `true`
ipv6addrs псевдонимы: ipv6 list / elements=dictionary	Настраивает адреса IPv6 для записи хоста. Аргумент принимает список значений (см. параметры).
configure_for_dhcp псевдонимы: dhcp boolean	Настраивает host_record через DHCP вместо DNS. Если установить значение true, необходимо указать адрес DUID. Варианты: `false` `true`
duid псевдонимы: duid string	Настраивает аппаратный адрес DUID для записи хоста. Если для DHCP задано значение true, необходимо указать адрес DUID.
ipv6addr псевдонимы: address string / обязательный	Настраивает адрес IPv6 для записи хоста.
name string / обязательный	Указывает полное имя хоста, которое нужно добавить в систему или удалить из нее. Также можно обновить имя хоста, передав словарь, содержащий new_name и old_name. См. примеры.
provider dictionary	Объект dict, содержащий сведения о подключении.
cert string	Указывает файл сертификата клиента с дайджестом конфигурации x509 для дополнительного уровня защиты соединения с удаленным экземпляром NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_CERT`.
host string	Указывает DNS-имя хоста или адрес для подключения к удаленному экземпляру NIOS WAPI через REST. Значение также можно задать с помощью переменной окружения `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте описание здесь По умолчанию: `10`
http_pool_maxsize integer	Вставьте описание здесь По умолчанию: `10`
http_request_timeout integer	Время ожидания ответа Значение также можно задать с помощью переменной окружения `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key string	Указывает файл закрытого ключа для шифрования с помощью сертификата при подключении к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_KEY`.
max_results integer	Указывает максимальное количество возвращаемых объектов. Если задано отрицательное число, устройство вернет ошибку, когда количество возвращаемых объектов превысит указанное значение. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries integer	Настраивает количество повторных попыток подключения до признания соединения работоспособным. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password string	Указывает пароль для аутентификации при подключении к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание здесь Варианты: `false` `true` ← (по умолчанию)
username string	Настраивает имя пользователя для аутентификации при подключении к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify boolean	Логическое значение, включающее или отключающее проверку сертификатов SSL. Значение также можно задать с помощью переменной окружения `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Указывает используемую версию WAPI. Значение также можно задать с помощью переменной окружения `INFOBLOX_WAPI_VERSION`. До ansible 2.8 версией WAPI по умолчанию была 1.4 По умолчанию: `"2.12.3"`
state string	Задает требуемое состояние экземпляра объекта на сервере NIOS. Если задано значение `present`, объект настраивается на устройстве; если задано значение `absent`, объект удаляется с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`
ttl integer	Настраивает TTL, связанный с этой записью хоста.
use_dns_ea_inheritance boolean добавлено в infoblox.nios_modules 1.7.0	Если use_dns_ea_inheritance имеет значение True, расширяемые атрибуты наследуются от связанной зоны. Значение по умолчанию — False. Варианты: `false` ← (по умолчанию) `true`
view псевдонимы: dns_view string	Задает представление DNS, с которым связывается эта запись хоста. Представление DNS должно быть предварительно настроено в системе. По умолчанию: `"default"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль необходимо запускать локально. Для этого можно указать connection: local.
Подробные сведения об использовании Infoblox с Ansible см. в руководстве :ref:`nios_guide`.

Примеры

- name: Configure an ipv4 host record
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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: Create an ipv4 host record with DNS EA inheritance enabled
  infoblox.nios_modules.nios_host_record:
    name: host.ansible.com
    configure_for_dns: true
    use_dns_ea_inheritance: true
    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: Create an ipv4 host record with host address EA inheritance enabled
  infoblox.nios_modules.nios_host_record:
    name: host.ansible.com
    configure_for_dns: true
    ipv4:
      - address: 192.168.10.1
        dhcp: true
        mac: 00-80-C8-E3-4C-BD
        use_for_ea_inheritance: true
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create an ipv4 host record over DHCP with PXE server
  infoblox.nios_modules.nios_host_record:
    name: host.ansible.com
    ipv4:
      - address: 192.168.10.1
        dhcp: true
        mac: 00-80-C8-E3-4C-BD
        use_nextserver: true
        nextserver: pxe-server.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local


- name: Dynamically add host record to next available ip
  infoblox.nios_modules.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

- name: Add ip to host record
  infoblox.nios_modules.nios_host_record:
    name: host.ansible.com
    ipv4:
      - address: 192.168.10.2
        add: true
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove ip from host record
  infoblox.nios_modules.nios_host_record:
    name: host.ansible.com
    ipv4:
      - address: 192.168.10.1
        remove: true
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create host record with IPv4 and IPv6 addresses
  infoblox.nios_modules.nios_host_record:
    name: hostrec.ansible.com
    ipv4:
      - address: 192.168.10.7
        mac: 12:80:C8:E3:4C:AB
    ipv6:
      - address: fe80::10
        duid: 12:80:C8:E3:4C:B4
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
    connection: local

Авторы

Peter Sprygada (@privateip)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/infoblox/nios_modules/nios_host_record_module.html