infoblox.nios_modules.nios_network модуль — Настройка объекта сети Infoblox NIOS

Примечание

Этот модуль является частью коллекции infoblox.nios_modules (версия 1.7.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 на серверах NIOS с использованием интерфейса Infoblox WAPI по протоколу REST.
Поддерживает протоколы IPV4 и IPV6.

Требования

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

infoblox-client

Параметры

Параметр	Комментарии
comment строка	Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная строка текста будет настроена на экземпляре объекта.
container логическое значение	Если установлено в значение true, создаст контейнер сети для добавления или удаления из системы. Варианты: `false` `true`
extattrs словарь	Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
logic_filter_rules список / элементы=словарь	Настраивает правила логического фильтра, которые будут применяться к объекту сети. Этот аргумент принимает список правил логического фильтра (см. подварианты). При отсутствии аргумента используется значение по умолчанию — пустой список. Значение по умолчанию: `[]`
filter строка	Имя логического фильтра, который нужно применить к объекту сети.
type строка	Тип логического фильтра, который нужно применить к объекту сети.
members список / элементы=словарь	Настраивает назначение членов Nios для настроенного экземпляра сети. Этот аргумент принимает список имен членов (см. подварианты). При отсутствии аргумента используется значение по умолчанию — пустой список. Если поле ‘container’ установлено в значение true, это поле игнорируется. Значение по умолчанию: `[]`
name строка	Имя члена Nios, который должен быть назначен этой сети.
network псевдонимы: name, cidr строка / обязательно	Указывает сеть для добавления или удаления из системы. Значение должно быть в формате 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 логическое значение	Применяется только к подмножеству параметров (см. документацию API NIOS) Варианты: `false` `true` ← (по умолчанию)
value строка / обязательно	Значение DHCP-параметра, указанного `name`
vendor_class строка	Имя пространства, к которому относится этот DHCP-параметр Значение по умолчанию: `"DHCP"`
provider словарь	Объект словаря, содержащий данные подключения.
cert строка	Указывает файл клиентского сертификата с дайджестом конфигурации x509 для дополнительного уровня защищённого соединения с удалённым экземпляром NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_CERT`.
host строка	Указывает имя хоста DNS или адрес для подключения к удалённому экземпляру NIOS WAPI через REST. Значение также можно указать с помощью переменной среды `INFOBLOX_HOST`.
http_pool_connections целое число	Вставьте описание сюда Значение по умолчанию: `10`

http_pool_maxsize целое число	Вставьте описание здесь По умолчанию: `10`
http_request_timeout целое число	Время ожидания ответа Значение также можно указать с помощью переменной окружения `INFOBLOX_HTTP_REQUEST_TIMEOUT` По умолчанию: `10`
key строка	Указывает файл с закрытым ключом для шифрования с помощью сертификата для подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной окружения `INFOBLOX_KEY`
max_results целое число	Указывает максимальное количество возвращаемых объектов. Если задано отрицательное значение, прибор вернет ошибку, если количество возвращаемых объектов превысит это значение. Значение также можно указать с помощью переменной окружения `INFOBLOX_MAX_RESULTS` По умолчанию: `1000`
max_retries целое число	Настраивает количество попыток повторного подключения, прежде чем соединение будет признано пригодным. Значение также можно указать с помощью переменной окружения `INFOBLOX_MAX_RETRIES` По умолчанию: `3`
password строка	Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной окружения `INFOBLOX_PASSWORD`
silent_ssl_warnings логическое значение	Вставьте описание здесь Варианты: `false` `true` ← (по умолчанию)
username строка	Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной окружения `INFOBLOX_USERNAME`
validate_certs псевдонимы: ssl_verify логическое значение	Логическое значение для включения или отключения проверки SSL-сертификатов Значение также можно указать с помощью переменной окружения `INFOBLOX_SSL_VERIFY` Варианты: `false` ← (по умолчанию) `true`
wapi_version строка	Указывает используемую версию WAPI Значение также можно указать с помощью переменной окружения `INFOBLOX_WAPI_VERSION` До Ansible 2.8 по умолчанию использовалась версия WAPI 1.4 По умолчанию: `"2.12.3"`
state строка	Указывает желаемое состояние экземпляра объекта на сервере NIOS. При значении `present` объект настраивается на устройстве, а при значении `absent` значение удаляется (при необходимости) с устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`
template строка	При создании сеть создается в соответствии со значениями, указанными в выбранном шаблоне.
use_logic_filter_rules логическое значение	Если установлено в значение true, это переопределит список логических фильтров, примененный на верхнем уровне. Варианты: `false` ← (по умолчанию) `true`

Примечания

Примечание

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

Примеры

- 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

Авторы

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

Ссылки на сборки

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