infoblox.nios_modules.nios_host_record модуль – Настройка записей хостов NIOS Infoblox

Примечание

Этот модуль является частью коллекции infoblox.nios_modules (версия 1.7.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

Параметры

Параметр	Комментарии
псевдонимы список / элементы=строка	Настраивает необязательный список дополнительных псевдонимов для добавления к записи хоста. Они эквивалентны CNAME, но хранятся в записи хоста. Должен быть в формате списка.
комментарий строка	Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная строка текста будет настроена в экземпляре объекта.
configure_for_dns псевдонимы: dns логическое	Устанавливает DNS для определенного родительского элемента. Если пользователю нужно обойти DNS, он может установить значение в false. Варианты: `false` `true` ← (по умолчанию)
extattrs словарь	Позволяет настроить расширенные атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
ipv4addrs псевдонимы: ipv4 список / элементы=словарь	Настраивает IPv4-адреса для этой записи хоста. Этот аргумент принимает список значений (см. подварианты).
add псевдонимы: add логическое добавлен в infoblox.nios_modules 1.0.0	Если пользователь хочет добавить IPv4-адрес в существующую запись хоста. Обратите внимание, что при использовании add необходимо сохранить состояние как present, так как новый IP-адрес назначается существующей записи хоста. См. примеры. Варианты: `false` `true`
configure_for_dhcp псевдонимы: dhcp логическое	Настройте запись хоста через DHCP вместо DNS, если пользователь изменит это на true, ему необходимо указать MAC-адрес для настройки. Варианты: `false` `true`
ipv4addr псевдонимы: адрес строка / обязательно	Настраивает IPv4-адрес для записи хоста. Пользователи могут динамически назначать IPv4-адрес записи хоста, передавая словарь, содержащий nios_next_ip и диапазон сети CIDR. Если пользователь хочет добавить или удалить IPv4-адрес из существующей записи, необходимо использовать параметры add/remove. См. примеры.
mac псевдонимы: mac строка	Настраивает аппаратный MAC-адрес для записи хоста. Если пользователь устанавливает DHCP в true, ему необходимо указать MAC-адрес.
nextserver псевдонимы: pxe строка добавлен в infoblox.nios_modules 1.0.0	Принимает в качестве входных данных имя в формате FQDN и/или IPv4-адрес следующего сервера, с которого хост должен загружаться.
remove псевдонимы: remove логическое добавлен в infoblox.nios_modules 1.0.0	Если пользователь хочет удалить IPv4-адрес из существующей записи хоста. Обратите внимание, что при использовании remove необходимо изменить состояние на absent, так как IP-адрес отсоединяется от существующей записи хоста. См. примеры. Варианты: `false` `true`
use_for_ea_inheritance логическое добавлен в infoblox.nios_modules 1.7.0	Когда use_for_ea_inheritance равно True, EA наследуется от адреса хоста. Значение по умолчанию — False. Варианты: `false` ← (по умолчанию) `true`
use_nextserver псевдонимы: use_pxe логическое добавлен в infoblox.nios_modules 1.0.0	Включить использование параметра nextserver Варианты: `false` `true`
ipv6addrs псевдонимы: ipv6 список / элементы=словарь	Настраивает IPv6-адреса для записи хоста. Этот аргумент принимает список значений (см. параметры).

configure_for_dhcp boolean	Настроить запись host_record через DHCP вместо DNS; если пользователь устанавливает значение true, необходимо указать MAC-адрес для настройки. Варианты: `false` `true`
ipv6addr aliases: address string / required	Настраивает IPv6-адрес для записи узла.
mac aliases: mac string	Настраивает аппаратный MAC-адрес для записи узла. Если пользователь устанавливает DHCP в значение true, необходимо указать MAC-адрес.
name string / required	Указывает полное доменное имя, которое нужно добавить или удалить из системы. Пользователь также может обновить имя хоста, так как можно передать словарь, содержащий new_name, old_name. См. примеры.
provider dictionary	Объект словаря, содержащий данные о подключении.
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 aliases: 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"`

состояние строка	Настраивает желаемое состояние экземпляра объекта на сервере NIOS. При значении `present`, объект настраивается на устройстве, а при значении `absent` значение удаляется (при необходимости) с устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`
ttl целое число	Настраивает значение TTL, которое должно быть связано с этим записываемым хостом.
use_dns_ea_inheritance логическое добавлено в infoblox.nios_modules 1.7.0	Когда use_dns_ea_inheritance имеет значение True, EA наследуется из связанной зоны. Значение по умолчанию — False. Варианты: `false` ← (по умолчанию) `true`
представление псевдонимы: dns_view строка	Устанавливает представление DNS для ассоциации с этим записываемым хостом. Представление DNS должно быть уже настроено в системе. По умолчанию: `"default"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль должен выполняться локально, что можно сделать, указав connection: local.
Пожалуйста, обратитесь к :ref:`nios_guide`, чтобы получить более подробную информацию о том, как использовать Infoblox с Ansible.

Примеры

- 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

Авторы

Peter Sprygada (@privateip)

Ссылки на сборки

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