Модуль infoblox.nios_modules.nios_fixed_address — настройка фиксированного адреса DHCP 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_fixed_address.

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

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

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

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

Требования

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

infoblox-client

Параметры

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

Примечания

Примечание

Поле «mac» обязательно для всех операций CRUD, связанных с фиксированным адресом IPv4.
Поле «duid» обязательно для всех операций CRUD, связанных с фиксированным адресом IPv6.
Этот модуль поддерживает check_mode.
Модуль необходимо запускать локально; для этого можно указать connection: local.
Подробнее об использовании Infoblox с Ansible см. в руководстве :ref:`nios_guide`.

Примеры

- name: Configure an ipv4 dhcp fixed address
  infoblox.nios_modules.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 an ipv4 dhcp fixed address reservation
  infoblox.nios_modules.nios_fixed_address:
    name: ipv4_fixed
    ipaddr: 192.168.10.1
    mac: 00:00:00:00:00:00
    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 an ipv6 dhcp fixed address
  infoblox.nios_modules.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 an ipv4 fixed address
  infoblox.nios_modules.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 an ipv4 dhcp fixed address
  infoblox.nios_modules.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–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_fixed_address_module.html