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

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

Обзор
Требования
Параметры
Примечания
Примеры
Статус

Обзор

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

Требования

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

infoblox-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
comment -			Настраивает текстовую строку комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная строка текста будет настроена на экземпляре объекта.
container boolean добавлено в 2.8		Варианты: no yes	Если установлено в значение true, то будет создан контейнер сети для добавления или удаления из системы.
extattrs -			Позволяет настроить расширяемые атрибуты на экземпляре объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.
network - / обязательно			Указывает сеть для добавления или удаления из системы. Значение должно использовать нотацию CIDR. псевдонимы: name, cidr
network_view - / обязательно		Значение по умолчанию: "default"	Настраивает имя сетевого представления, которое необходимо ассоциировать с этим настроенным экземпляром.
options -			Настраивает набор опций DHCP, которые необходимо включить в качестве части настроенного экземпляра сети. Этот аргумент принимает список значений (см. подопции). При настройке подопций как минимум один из `name` или `num` должен быть указан.
	name -		Имя опции DHCP для настройки. Стандартные опции — `router`, `router-templates`, `domain-name-servers`, `domain-name`, `broadcast-address`, `broadcast-address-offset`, `dhcp-lease-time`, и `dhcp6.name-servers`.
	num -		Номер опции DHCP для настройки
	use_option boolean	Варианты: no да ←	Применимо только к подмножеству опций (см. документацию API NIOS)
	value - / обязательно		Значение опции DHCP, указанной в `name`.
	vendor_class -	Значение по умолчанию: "DHCP"	Имя пространства, к которому относится эта опция DHCP
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 boolean	Варианты: нет ← да	Булево значение для включения или отключения проверки сертификатов SSL. Значение также может быть указано с помощью переменной среды `INFOBLOX_SSL_VERIFY`. псевдонимы: ssl_verify
	wapi_version строка	Значение по умолчанию: "2.1"	Указывает используемую версию WAPI. Значение также может быть указано с помощью переменной среды `INFOBLOX_WAP_VERSION`. До Ansible 2.8 по умолчанию использовалась версия WAPI 1.4.
state -		Варианты: present ← absent	Настраивает требуемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в `present`, объект настраивается на устройстве, а когда это значение установлено в `absent`, значение удаляется (при необходимости) с устройства.

Примечания

Примечание

Этот модуль должен выполняться локально, что можно достичь путем указания connection: local.
Пожалуйста, ознакомьтесь с руководством Infoblox Guide для получения более подробной информации о том, как использовать Infoblox с Ansible.

Примеры

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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается партнёром Ansible. [сертифицировано]

Авторы

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.8/modules/nios_network_module.html