nios_network - Настройка сетевого объекта Infoblox NIOS
Новая версия 2.5.
Обзор
- Добавляет и/или удаляет экземпляры сетевых объектов с серверов Infoblox NIOS. Этот модуль управляет объектами NIOS
networkс использованием интерфейса Infoblox WAPI по протоколу REST.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- infoblox_client
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| comment | Значение по умолчанию: Нет | Настраивает строку комментария, которая будет ассоциирована с экземпляром этого объекта. Предоставленная строка будет настроена для экземпляра объекта. | |
| extattrs | Значение по умолчанию: Нет | Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар "ключ/значение" для настройки. | |
| network обязательно | Значение по умолчанию: Нет | Указывает сеть для добавления или удаления из системы. Значение должно использовать нотацию CIDR. псевдонимы: name, cidr | |
| network_view обязательно | Значение по умолчанию: default | Настраивает имя представления сети, которое следует ассоциировать с этим экземпляром. | |
| options | Значение по умолчанию: Нет | Настраивает набор DHCP-опций, которые следует включить в составе настроенного экземпляра сети. Этот аргумент принимает список значений (см. подопции). При настройке подопций необходимо указать хотя бы одно из значений name или num. | |
| vendor_class | Значение по умолчанию: DHCP | Имя пространства, к которому связана эта DHCP-опция | |
| num | Номер DHCP-опции для настройки | ||
| name | Значение по умолчанию: Нет | Имя DHCP-опции для настройки | |
| value обязательно | Значение по умолчанию: Нет | Значение DHCP-опции, указанной в name
| |
| use_option |
| Применяется только к подмножеству опций (см. документацию API NIOS) | |
| provider | Значение по умолчанию: Нет | Объект типа dict, содержащий данные подключения. | |
| username | Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать, используя переменную среды INFOBLOX_USERNAME. | ||
| http_request_timeout | Значение по умолчанию: 10 | Время ожидания ответа. Значение также можно указать, используя переменную среды INFOBLOX_HTTP_REQUEST_TIMEOUT. | |
| max_retries | Значение по умолчанию: 3 | Настраивает количество попыток повторного подключения до того, как соединение будет признано рабочим. Значение также можно указать, используя переменную среды INFOBLOX_MAX_RETRIES. | |
| wapi_version | Значение по умолчанию: 1.4 | Указывает используемую версию WAPI Значение также можно указать, используя переменную среды INFOBLOX_WAP_VERSION. | |
| ssl_verify | Значение по умолчанию: нет | Логическое значение для включения или выключения проверки сертификатов SSL Значение также можно указать, используя переменную среды INFOBLOX_SSL_VERIFY. | |
| max_results | Значение по умолчанию: 1000 | Устанавливает максимальное количество возвращаемых объектов. Если значение отрицательное, при превышении этого значения приложение вернёт ошибку. Значение также можно указать, используя переменную среды INFOBLOX_MAX_RESULTS. | |
| host обязательно | Указывает имя хоста DNS или адрес для подключения к удалённому экземпляру NIOS WAPI по протоколу REST Значение также можно указать, используя переменную среды INFOBLOX_HOST. | ||
| password | Значение по умолчанию: Нет | Указывает пароль для аутентификации подключения к удалённому экземпляру NIOS. Значение также можно указать, используя переменную среды INFOBLOX_PASSWORD. | |
| state |
| Настраивает желаемое состояние экземпляра объекта на сервере NIOS. При значении present, объект настраивается на устройстве, а при значении absent, значение удаляется (при необходимости) с устройства. | |
Примечания
Примечание
- Этот модуль должен выполняться локально, что можно сделать, указав
connection: local.
Примеры
- name: configure a network
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: set dhcp options for a network
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
nios_network:
network: 192.168.10.0/24
state: absent
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Автор
- Пётр Спрыгада (@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.5/modules/nios_network_module.html