Модуль infoblox.nios_modules.nios_vlan — настройка VLAN 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_vlan.

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

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

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

Добавляет и/или удаляет экземпляры объектов vlan на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS vlan с помощью интерфейса Infoblox WAPI через REST.
Обновляет экземпляры объектов vlan на серверах Infoblox NIOS.

Требования

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

infoblox-client

Параметры

Параметр	Комментарии
comment string	Задает текстовый комментарий, связанный с экземпляром этого объекта. Указанный текст будет добавлен к экземпляру объекта. По умолчанию: `""`
contact string	Контактные данные лица или команды, управляющих VLAN или использующих ее. По умолчанию: `""`
department string	Отдел, в котором используется VLAN. По умолчанию: `""`
description string	Описание объекта VLAN, которое можно использовать для более длинных имен VLAN. По умолчанию: `""`
extattrs dictionary	Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
id integer / обязательный	Задает идентификатор VLAN, которую нужно добавить в систему или удалить из нее.
name string / обязательный	Задает имя VLAN, которую нужно добавить в систему или удалить из нее.
parent string	Задает родительскую VLAN, которую нужно добавить в систему или удалить из нее. Это может быть имя `vlanview` или `vlanrange`. Необходимый объект _ref извлекается автоматически. Если параметр не указан, по умолчанию используется представление VLAN `default`. По умолчанию: `"default"`
provider dictionary	Словарь с данными для подключения.
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"`
reserved boolean	Если параметр включен, VLAN можно назначить объекту IPAM только вручную. Варианты: `false` ← (по умолчанию) `true`
state string	Задает требуемое состояние экземпляра объекта на сервере NIOS. Если указано значение `present`, объект настраивается на устройстве; если указано значение `absent`, объект удаляется с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

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

Примеры

- name: Create a new vlan
  infoblox.nios_modules.nios_vlan:
    name: ansible
    id: 10
    parent: my_vlanview
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update the comment for a vlan
  infoblox.nios_modules.nios_vlan:
    name: ansible
    id: 10
    parent: my_vlanview
    comment: this is an example comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove the vlan
  infoblox.nios_modules.nios_vlan:
    name: ansible
    id: 10
    parent: my_vlanview
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update an existing vlan
  infoblox.nios_modules.nios_vlan:
    name: {new_name: ansible-new, old_name: ansible}
    id: 10
    parent: my_vlanview
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create vlan with extensible attributes
  infoblox.nios_modules.nios_vlan:
    name: ansible
    id: 11
    parent: my_vlanview
    comment: "this is an example comment"
    contact: "itlab@email.com"
    department: "IT"
    description: "test"
    reserved: True
    extattrs:
      Site: "HQ"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create a new vlan with next available id
  infoblox.nios_modules.nios_vlan:
    name: ansible-vlan
    id: "{{
        lookup('infoblox.nios_modules.nios_next_vlan_id',
          parent='my_vlanrange',
          exclude=[1,2],
          provider=nios_provider)[0]
        }}"
    parent: my_vlanrange
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Christoph Spatt (@edeka-spatt)

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

© 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_vlan_module.html