Модуль netapp.ontap.na_ontap_net_vlan – Сеть NetApp ONTAP VLAN

Примечание

Этот модуль является частью коллекции netapp.ontap (версия 22.12.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 или более поздняя.
При использовании ZAPI требуется netapp-lib 2018.11.13 или более поздняя версия (установите с помощью ‘pip install netapp-lib’), настоятельно рекомендуется netapp-lib 2020.3.12, так как она обеспечивает более подробное сообщение об ошибках при подключении.
Физическая или виртуальная кластерная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и более поздние версии, поддержка REST требует ONTAP 9.6 или более поздней версии

Параметры

Параметр	Комментарии
broadcast_domain строка добавлен в netapp.ontap 21.13.0	Укажите имя broadcast_domain. Поддерживается только с REST и игнорируется с ZAPI. Требуется с 9.6 и 9.7, но необязательно с 9.8 или более поздней версии.
cert_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
enabled логическое значение добавлен в netapp.ontap 21.13.0	Включить/выключить Net vlan. Поддерживается только с REST и игнорируется с ZAPI. Варианты: `false` `true`
feature_flags словарь добавлен в netapp.ontap 20.5.0	Включить или выключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version строка добавлен в 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 строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить порт по умолчанию (80 или 443) на указанный порт
https логическое значение	Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL. Варианты: `false` ← (по умолчанию) `true`
ipspace строка добавлен в netapp.ontap 21.13.0	Укажите ipspace для broadcast domain. Поддерживается только с REST и игнорируется с ZAPI. Требуется с 9.6 и 9.7, но необязательно с 9.8 или более поздней версии.
key_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу ключа SSL-клиента.
node строка / обязательно	Имя узла интерфейса VLAN.
ontapi целое число	Версия API ontap для использования
parent_interface строка / обязательно	Интерфейс, который содержит VLAN-интерфейс.
password псевдонимы: pass строка	Пароль для указанного пользователя.
state строка	Существует ли указанный сетевой VLAN или нет Варианты: `"present"` ← (по умолчанию) `"absent"`
use_rest строка	Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль поддерживает REST. Выводится предупреждение, если модуль не поддерживает REST. Выдается ошибка, если опция модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Может быть выдана ошибка, если опция REST не поддерживается в ZAPI. auto – попытается использовать REST API, если модуль поддерживает REST и опции модулей поддерживаются. В противном случае возвращается к ZAPI. По умолчанию: `"auto"`
username псевдонимы: user строка	Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительную информацию см. в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации аутентификация по протоколу basic, используя имя пользователя и пароль, аутентификация по SSL-сертификату, используя файл ssl-сертификата клиента и, необязательно, файл закрытого ключа. Для использования сертификата он должен быть установлен в кластер ONTAP, и должна быть включена аутентификация по сертификату.

validate_certs boolean	Если установлено в `no`, сертификаты SSL не будут проверены. Это следует устанавливать только в `False` используемых на сайтах с собственными сертификатами, контролируемыми лично. Варианты: `false` `true` ← (по умолчанию)
vlanid целое число / обязательно	Идентификатор VLAN. Диапазон от 1 до 4094.

Примечания

Примечание

Опция interface_name была удалена и должна быть удалена из playbooks.
Модули с префиксом 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/ontap/na_ontap_net_vlan_module.html