nios_fixed_address – Настройка Infoblox NIOS DHCP фиксированного адреса
Новая версия 2.8.
Описание
- Фиксированный адрес — это конкретный IP-адрес, который DHCP-сервер всегда назначает при запросе аренды от конкретного MAC-адреса клиента.
- Поддерживает оба интернет-протокола IPV4 и IPV6
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment - | Настраивает строку текста комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная строка текста будет настроена в экземпляре объекта. | ||
| extattrs - | Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки. | ||
| ipaddr - / обязательно | Адрес IPv4/IPv6 фиксированного адреса. | ||
| mac - / обязательно | MAC-адрес интерфейса. | ||
| name - | Указывает имя хоста, с которым фиксированный DHCP-адрес хранится для соответствующего MAC-адреса. | ||
| network - / обязательно | Указывает диапазон сети, в котором существует ipaddr. псевдонимы: network | ||
| network_view - | По умолчанию: "default" | Настраивает имя представления сети, которое следует ассоциировать с этим экземпляром. | |
| options - | Настраивает набор DHCP-параметров, которые следует включить в состав настроенного экземпляра сети. Этот аргумент принимает список значений (см. подпараметры). При настройке подпараметров по крайней мере одно из name или num должно быть указано. | ||
| name - | Имя DHCP-параметра для настройки | ||
| num - | Номер DHCP-параметра для настройки | ||
| use_option boolean |
| Применимо только к подмножеству параметров (см. документацию API NIOS) | |
| value - / обязательно | Значение DHCP-параметра, указанного в name
| ||
| vendor_class - | По умолчанию: "DHCP" | Имя пространства, к которому относится этот DHCP-параметр | |
| provider словарь | Объект типа dict, содержащий данные подключения. | ||
| 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 - |
| Настраивает желаемое состояние экземпляра объекта на сервере NIOS. При значении present, объект настраивается на устройстве, а при значении absent, значение удаляется (при необходимости) с устройства. | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно сделать, указав
connection: local. - Для получения более подробной информации о том, как использовать Infoblox с Ansible, прочитайте Руководство по Infoblox.
Примеры
- name: configure ipv4 dhcp fixed address
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
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
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
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
Статус
- Этот модуль не гарантирует обратной совместимости. [превью]
- Этот модуль поддерживается партнером Ansible. [сертифицированный]
Авторы
- 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.8/modules/nios_fixed_address_module.html
