Модуль netapp.ontap.na_ontap_nvme_subsystem — управление подсистемой NVMe NetApp ONTAP

Примечание

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

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

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

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

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

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

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

Создание и удаление подсистемы NVMe
Связывание (изменение) узла с подсистемой NVMe или сопоставление с ней
В качестве предварительного требования в vserver с данными должна существовать служба NVMe с протоколом NVMe

Требования

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

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 string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Этот параметр можно использовать, чтобы включить экспериментальную функцию или отключить новую функцию, нарушающую обратную совместимость. Поддерживаемые ключи и значения могут измениться без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version string добавлено в 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 string / обязательный	Имя узла или IP-адрес экземпляра ONTAP.
hosts list / elements=string	Список NQN узлов (NVMe Qualification Name), связанных с контроллером.
http_port integer	Переопределяет порт по умолчанию (80 или 443).
https boolean	Включает и отключает HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации с помощью сертификата SSL, так как для нее требуется SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
ontapi integer	Версия API ONTAP, которую следует использовать.
ostype string	Указывает тип ОС для инициаторов. Варианты: `"windows"` `"linux"` `"vmware"` `"xen"` `"hyper_v"`
password псевдонимы: pass string	Пароль указанного пользователя.
paths list / elements=string	Список путей к пространствам имен, которые необходимо связать с подсистемой. Для систем ASA r2 пути должны соответствовать формату <name>[@<snapshot-name>].
skip_host_check boolean	Пропустить проверку узла. Требуется для удаления подсистемы NVMe с подключенными пространствами имен NVMe. Варианты: `false` ← (по умолчанию) `true`
skip_mapped_check boolean	Пропустить проверку сопоставленных пространств имен. Требуется для удаления подсистемы NVMe с подключенными пространствами имен NVMe. Варианты: `false` ← (по умолчанию) `true`
state string	Определяет, должна ли указанная подсистема существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
subsystem string / обязательный	Указывает подсистему.
use_lambda boolean добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать прокси-функцию AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — использовать REST API, если модуль его поддерживает и параметры модуля поддерживаются. В противном случае выполняется переход на ZAPI. По умолчанию: `"always"`
username псевдонимы: user string	Это может быть учетная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации. Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью сертификата SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.
validate_certs boolean	Если задано значение `no`, сертификаты SSL не проверяются. Значение `False` следует задавать только на сайтах под вашим контролем, где используются самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vserver string / обязательный	Имя используемого vserver.

Примечания

Примечание

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

Примеры

- name: Create NVME Subsystem
  netapp.ontap.na_ontap_nvme_subsystem:
    state: present
    subsystem: test_sub
    vserver: test_dest
    ostype: linux
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete NVME Subsystem
  netapp.ontap.na_ontap_nvme_subsystem:
    state: absent
    subsystem: test_sub
    vserver: test_dest
    skip_host_check: true
    skip_mapped_check: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Associate NVME Subsystem host/map
  netapp.ontap.na_ontap_nvme_subsystem:
    state: present
    subsystem: "{{ subsystem }}"
    ostype: linux
    hosts: nqn.1992-08.com.netapp:sn.3017cfc1e2ba11e89c55005056b36338:subsystem.ansible
    paths: /vol/ansible/test,/vol/ansible/test1
    vserver: "{{ vserver }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify NVME subsystem map
  netapp.ontap.na_ontap_nvme_subsystem:
    state: present
    subsystem: test_sub
    vserver: test_dest
    skip_host_check: true
    skip_mapped_check: true
    paths: /vol/ansible/test
    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_nvme_subsystem_module.html