модуль netapp.ontap.na_ontap_nvme_namespace — управление пространством имен 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_namespace.

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

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

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

Создание/удаление пространства имен 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 или более поздняя версия.

Параметры

Параметр	Комментарии
block_size целое число добавлено в netapp.ontap 20.5.0	Размер логического блока в байтах. Возможные значения: 512 (Data ONTAP 9.6 и более поздние версии), 4096. Значение по умолчанию — 4096. Варианты: `512` `4096`
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`
key_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
ontapi целое число	Используемая версия API ONTAP
ostype строка	Указывает тип ОС для инициаторов Варианты: `"windows"` `"linux"` `"vmware"` `"xen"` `"hyper_v"`
password псевдонимы: pass строка	Пароль указанного пользователя.
path строка / обязательный	Путь к пространству имен. Имя пространства имен NVMe. Имена пространств имен NVMe представляют собой пути формата «/vol/<volume>[/<qtree>]/<namespace>», где имя qtree является необязательным. Для систем ASA r2 путь должен соответствовать формату <name>[@<snapshot-name>].
provisioning_options словарь добавлено в netapp.ontap 23.0.0	Параметры, применяемые к операции. Этот параметр доступен только для систем ASA r2.
count целое число	Количество LUN, которые нужно подготовить с этими свойствами. Поддерживаются только запросы POST, основанные на space.size. Если задано это значение, имя считается префиксом, а к нему добавляется суффикс формата _<N>, где N — следующий доступный числовой индекс, начиная с 1.
size целое число	Размер в байтах. Диапазон: [0..2^63-1].
size_unit строка	Единица измерения, используемая для интерпретации параметра размера. Варианты: `"bytes"` `"b"` ← (по умолчанию) `"kb"` `"mb"` `"gb"` `"tb"` `"pb"` `"eb"` `"zb"` `"yb"`
state строка	Указывает, должно ли указанное пространство имен существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda логическое значение добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP. Поддерживается только с REST. Варианты: `false` ← (по умолчанию) `true`
use_rest строка	Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — пытаться использовать REST API, если модуль поддерживает REST и поддерживаются параметры модуля. В противном случае выполняется переход на 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 строка / обязательный	Имя используемого 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 Namespace
  netapp.ontap.na_ontap_nvme_namespace:
    state: present
    ostype: linux
    path: /vol/ansible/test
    size: 5
    size_unit: mb
    vserver: "{{ vserver }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create NVME Namespace ASA r2 system
  netapp.ontap.na_ontap_nvme_namespace:
    state: present
    ostype: linux
    path: /vol/ansible/test
    size: 5
    size_unit: mb
    provisioning_options:
      count: 2
    vserver: "{{ vserver }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify NVME Namespace
  netapp.ontap.na_ontap_nvme_namespace:
    state: present
    ostype: linux
    path: /vol/ansible/test
    size: 10
    size_unit: mb
    vserver: "{{ vserver }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete NVME Namespace
  netapp.ontap.na_ontap_nvme_namespace:
    state: absent
    ostype: linux
    path: /vol/ansible/test
    size: 10
    size_unit: mb
    vserver: "{{ vserver }}"
    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_namespace_module.html