Модуль netapp.ontap.na_ontap_lun_copy — копирование LUN в NetApp ONTAP
Примечание
Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля необходимы дополнительные требования. Подробнее см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_lun_copy.
Добавлено в netapp.ontap 2.8.0
Краткое описание
- Копирование LUN в NetApp ONTAP.
Требования
Следующие требования необходимы на узле, на котором выполняется этот модуль.
- 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. |
destination_path string / обязательный | Указывает полный путь к новому LUN. |
destination_vserver псевдонимы: vserver string / обязательный | Имя Vserver, на котором будет размещен новый LUN. |
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, причем каждый элемент должен быть целым числом. Если Игнорируется при использовании ZAPI. |
hostname string / обязательный | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port integer | Переопределяет порт по умолчанию (80 или 443) указанным портом. |
https boolean | Включает и отключает HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации с сертификатом SSL, так как для нее требуется SSL. Варианты:
|
key_filepath string добавлено в netapp.ontap 20.6.0 | Путь к файлу ключа клиента SSL. |
lambda_config dictionary добавлено в netapp.ontap 23.4.0 | Параметры конфигурации функции прокси-сервера AWS Lambda. Этот параметр и его вложенные параметры поддерживаются только при использовании REST. |
|
aws_profile string |
Имя профиля AWS, используемого для аутентификации. |
|
aws_region string / обязательный |
Имя региона AWS. |
|
function_name string / обязательный |
Имя вызываемой функции AWS Lambda. |
ontapi integer | Версия API ONTAP, которую следует использовать. |
password псевдонимы: pass string | Пароль указанного пользователя. |
source_path string / обязательный | Указывает полный путь к исходному LUN. |
source_vserver string | Указывает имя vserver, на котором размещен копируемый LUN. Если значение не задано, по умолчанию используется При использовании REST значение этого параметра должно совпадать с |
state string | Определяет, должен ли указанный LUN существовать. Варианты:
|
use_lambda boolean добавлено в netapp.ontap 23.2.0 | Указывает, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты:
|
use_rest string | Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — пытаться использовать REST API, если модуль и его параметры поддерживают REST. В противном случае использовать ZAPI. Значение по умолчанию: |
username псевдонимы: user string | Учетная запись может иметь область действия кластера или SVM — в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации
Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена. |
validate_certs boolean | Если задано значение Задавайте это значение только для Варианты:
|
Примечания
Примечание
- Поддерживаются ZAPI и REST. Для REST требуется ONTAP 9.10.1 или более поздняя версия.
- Поддерживается режим проверки.
- REST поддерживает только копирование LUN внутри одного Vserver.
- Этот модуль несовместим с системами ASA r2.
- При использовании REST поддерживается функция прокси-сервера AWS Lambda. Примеры см. в файле README.
- Модули с префиксом 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 }}"
Ссылки на коллекцию
© 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_lun_copy_module.html