Spec-Zone.ru › Ansible 2.9

nios_host_record – Настройка записей хостов Infoblox NIOS

Новое в версии 2.5.

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

Обзор

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

Требования

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

  • infoblox-client

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
aliases
-
Добавлен в 2.6
Настраивает необязательный список дополнительных псевдонимов для добавления в запись хоста. Они эквивалентны CNAME, но хранятся в записи хоста. Должны быть в формате списка.
comment
-
Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная строка текста будет настроена на экземпляре объекта.
configure_for_dns
boolean
Добавлен в 2.7
    Варианты:
  • no
  • yes ←
Устанавливает DNS для конкретного родительского элемента. Если пользователю нужно обойти DNS, он может установить значение в false.

aliases: dns
extattrs
-
Позволяет настроить расширенные атрибуты на экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
ipv4addrs
-
Настраивает IPv4-адреса для этой записи хоста. Этот аргумент принимает список значений (см. подварианты)

aliases: ipv4
configure_for_dhcp
-
Настроить запись хоста через DHCP вместо DNS, если пользователь изменит значение на true, ему нужно указать MAC-адрес для настройки

aliases: dhcp
ipv4addr
- / обязательно
Настраивает IPv4-адрес для записи хоста. Пользователи могут динамически выделять IPv4-адрес для записи хоста, передавая словарь, содержащий nios_next_ip и диапазон сети CIDR. См. пример

aliases: address
mac
-
Настраивает аппаратный MAC-адрес для записи хоста. Если пользователь устанавливает DHCP в true, ему нужно указать MAC-адрес.

aliases: mac
ipv6addrs
-
Настраивает IPv6-адреса для записи хоста. Этот аргумент принимает список значений (см. параметры)

aliases: ipv6
configure_for_dhcp
-
Настроить запись хоста через DHCP вместо DNS, если пользователь изменит значение на true, ему нужно указать MAC-адрес для настройки

aliases: dhcp
ipv6addr
- / обязательно
Настраивает IPv6-адрес для записи хоста

aliases: address
name
- / обязательно
Указывает полное имя хоста для добавления или удаления из системы. Пользователь также может обновить имя хоста, передав словарь, содержащий new_name, old_name. См. примеры.
provider
словарь
Объект словаря, содержащий данные подключения.
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
boolean
    Варианты:
  • no ←
  • yes
Булево значение для включения или выключения проверки сертификатов SSL
Значение также можно указать с помощью INFOBLOX_SSL_VERIFY переменной окружения.

aliases: ssl_verify
wapi_version
строка
По умолчанию:
"2.1"
Указывает используемую версию WAPI
Значение также можно указать с помощью INFOBLOX_WAP_VERSION переменной окружения.
До Ansible 2.8 по умолчанию использовалась версия WAPI 1.4
state
-
    Варианты:
  • present ←
  • absent
Настраивает желаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в present, объект настраивается на устройстве, а когда это значение установлено в absent, значение удаляется (при необходимости) с устройства.
ttl
-
Настраивает TTL, который будет ассоциироваться с этой записью хоста
view
- / обязательно
По умолчанию:
"default"
Устанавливает представление DNS для ассоциации с этой записью хоста. Представление DNS должно быть уже настроено в системе

aliases: dns_view

Примечания

Примечание

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

Примеры

- name: configure an ipv4 host record
  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
  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
- name: update an ipv4 host record
  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
  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
  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: dynamically add host record to next available ip
  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

Статус

  • Этот модуль не гарантирует обратной совместимости интерфейса. [preview]
  • Этот модуль поддерживается партнёром Ansible. [certified]

Авторы

  • 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.9/modules/nios_host_record_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API