Модуль netapp.ontap.na_ontap_net_vlan — сетевой VLAN NetApp ONTAP

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).

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

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

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_net_vlan.

Добавлено в netapp.ontap 2.6.0

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

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

Создание, изменение и удаление сетевого VLAN
Изменение VLAN поддерживается только через REST
Параметры broadcast_domain, ipspace и enabled поддерживаются через REST и игнорируются при использовании ZAPI

Требования

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

Ansible 2.9 или более поздней версии — рекомендуется версия 2.12 или более поздняя.
Python3 — рекомендуется версия 3.9 или более поздняя.
netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib устарела и больше не поддерживается. Используйте ее на свой страх и риск.
Физическая или виртуальная кластерная система Data ONTAP; модули поддерживают Data ONTAP 9.1 и более поздние версии, для поддержки REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр	Комментарии
broadcast_domain string добавлено в netapp.ontap 21.13.0	Укажите имя broadcast_domain. Поддерживается только через REST и игнорируется при использовании ZAPI. Обязательный параметр для версий 9.6 и 9.7, необязательный — для версии 9.8 и более поздних.
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
enabled boolean добавлено в netapp.ontap 21.13.0	Включение или отключение сетевого VLAN. Поддерживается только через REST и игнорируется при использовании ZAPI. Варианты: `false` `true`
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version string добавлено в netapp.ontap 21.23.0	Переопределяет версию ONTAP кластера при использовании REST. Если указанная версия не соответствует целевому кластеру, поведение не определено. Параметр предназначен для обхода проблемы, возникающей, когда версию кластера не удается прочитать из-за ограничений разрешений. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Версия должна иметь формат 9.10 или 9.10.1, где каждый элемент является целым числом. Если для `use_rest` задано значение auto, этот параметр может принудительно переключить модуль на ZAPI с учетом версии и возможностей платформы. Игнорируется при использовании ZAPI.
hostname string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределяет стандартный порт (80 или 443), используя указанный порт.
https boolean	Включение и отключение HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации с сертификатом SSL, так как для нее требуется SSL. Варианты: `false` ← (по умолчанию) `true`
ipspace string добавлено в netapp.ontap 21.13.0	Укажите ipspace для домена широковещательной рассылки. Поддерживается только через REST и игнорируется при использовании ZAPI. Обязательный параметр для версий 9.6 и 9.7, необязательный — для версии 9.8 и более поздних.
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
node string / обязательный	Имя узла интерфейса VLAN.
ontapi integer	Версия API ONTAP, которую следует использовать.
parent_interface string / обязательный	Интерфейс, на котором размещен интерфейс VLAN.
password псевдонимы: pass string	Пароль указанного пользователя.
state string	Определяет, должен ли указанный сетевой VLAN существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda boolean добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать прокси-функциональность AWS Lambda для подключения к системе ONTAP. Поддерживается только через REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Определяет, использовать REST или ZAPI. always — всегда используется REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выводится предупреждение. Если параметр модуля не поддерживается в REST, возникает ошибка. never — всегда используется ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может возникнуть ошибка. auto — выполняется попытка использовать REST API, если модуль его поддерживает и поддерживаются параметры модуля. В противном случае используется ZAPI. По умолчанию: `"always"`
username псевдонимы: user string	Учетная запись может иметь область действия кластера или SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM. Подробнее см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью сертификата SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация с помощью сертификата должна быть включена.
validate_certs boolean	Если задано значение `no`, сертификаты SSL проверяться не будут. Значение `False` следует задавать только для контролируемых вами систем, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vlanid integer / обязательный	Идентификатор VLAN. Допустимый диапазон — от 1 до 4094.

Примечания

Примечание

Параметр interface_name удален; его следует удалить из плейбуков.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включен по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create VLAN
  netapp.ontap.na_ontap_net_vlan:
    state: present
    vlanid: 13
    node: "{{ vlan_node }}"
    ipspace: "{{ ipspace_name }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Create and add vlan to broadcast domain - REST
  netapp.ontap.na_ontap_net_vlan:
    state: present
    vlanid: 14
    node: "{{ vlan_node }}"
    parent_interface: "{{ vlan_parent_interface_name }}"
    broadcast_domain: "{{ broadcast_domain_name }}"
    ipspace: "{{ ipspace_name }}"
    enabled: true
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Disable VLAN - REST
  netapp.ontap.na_ontap_net_vlan:
    state: present
    vlanid: 14
    node: "{{ vlan_node }}"
    parent_interface: "{{ vlan_parent_interface_name }}"
    enabled: false
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Delete VLAN
  netapp.ontap.na_ontap_net_vlan:
    state: absent
    vlanid: 14
    node: "{{ vlan_node }}"
    parent_interface: "{{ vlan_parent_interface_name }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

Авторы

Команда NetApp Ansible (@carchi8py)

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

© 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/netapp/ontap/na_ontap_net_vlan_module.html