infoblox.nios_modules.nios_fixed_address module – Настройка фиксированного IP-адреса DHCP Infoblox NIOS

Примечание

Этот модуль является частью коллекции infoblox.nios_modules (версия 1.7.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install infoblox.nios_modules. Для использования этого модуля требуются дополнительные компоненты, см. Требования для получения подробной информации.

Для использования в playbook, укажите: 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 / required	IPv4/IPv6-адрес фиксированного адреса.
mac string	MAC-адрес IPv4-интерфейса. Для резервирования фиксированного адреса укажите MAC-адрес как 00:00:00:00:00:00
name string / required	Указывает имя хоста, с которым хранится фиксированный DHCP IP-адрес для соответствующего MAC-адреса.
network aliases: network string	Указывает диапазон сети, в котором существует ipaddr.
network_view string	Настраивает имя представления сети, которое необходимо связать с этим настроенным экземпляром. Значение по умолчанию: `"default"`
options list / elements=dictionary	Настраивает набор параметров DHCP, которые должны быть включены как часть настроенного экземпляра сети. Этот аргумент принимает список значений (см. подпараметры). При настройке подпараметров необходимо указать хотя бы один из `name` или `num`.
name string	Имя настраиваемого параметра DHCP
num integer	Номер настраиваемого параметра DHCP
use_option boolean	Применяется только к подмножеству параметров (см. документацию по API NIOS) Варианты: `false` `true` ← (по умолчанию)
value string / required	Значение параметра 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`. Default: `1000`
max_retries integer	Настраивает количество попыток повторного подключения перед тем, как соединение будет объявлено работоспособным. Значение также может быть указано с помощью переменной окружения `INFOBLOX_MAX_RETRIES`. Default: `3`
password string	Указывает пароль, который будет использоваться для аутентификации подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной окружения `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание здесь Choices: `false` `true` ← (default)
username string	Настраивает имя пользователя, которое будет использоваться для аутентификации подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной окружения `INFOBLOX_USERNAME`.
validate_certs aliases: ssl_verify boolean	Логическое значение для включения или отключения проверки SSL-сертификатов Значение также может быть указано с помощью переменной окружения `INFOBLOX_SSL_VERIFY`. Choices: `false` ← (default) `true`
wapi_version string	Указывает версию WAPI для использования. Значение также может быть указано с помощью переменной окружения `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версией WAPI по умолчанию была 1.4. Default: `"2.12.3"`
state string	Настраивает требуемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в `present`, объект настраивается на устройстве, а когда это значение установлено в `absent`, значение удаляется (при необходимости) с устройства. Choices: `"present"` ← (default) `"absent"`

Примечания

Примечание

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

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/infoblox/nios_modules/nios_fixed_address_module.html