netapp.ontap.na_ontap_portset – NetApp ONTAP Создание/удаление набора портов
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в playbook, укажите: netapp.ontap.na_ontap_portset.
Новое в версии 2.8.0: от netapp.ontap
Обзор
- Создание/удаление набора портов ONTAP, изменение портов в наборе портов.
- Изменение типа (протокола) в ONTAP не поддерживается.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и выше.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Ansible 2.6
- Сильно рекомендуется Ansible 2.9 или более поздней версии, так как она включает новую систему доставки коллекций.
- Python2 netapp-lib (2017.10.30) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает лучшую отчетность об ошибках при подключении.
- Для включения http в кластере необходимо выполнить следующие команды ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cert_filepath строка добавлено в 20.6.0 netapp.ontap | путь к файлу сертификата SSL клиента (.pem). не поддерживается с python 2.6. | |
| feature_flags словарь добавлено в 20.5.0 netapp.ontap | Включить или отключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| force логическое |
| Если 'false' или не указано, запрос завершится ошибкой, если к этому портовому набору привязаны какие-либо igroups. Если 'true', принудительно уничтожить портовый набор, даже если существуют привязки igroups. |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Заменить порт по умолчанию (80 или 443) на указанный порт | |
| https логическое |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по сертификату SSL, так как она требует SSL. |
| key_filepath строка добавлено в 20.6.0 netapp.ontap | путь к файлу ключа SSL клиента. | |
| name строка / обязательно | Имя набора портов для создания. | |
| ontapi целое число | Используемая версия API ontap | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| ports список / элементы=строка | Укажите порты, связанные с этим портовым набором. Должны быть разделены запятыми. Представляет ожидаемое состояние списка портов в любое время и заменяет текущее значение портов. Добавляет порт, если он указан в ожидаемом состоянии, но не в текущем. Удаляет порт, если он находится в текущем состоянии, но не в ожидаемом. | |
| state строка | Значение по умолчанию: "present" | Если требуется создать портовый набор. |
| type строка |
| Обязательно для создания. Протоколы, принимаемые этим портовым набором. |
| use_rest строка | Значение по умолчанию: "auto" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае будет переключено на ZAPI. always -- всегда использовать REST API never -- всегда использовать ZAPI auto -- попробовать использовать REST API |
| username строка | Это может быть учетная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. базовая аутентификация, используя имя пользователя и пароль, 2. аутентификация по сертификату SSL, используя файл сертификата SSL клиента и, необязательно, файл закрытого ключа. Для использования сертификата, сертификат должен быть установлен в кластер ONTAP, и должна быть включена аутентификация по сертификату. псевдонимы: user | |
| validate_certs логическое |
| Если установлено в no, сертификаты SSL не будут проверены.Это следует устанавливать только в False для сайтов, контролируемых лично, используя самозаверяющие сертификаты. |
| vserver строка / обязательно | Имя SVM. |
Примечания
Примечание
- Модули, префикс которых na\_ontap, разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create Portset
na_ontap_portset:
state: present
vserver: vserver_name
name: portset_name
ports: a1
type: "{{ protocol type }}"
username: "{{ netapp username }}"
password: "{{ netapp password }}"
hostname: "{{ netapp hostname }}"
- name: Modify ports in portset
na_ontap_portset:
state: present
vserver: vserver_name
name: portset_name
ports: a1,a2
username: "{{ netapp username }}"
password: "{{ netapp password }}"
hostname: "{{ netapp hostname }}"
- name: Delete Portset
na_ontap_portset:
state: absent
vserver: vserver_name
name: portset_name
force: True
type: "{{ protocol type }}"
username: "{{ netapp username }}"
password: "{{ netapp password }}"
hostname: "{{ netapp hostname }}"
Авторы
- Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/netapp/ontap/na_ontap_portset_module.html
