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

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 22.12.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 или более поздняя версия.
При использовании 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 или более поздней версии

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
cert_filepath строка добавлено в netapp.ontap 20.6.0	путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
feature_flags словарь добавлено в netapp.ontap 20.5.0	Включить или отключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.
force булево	Если ‘false’ или не указано, запрос завершится ошибкой, если к этому набору портов привязаны какие-либо группы igroups. Если ‘true’, принудительно уничтожить набор портов, даже если существуют привязки к группам igroups. Варианты: `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 список / элементы=строка	Укажите порты, связанные с этим набором портов. Должны быть разделены запятыми. Представляет ожидаемое состояние списка портов в любое время и заменяет текущее значение портов. Добавляет порт, если он указан в ожидаемом состоянии, но не в текущем состоянии. Удаляет порт, если он находится в текущем состоянии, но не в ожидаемом состоянии.
state строка	Если вы хотите создать набор портов. По умолчанию: `"present"`
type строка	Требуется для создания в ZAPI. Значение по умолчанию — mixed, если не указано во время создания в REST. Протоколы, принимаемые для этого набора портов. Варианты: `"fcp"` `"iscsi"` `"mixed"`
use_rest строка	Использовать REST или ZAPI. всегда — всегда будет использовать REST API, если модуль поддерживает REST. Выводится предупреждение, если модуль не поддерживает REST. Возникает ошибка, если опция модуля не поддерживается в REST. никогда — всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Возможна ошибка, если опция REST не поддерживается в ZAPI. авто — попытается использовать REST API, если модуль поддерживает REST и опции модуля поддерживаются. В противном случае переходит к ZAPI. По умолчанию: `"auto"`
username псевдонимы: user строка	Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации базовая аутентификация, используя имя пользователя и пароль, аутентификация по SSL-сертификату, используя файл SSL-сертификата клиента и, необязательно, файл закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а также должна быть включена аутентификация по сертификату.
validate_certs булево	Если установлено `no`, SSL-сертификаты не будут проверены. Это следует установить только в `False` на сайтах, находящихся под личным контролем, использующих самозаверяющие сертификаты. Варианты: `false` `true` ← (по умолчанию)

vserver

string / обязательно

Имя 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 }}"
    username: "{{ netapp username }}"
    password: "{{ netapp password }}"
    hostname: "{{ netapp hostname }}"

- name: Modify ports in portset
  netapp.ontap.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
  netapp.ontap.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)

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

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