Модуль netapp.ontap.na_ontap_lun_copy – Копирование LUN в NetApp ONTAP

Примечание

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

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

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

Для использования в playbook укажите: netapp.ontap.na_ontap_lun_copy.

Новая в netapp.ontap 2.8.0

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

Описание

Копирование LUN в NetApp 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.
destination_path строка / обязательно	Указывает полный путь к новому LUN.
destination_vserver псевдонимы: vserver строка / обязательно	имя VServer, который будет содержать новый LUN.
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
password псевдонимы: pass строка	Пароль для указанного пользователя.
source_path строка / обязательно	Указывает полный путь к исходному LUN.
source_vserver строка	Указывает имя vserver, содержащего LUN, который нужно скопировать. Если не указано, используется значение `destination_vserver`. по умолчанию. При использовании REST значение этого параметра должно соответствовать `destination_vserver`, если он указан.
state строка	Указывает, должен ли указанный LUN существовать или нет. Варианты: `"present"` ← (по умолчанию)
use_rest строка	Использовать REST или ZAPI. всегда — всегда использует REST API, если модуль его поддерживает. Выводится предупреждение, если REST не поддерживается. Выводится ошибка, если параметр модуля не поддерживается в REST. никогда — всегда использует ZAPI, если модуль его поддерживает. Может выводится ошибка, если параметр REST не поддерживается в ZAPI. авто — пытается использовать REST API, если модуль его поддерживает и параметры модуля поддерживаются. В противном случае использует ZAPI. По умолчанию: `"auto"`
username псевдонимы: user строка	Это может быть учётная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Для получения дополнительной информации ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации: базовая аутентификация, использующая имя пользователя и пароль, аутентификация с помощью SSL-сертификата клиента, а также (необязательно) файла приватного ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам.
validate_certs логическое значение	Если установлено в `no`, SSL-сертификаты не будут проверены. Это следует устанавливать только в `False`, используемом на управляемых лично сайтах с самозаверенными сертификатами. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Copy LUN
  netapp.ontap.na_ontap_lun_copy:
    destination_vserver: ansible
    destination_path: /vol/test/test_copy_dest_dest_new
    source_path: /vol/test/test_copy_1
    source_vserver: ansible
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

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