Модуль infoblox.nios_modules.nios_network — настройка сетевого объекта Infoblox NIOS

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install infoblox.nios_modules. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: infoblox.nios_modules.nios_network.

Добавлено в infoblox.nios_modules 1.0.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

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

Требования

Следующие требования должны быть выполнены на узле, на котором выполняется этот модуль.

infoblox-client

Параметры

Параметр	Комментарии
comment string	Задает текстовый комментарий, связанный с экземпляром этого объекта. Указанная текстовая строка будет добавлена к экземпляру объекта.
container boolean	Если задано значение true, будет создан сетевой контейнер для добавления в систему или удаления из нее. Варианты: `false` `true`
extattrs dictionary	Позволяет настроить расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
logic_filter_rules list / elements=dictionary	Настраивает правила логического фильтра, применяемые к сетевому объекту. Этот аргумент принимает список правил логического фильтра (см. вложенные параметры). Если значение не указано, используется пустой список. По умолчанию: `[]`
filter string	Имя логического фильтра, применяемого к сетевому объекту.
type string	Тип логического фильтра, применяемого к сетевому объекту.
members list / elements=dictionary	Настраивает назначение участника Nios для указанного экземпляра сети. Этот аргумент принимает список имен участников (см. вложенные параметры). Если значение не указано, используется пустой список. Если для поля «container» задано значение true, это поле игнорируется. По умолчанию: `[]`
name string	Имя участника Nios, назначаемого этой сети.
network псевдонимы: name, cidr string / обязательный	Указывает сеть, которую нужно добавить в систему или удалить из нее. Значение должно быть задано в нотации CIDR.
network_view string	Задает имя сетевого представления, связанного с настраиваемым экземпляром. По умолчанию: `"default"`
options list / elements=dictionary	Настраивает набор параметров DHCP, включаемых в настраиваемый экземпляр сети. Этот аргумент принимает список значений (см. вложенные параметры). При настройке вложенных параметров необходимо указать как минимум один из параметров `name` или `num`. По умолчанию: `[]`
name string	Имя настраиваемого параметра DHCP. Стандартные параметры: `router`, `router-templates`, `domain-name-servers`, `domain-name`, `broadcast-address`, `broadcast-address-offset`, `dhcp-lease-time` и `dhcp6.name-servers`.
num integer	Номер настраиваемого параметра DHCP.
use_option boolean	Применимо только к некоторым параметрам (см. документацию по API NIOS). Варианты: `false` `true` ← (по умолчанию)
value string / обязательный	Значение параметра DHCP, указанного в `name`.
vendor_class string	Имя пространства, с которым связан этот параметр DHCP. По умолчанию: `"DHCP"`
provider dictionary	Объект dict со сведениями для подключения.
cert string	Указывает файл клиентского сертификата с дайджестом конфигурации x509 для дополнительной защиты соединения с удаленным экземпляром NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_CERT`.
host string	Указывает DNS-имя хоста или адрес для подключения к удаленному экземпляру NIOS WAPI по REST. Значение также можно задать с помощью переменной окружения `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте описание здесь. По умолчанию: `10`
http_pool_maxsize integer	Вставьте описание здесь. По умолчанию: `10`
http_request_timeout integer	Время ожидания ответа. Значение также можно задать с помощью переменной окружения `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key string	Указывает файл закрытого ключа для шифрования с помощью сертификата при подключении к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_KEY`.
max_results integer	Указывает максимальное количество возвращаемых объектов. Если задано отрицательное число, устройство вернет ошибку, когда количество возвращаемых объектов превысит это значение. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries integer	Задает количество попыток повтора до объявления соединения работоспособным. Значение также можно задать с помощью переменной окружения `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password string	Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание здесь. Варианты: `false` `true` ← (по умолчанию)
username string	Задает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной окружения `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify boolean	Логическое значение, включающее или отключающее проверку сертификатов SSL. Значение также можно задать с помощью переменной окружения `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Указывает версию WAPI, которую следует использовать. Значение также можно задать с помощью переменной окружения `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версией WAPI по умолчанию была 1.4. По умолчанию: `"2.12.3"`
state string	Задает требуемое состояние экземпляра объекта на сервере NIOS. Если задано значение `present`, объект настраивается на устройстве; если задано значение `absent`, объект удаляется с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`
template string	Если параметр задан при создании, сеть создается согласно значениям, указанным в выбранном шаблоне.
use_logic_filter_rules boolean	Если задано значение true, список логических фильтров, примененный на вышестоящем уровне, будет переопределен. Варианты: `false` ← (по умолчанию) `true`
vlans list / elements=dictionary	Настраивает набор VLAN, включаемых в настраиваемый экземпляр сети. Этот аргумент принимает список значений (см. вложенные параметры). При настройке вложенных параметров необходимо указать как минимум один из параметров `name` или `id`. По умолчанию: `[]`
id integer	Идентификатор VLAN.
name string	Имя VLAN.
parent string	Имя родительского vlanview или vlanrange. По умолчанию: `"default"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль необходимо запускать локально. Для этого можно указать connection: local.
Подробные сведения об использовании Infoblox с Ansible см. в руководстве :ref:`nios_guide`.

Примеры

- name: Configure a network ipv4
  infoblox.nios_modules.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
  infoblox.nios_modules.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: Create network with member assignment for a network ipv4
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    comment: This is a test comment
    members:
      - name: member1.infoblox
      - name: member2.infoblox
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove member assignment form ipv4 network
  infoblox.nios_modules.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 ipv4
  infoblox.nios_modules.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: Set filters for a network ipv4
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    comment: this is a test comment
    use_logic_filter_rules: true
    logic_filter_rules:
      - filter: PXE-UEFI
        type: Option
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a network ipv4
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Configure an ipv4 network container
  infoblox.nios_modules.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 an ipv6 network container
  infoblox.nios_modules.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 an ipv4 network container
  infoblox.nios_modules.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

- name: Configure a network ipv4 and assign vlans
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    comment: this is a test comment
    vlans:
     - name: ansiblevlan
       parent: ansiblevlanview
       id: 10
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Peter Sprygada (@privateip)
Matthew Dennett (@matthewdennett)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/infoblox/nios_modules/nios_network_module.html