community.general.nios_next_ip – Возврат следующего доступного IP-адреса для сети
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в плейбуке укажите: community.general.nios_next_ip.
Обзор
- Использует API Infoblox WAPI для возврата следующих доступных IP-адресов для заданного CIDR-сети.
Требования
Ниже перечислены требования к локальному контроллеру, на котором выполняется этот поиск.
- infoblox-client
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии | |
|---|---|---|---|---|
| _terms строка / обязательный | CIDR-сеть для получения следующих адресов | |||
| exclude строка | Список IP-адресов, которые необходимо исключить из возвращаемых IP-адресов | |||
| num строка | По умолчанию: 1 | Количество возвращаемых IP-адресов | ||
| 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 | ||
Примечания
Примечание
- Этот модуль должен выполняться локально, что может быть достигнуто путём указания
connection: local. - Для получения дополнительной информации о том, как использовать Infoblox с Ansible, ознакомьтесь с руководством Infoblox.
Примеры
- name: return next available IP address for network 192.168.10.0/24
ansible.builtin.set_fact:
ipaddr: "{{ lookup('community.general.nios_next_ip', '192.168.10.0/24', provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}"
- name: return the next 3 available IP addresses for network 192.168.10.0/24
ansible.builtin.set_fact:
ipaddr: "{{ lookup('community.general.nios_next_ip', '192.168.10.0/24', num=3, provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}"
- name: return the next 3 available IP addresses for network 192.168.10.0/24 excluding ip addresses - ['192.168.10.1', '192.168.10.2']
ansible.builtin.set_fact:
ipaddr: "{{ lookup('community.general.nios_next_ip', '192.168.10.0/24', num=3, exclude=['192.168.10.1', '192.168.10.2'],
provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого поиска:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| _list список / элементы=строка | успех | Список доступных следующих IP-адресов |
Авторы
- Неизвестно (!UNKNOWN)
© 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_next_ip_lookup.html