Модуль netapp.ontap.na_ontap_portset — создание/удаление набора портов NetApp ONTAP

Примечание

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

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

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

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

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

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

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

Создание/удаление набора портов ONTAP, изменение портов в наборе портов.
Изменение типа (протокола) в ONTAP не поддерживается.

Требования

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

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 или более поздняя версия.

Параметры

Параметр	Комментарии
cert_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата SSL-клиента (.pem). Не поддерживается в Python 2.6.
feature_flags словарь добавлено в netapp.ontap 20.5.0	Включает или отключает новую функцию. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут измениться без предварительного уведомления. Неизвестные ключи игнорируются.
force логическое значение	Если значение — «false» или не указано, запрос завершится ошибкой, если с этим набором портов связаны какие-либо igroup. Если значение — «true», набор портов будет принудительно удалён, даже если существуют привязки igroup. Варианты: `false` ← (по умолчанию) `true`
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`
key_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу ключа SSL-клиента.
name строка / обязательный	Имя создаваемого набора портов.
ontapi целое число	Версия API ONTAP, которую следует использовать.
password псевдонимы: pass строка	Пароль указанного пользователя.
ports список / элементы=строки	Укажите порты, связанные с этим набором портов. Значения следует разделять запятыми. Параметр задаёт ожидаемое состояние списка портов и в любой момент заменяет текущее значение ports. Добавляет порт, если он указан в ожидаемом состоянии, но отсутствует в текущем. Удаляет порт, если он есть в текущем состоянии, но отсутствует в ожидаемом.
state строка	Указывает, требуется ли создать набор портов. По умолчанию: `"present"`
type строка	Обязателен для создания с помощью ZAPI. При создании через REST, если значение не указано, используется значение mixed. Протоколы, принимаемые этим набором портов. Варианты: `"fcp"` `"iscsi"` `"mixed"`
use_lambda логическое значение добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать функциональность прокси-сервера AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest строка	Определяет, следует ли использовать REST или ZAPI. always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выдаётся предупреждение. Если параметр модуля не поддерживается в REST, выдаётся ошибка. never — всегда использовать ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — пытаться использовать REST API, если модуль его поддерживает и параметры модуля доступны. В противном случае используется ZAPI. По умолчанию: `"always"`
username псевдонимы: user строка	Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительную информацию см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью SSL-сертификата с использованием файла сертификата SSL-клиента и, при необходимости, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.
validate_certs логическое значение	Если задано значение `no`, сертификаты SSL не будут проверяться. Задавайте это значение только для использования на лично контролируемых сайтах с самоподписанными сертификатами: `False`. Варианты: `false` `true` ← (по умолчанию)
vserver строка / обязательный	Имя SVM.

Примечания

Примечание

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

Примеры

- name: Create Portset
  netapp.ontap.na_ontap_portset:
    state: present
    vserver: vserver_name
    name: portset_name
    ports: a1
    type: "{{ protocol type }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify ports in portset
  netapp.ontap.na_ontap_portset:
    state: present
    vserver: vserver_name
    name: portset_name
    ports: a1,a2
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete Portset
  netapp.ontap.na_ontap_portset:
    state: absent
    vserver: vserver_name
    name: portset_name
    force: true
    type: "{{ protocol type }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

Команда 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_portset_module.html