community.general.nios_fixed_address – Настройка фиксированного адреса DHCP Infoblox NIOS
Примечание
Этот плагин является частью коллекции community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в плейбуке укажите: community.general.nios_fixed_address.
Обзор
- Фиксированный адрес — это определённый IP-адрес, который DHCP-сервер всегда назначает при запросе аренды от конкретного MAC-адреса клиента.
- Поддерживает оба интернет-протокола IPV4 и IPV6
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment строка | Настраивает строку комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная строка будет настроена в экземпляре объекта. | ||
| extattrs словарь | Позволяет настроить расширенные атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки. | ||
| ipaddr строка / обязательно | IPV4/V6 адрес фиксированного адреса. | ||
| 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_pool_connections целое число | Значение по умолчанию: 10 | Количество пулов, которые будут использоваться объектом infoblox_client.Connector.Это передаётся как есть подлежащему классу requests.adapters.HTTPAdapter. | |
| http_pool_maxsize целое число | Значение по умолчанию: 10 | Максимальное количество подключений на пул, которое будет использоваться объектом infoblox_client.Connector.Это передаётся как есть подлежащему классу requests.adapters.HTTPAdapter. | |
| http_request_timeout целое число | Значение по умолчанию: 10 | Время ожидания ответа Значение также можно указать, используя INFOBLOX_HTTP_REQUEST_TIMEOUT переменную среды. | |
| max_results целое число | Значение по умолчанию: 1000 | Указывает максимальное количество возвращаемых объектов; если задано отрицательное значение, прибор вернёт ошибку, если количество возвращаемых объектов превысит установку. Значение также можно указать, используя INFOBLOX_MAX_RESULTS переменную среды. | |
| max_retries целое число | Значение по умолчанию: 3 | Настраивает количество попыток повторных подключений перед тем, как соединение будет объявлено работоспособным Значение также можно указать, используя INFOBLOX_MAX_RETRIES переменную среды. | |
| password строка | Указывает пароль для аутентификации подключения к удалённому экземпляру NIOS. Значение также можно указать, используя INFOBLOX_PASSWORD переменную среды. | ||
| silent_ssl_warnings логическое значение |
| Отключить urllib3 предупреждения SSL в объекте infoblox_client.Connector.Это передаётся как есть подлежащему классу requests.adapters.HTTPAdapter. | |
| 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 Guide.
Примеры
- 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/nios_fixed_address_module.html