nios_network - Настройка сетевого объекта Infoblox NIOS

Новое в версии 2.5.

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Поддержка
- Автор

Обзор

Добавляет и/или удаляет экземпляры сетевых объектов с серверов Infoblox NIOS. Этот модуль управляет объектами NIOS network с использованием интерфейса Infoblox WAPI через REST.
Поддерживает протоколы интернета IPV4 и IPV6

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

infoblox-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
comment			Настраивает строку комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная строка текста будет настроена в экземпляре объекта.
extattrs			Позволяет настраивать расширяемые атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
network обязательно			Указывает сеть для добавления или удаления из системы. Значение должно использовать нотацию CIDR. псевдонимы: имя, cidr
network_view обязательно		По умолчанию: "default"	Настраивает имя сетевого представления, которое нужно ассоциировать с этим экземпляром.
options			Настраивает набор DHCP-опций, которые необходимо включить в состав настроенного экземпляра сети. Этот аргумент принимает список значений (см. подопции). При настройке подопций хотя бы одна из `name` или `num` должна быть указана.
	name		Имя DHCP-опции для настройки
	num		Номер DHCP-опции для настройки
	value обязательно		Значение DHCP-опции, указанной в `name`
	use_option bool	Варианты: нет да ←	Применимо только к подмножеству опций (см. документацию API NIOS)
	vendor_class	По умолчанию: "DHCP"	Имя пространства, к которому относится эта DHCP-опция
provider			Объект типа dict, содержащий данные подключения.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному экземпляру NIOS WAPI через REST Значение также может быть указано с использованием `INFOBLOX_HOST` переменной окружения.
	username		Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также может быть указано с использованием `INFOBLOX_USERNAME` переменной окружения.
	password		Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также может быть указано с использованием `INFOBLOX_PASSWORD` переменной окружения.
	ssl_verify bool	Варианты: нет ← да	Булево значение для включения или отключения проверки SSL-сертификатов Значение также может быть указано с использованием `INFOBLOX_SSL_VERIFY` переменной окружения.
	http_request_timeout	По умолчанию: 10	Время ожидания получения ответа Значение также может быть указано с использованием `INFOBLOX_HTTP_REQUEST_TIMEOUT` переменной окружения.
	max_retries	По умолчанию: 3	Настраивает количество попыток повторных подключений перед объявлением подключения работоспособным Значение также может быть указано с использованием `INFOBLOX_MAX_RETRIES` переменной окружения.
	wapi_version	По умолчанию: 1.4	Указывает используемую версию WAPI Значение также может быть указано с использованием `INFOBLOX_WAP_VERSION` переменной окружения.
	max_results	По умолчанию: 1000	Указывает максимальное количество объектов, которые должны быть возвращены. Если значение установлено отрицательным, прикладное устройство вернет ошибку, если количество возвращенных объектов превысит это значение. Значение также может быть указано с использованием `INFOBLOX_MAX_RESULTS` переменной окружения.
state		Варианты: present ← absent	Настраивает предполагаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в `present`, объект настраивается на устройстве, а когда это значение установлено в `absent`, значение удаляется (при необходимости) с устройства.

Примечания

Примечание

Этот модуль должен выполняться локально, что может быть достигнуто путем указания connection: local.

Примеры

- name: configure a network ipv4
  nios_network:
    network: 192.168.10.0/24
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local
- name: configure a network ipv6
  nios_network:
    network: fe80::/64
    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 network ipv4
  nios_network:
    network: 192.168.10.0/24
    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 network ipv4
  nios_network:
    network: 192.168.10.0/24
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как ядро, что означает, что он поддерживается командой Ansible Core Team. Подробнее см. Техническое обслуживание и поддержка модулей.

Список других модулей, которые также поддерживаются командой Ansible Core Team, см. здесь.

Поддержка

Дополнительную информацию о поддержке данного модуля компанией Red Hat см. в этой статье базы знаний

Автор

Peter Sprygada (@privateip)

Подсказка

Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/nios_network_module.html