Модуль infoblox.nios_modules.nios_a_record — настройка A-записей 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_a_record.

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

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

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

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

Требования

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

infoblox-client

Параметры

Параметр	Описание
comment string	Задает текстовый комментарий для экземпляра этого объекта. Указанный текст будет добавлен к экземпляру объекта.
extattrs dictionary	Позволяет настраивать расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.
ipv4addr псевдонимы: ipv4 string / обязательный	Задает IPv4-адрес для этой A-записи. Чтобы динамически выделить IPv4-адрес для A-записи, можно передать словарь, содержащий nios_next_ip и диапазон сети CIDR. Также можно статически обновить IPv4-адрес A-записи, передав словарь, содержащий old_ipv4addr и new_ipv4addr. См. пример.
name string / обязательный	Задает полное доменное имя хоста, которое нужно добавить в систему или удалить из нее. Имя также можно обновить, передав словарь, содержащий 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 псевдонимы: 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 для этой A-записи.
view псевдонимы: dns_view string	Задает DNS-представление, с которым будет связана эта A-запись. DNS-представление должно быть предварительно настроено в системе. По умолчанию: `"default"`

Примечания

Примечание

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

Примеры

- name: Configure an A record
  infoblox.nios_modules.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
  infoblox.nios_modules.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
  infoblox.nios_modules.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 in custom view with a dynamic IP using nios_next_ip
  infoblox.nios_modules.nios_a_record:
    name: test.parent.com
    view: default.custom
    ipv4: {'old_ipv4addr': '10.0.0.5', nios_next_ip: 80.0.0.0/24}
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update an A record with static ip
  infoblox.nios_modules.nios_a_record:
    name: test.parent.com
    view: default.custom
    ipv4: {'old_ipv4addr': '10.0.0.5', new_ipv4addr: '17.0.0.5'}
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update an A record name
  infoblox.nios_modules.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
  infoblox.nios_modules.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–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_a_record_module.html