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

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: netapp.ontap.na_ontap_ports.

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

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Добавление или удаление портов для домена широковещательной передачи и набора портов.

Требования

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

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 или новее

Параметры

Параметр	Комментарии
cert_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
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 строка	Укажите требуемый ipspace для области широковещательной передачи. Пространство имён ipspace домена не может быть изменено после создания домена.
key_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу закрытого ключа SSL-клиента.
names список / элементы=строка / обязательно	Список портов.
ontapi целое число	Версия ontap api, которую следует использовать
password псевдонимы: pass строка	Пароль для указанного пользователя.
portset_type строка	Протоколы, принимаемые для portset. Варианты: `"fcp"` `"iscsi"` `"mixed"`
resource_name строка / обязательно	имя portset или области широковещательной передачи.
resource_type строка / обязательно	тип ресурса, к которому добавляется или из которого удаляется порт. для добавления или удаления портов в portset требуется версия ONTAP 9.9 или выше в REST Варианты: `"broadcast_domain"` `"portset"`
state строка	Добавить или удалить указанный порт. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_rest строка	Использовать REST или ZAPI. always – всегда использовать REST API, если модуль его поддерживает. Выдаётся предупреждение, если модуль не поддерживает REST. Выдаётся ошибка, если опция модуля не поддерживается в REST. never – всегда использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если опция REST не поддерживается в ZAPI. auto – попытаться использовать REST API, если модуль его поддерживает и опции модулей поддерживаются. В противном случае использовать ZAPI. По умолчанию: `"auto"`
username псевдонимы: user строка	Это может быть учётная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Для получения дополнительной информации прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации аутентификация по паролю, используя имя пользователя и пароль, аутентификация по SSL-сертификату, используя файл SSL-сертификата клиента и необязательно файл закрытого ключа. Для использования сертификата он должен быть установлен в кластер ONTAP, и должна быть включена аутентификация по сертификатам.

validate_certs

boolean

Если установлено значение no, сертификаты SSL не будут проверены.

Это значение должно быть установлено только для сайтов, управляемых самостоятельно, использующих самоподписанные сертификаты.

Варианты:

false
true ← (по умолчанию)

vserver

string

Имя SVM.

Укажите этот параметр при работе с набором портов.

Примечания

Примечание

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

Примеры

- name: broadcast domain remove port
  tags:
  - remove
  netapp.ontap.na_ontap_ports:
    state: absent
    names: test-vsim1:e0d-1,test-vsim1:e0d-2
    resource_type: broadcast_domain
    resource_name: ansible_domain
    hostname: "{{ hostname }}"
    username: user
    password: password
    https: False

- name: broadcast domain add port
  tags:
  - add
  netapp.ontap.na_ontap_ports:
    state: present
    names: test-vsim1:e0d-1,test-vsim1:e0d-2
    resource_type: broadcast_domain
    resource_name: ansible_domain
    ipspace: Default
    hostname: "{{ hostname }}"
    username: user
    password: password
    https: False

- name: portset remove port
  tags:
  - remove
  netapp.ontap.na_ontap_ports:
    state: absent
    names: lif_2
    resource_type: portset
    resource_name: portset_1
    vserver: "{{ vserver }}"
    hostname: "{{ hostname }}"
    username: user
    password: password
    https: False

- name: portset add port
  tags:
  - add
  netapp.ontap.na_ontap_ports:
    state: present
    names: lif_2
    resource_type: portset
    resource_name: portset_1
    portset_type: iscsi
    vserver: "{{ vserver }}"
    hostname: "{{ hostname }}"
    username: user
    password: password
    https: False

Авторы

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