community.general.nios_next_ip – Возврат следующего доступного IP-адреса для сети

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

Для его установки используйте: 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_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 булево	Варианты: нет да ←	Отключение предупреждений 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.

Примечания

Примечание

Этот модуль должен выполняться локально, что может быть достигнуто путём указания 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/nios_next_ip_lookup.html