community.general.nios_a_record – Настройка записей Infoblox NIOS A

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать его в книге задач, укажите: community.general.nios_a_record.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

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

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

infoblox-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
comment строка			Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная строка текста будет настроена на экземпляре объекта.
extattrs строка			Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
ipv4addr строка			Настраивает IPv4-адрес для этой записи A. Пользователи могут динамически назначать IPv4-адрес записи A, передавая словарь, содержащий nios_next_ip и Диапазон сети CIDR. Смотрите пример псевдонимы: ipv4
name строка / обязательно			Указывает полное доменное имя, которое нужно добавить или удалить из системы
provider словарь			Объект типа dict, содержащий данные подключения.
	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`.
	username строка		Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать, используя переменную окружения `INFOBLOX_USERNAME`.
	validate_certs логическое значение	Варианты: нет ← да	Логическое значение для включения или отключения проверки сертификатов SSL Значение также можно указать, используя переменную окружения `INFOBLOX_SSL_VERIFY`. псевдонимы: ssl_verify
	wapi_version строка	По умолчанию: "2.1"	Указывает версию WAPI для использования Значение также можно указать, используя переменную окружения `INFOBLOX_WAP_VERSION`. До версии Ansible 2.8 значением по умолчанию для WAPI была версия 1.4
state строка		Варианты: present ← absent	Настраивает целевое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в `present`, объект настраивается на устройстве, а когда это значение установлено в `absent`, значение удаляется (при необходимости) с устройства.
ttl строка			Настраивает TTL, который будет связан с этой записью A
view строка		По умолчанию: "default"	Устанавливает DNS-представление для связывания этой записи A. DNS-представление должно быть уже настроено в системе псевдонимы: dns_view

Примечания

Примечание

Этот модуль должен выполняться локально, что может быть достигнуто, указав connection: local.
Обратитесь к Руководству по Infoblox для получения более подробной информации о том, как использовать Infoblox с Ansible.

Примеры

- name: Configure an A record
  community.general.nios_a_record:
    name: a.ansible.com
    ipv4: 192.168.10.1
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to an existing A record
  community.general.nios_a_record:
    name: a.ansible.com
    ipv4: 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 an A record from the system
  community.general.nios_a_record:
    name: a.ansible.com
    ipv4: 192.168.10.1
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update an A record name
  community.general.nios_a_record:
    name: {new_name: a_new.ansible.com, old_name: a.ansible.com}
    ipv4: 192.168.10.1
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Dynamically add a record to next available ip
  community.general.nios_a_record:
    name: a.ansible.com
    ipv4: {nios_next_ip: 192.168.10.0/24}
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Blair Rampling (@brampling)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/nios_a_record_module.html