community.general.nios_fixed_address – Настройка фиксированного адреса DHCP Infoblox NIOS

Примечание

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

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

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

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

Обзор

Фиксированный адрес — это конкретный IP-адрес, который DHCP-сервер всегда назначает при запросе аренды от конкретного MAC-адреса клиента.
Поддерживает протоколы IPV4 и IPV6.

Требования

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

infoblox-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
comment строка			Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная строка текста будет настроена в экземпляре объекта.
extattrs строка			Позволяет настроить расширенные атрибуты для экземпляра объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.
ipaddr строка / обязательно			IP-адрес (IPV4/IPV6) фиксированного адреса.
mac строка / обязательно			MAC-адрес интерфейса.
name строка / обязательно			Указывает имя хоста, в котором фиксированный DHCP IP-адрес хранится для соответствующего MAC-адреса.
network строка / обязательно			Указывает диапазон сети, в котором существует ipaddr.
network_view строка		Значение по умолчанию: "default"	Настраивает имя сетевого представления, которое нужно связать с этим экземпляром.
options список / элементы=словарь			Настраивает набор DHCP-параметров, которые следует включить в составе настроенного сетевого экземпляра. Этот аргумент принимает список значений (см. подпараметры). При настройке подпараметров необходимо указать хотя бы один из `name` или `num`.
	name строка		Имя настраиваемого DHCP-параметра.
	num строка		Номер настраиваемого DHCP-параметра.
	use_option булево	Варианты: нет да ←	Применяется только к подмножеству параметров (см. документацию API NIOS).
	value строка / обязательно		Значение настроенного DHCP-параметра, указанного в `name`.
	vendor_class строка	Значение по умолчанию: "DHCP"	Имя пространства, к которому относится этот DHCP-параметр.
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 булево	Варианты: нет ← да	Булево значение для включения или отключения проверки 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`, значение удаляется (при необходимости) с устройства.

Примечания

Примечание

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

Примеры

- name: Configure ipv4 dhcp fixed address
  community.general.nios_fixed_address:
    name: ipv4_fixed
    ipaddr: 192.168.10.1
    mac: 08:6d:41:e8:fd:e8
    network: 192.168.10.0/24
    network_view: default
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Configure a ipv6 dhcp fixed address
  community.general.nios_fixed_address:
    name: ipv6_fixed
    ipaddr: fe80::1/10
    mac: 08:6d:41:e8:fd:e8
    network: fe80::/64
    network_view: default
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Set dhcp options for a ipv4 fixed address
  community.general.nios_fixed_address:
    name: ipv4_fixed
    ipaddr: 192.168.10.1
    mac: 08:6d:41:e8:fd:e8
    network: 192.168.10.0/24
    network_view: default
    comment: this is a test comment
    options:
      - name: domain-name
        value: ansible.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: Remove a ipv4 dhcp fixed address
  community.general.nios_fixed_address:
    name: ipv4_fixed
    ipaddr: 192.168.10.1
    mac: 08:6d:41:e8:fd:e8
    network: 192.168.10.0/24
    network_view: default
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Sumit Jaiswal (@sjaiswal)

© 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_fixed_address_module.html