Модуль netapp.ontap.na_ontap_storage_unit — единица хранения NetApp ONTAP ASA r2

Примечание

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

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

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

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

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

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

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

Клонирование единицы хранения.
Разделение клона единицы хранения.
Перемещение единицы хранения.
Восстановление единицы хранения до предыдущего снимка.

Требования

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

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.
clone dictionary	Идентификаторы родительской единицы хранения или снимка единицы хранения, из которых будет создана новая единица хранения. Клон единицы хранения и его источник должны находиться в одной SVM.
snapshot string	Имя снимка, в котором находится исходная единица хранения.
storage_unit string	Имя исходной единицы хранения.
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, где каждый элемент — целое число.
hostname string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределение порта по умолчанию (80 или 443) указанным портом.
https boolean	Включение и отключение HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при аутентификации с помощью сертификата SSL, поскольку для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
name string / обязательный	Имя единицы хранения (LUN или пространства имён NVMe).
password псевдонимы: pass string	Пароль указанного пользователя.
restore_to string	Имя снимка, до момента создания которого следует восстановить единицу хранения.
restore_to_snapshot string	Имя снимка, до момента создания которого следует восстановить единицу хранения.
split_initiated boolean	Установка этого параметра запускает разделение единицы хранения FlexClone и единицы хранения FlexVol. Эта операция прекращает репликацию данных, но не удаляет снимки из реплик. Варианты: `false` `true`
state string	Управление операциями с единицами хранения; поддерживается только состояние present. Варианты: `"present"` ← (по умолчанию)
target_location string	Имя целевой зоны доступности хранилища, в которую перемещается единица хранения.
time_out integer	Если задано значение `wait_for_completion`, указывает время ожидания операций клонирования, разделения, восстановления или перемещения единицы хранения в секундах. По умолчанию: `180`
use_lambda boolean добавлено в netapp.ontap 23.4.0	Указывает, следует ли использовать прокси-функциональность AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, выводится предупреждение. По умолчанию: `"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 / обязательный	Указывает SVM, в которой находится единица хранения.
wait_for_completion boolean	Задайте этому параметру значение «true» для синхронного выполнения. При асинхронном выполнении процесс завершается сразу после отправки запроса, а операция продолжается в фоновом режиме. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Поддерживается только REST и требуется ONTAP 9.16.1 или более поздняя версия.
Поддерживается только в системах ASA r2.
Клон единицы хранения и его источник должны находиться в одной SVM.
Модуль не является идемпотентным, если задано значение restore_to.
REST API единиц хранения не поддерживает операцию DELETE. Для удаления соответствующей единицы хранения используйте модуль na_ontap_lun или na_ontap_nvme_namespace.
Модули с префиксом na_ontap предназначены для работы с платформой хранения ONTAP.
HTTPS включён по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create a new storage unit(LUN) clone
  netapp.ontap.na_ontap_storage_unit:
    state: present
    name: lun1_clone1
    vserver: svm1
    clone:
      storage_unit: lun1
    wait_for_completion: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Split a storage unit(LUN) clone
  netapp.ontap.na_ontap_storage_unit:
    state: present
    name: lun1_clone1
    vserver: svm1
    split_initiated: true
    wait_for_completion: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Create a new storage unit(LUN) clone using snapshot
  netapp.ontap.na_ontap_storage_unit:
    state: present
    name: lun1_clone1
    vserver: svm1
    clone:
      storage_unit: lun1
      snapshot: "hourly.2025-04-23_0205"
    wait_for_completion: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Clone a storage unit(LUN), split new clone simultaneously
  netapp.ontap.na_ontap_storage_unit:
    state: present
    name: lun1_clone1
    vserver: svm1
    clone:
      storage_unit: lun1
    split_initiated: true
    wait_for_completion: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Restore a storage unit(LUN) to a prior snapshot
  netapp.ontap.na_ontap_storage_unit:
    state: present
    name: lun1
    vserver: svm1
    restore_to: "hourly.2025-04-21_0905"
    wait_for_completion: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Move a storage unit(LUN)
  netapp.ontap.na_ontap_storage_unit:
    state: present
    name: lun1
    vserver: svm1
    target_location: storage_availability_zone_0
    wait_for_completion: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

Авторы

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