Модуль netapp.ontap.na_ontap_volume_clone — Управление клонами томов 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_volume_clone.

Новое в netapp.ontap 2.6.0

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

Описание

Создание клонов томов NetApp ONTAP.
Для использования этого модуля требуется лицензия FlexClone.

Требования

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

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.
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.
gid целое число добавлено в netapp.ontap 2.9.0	Идентификатор группы UNIX для тома-клона.
hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить порт по умолчанию (80 или 443) на этот порт
https логическое	Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации с помощью сертификата SSL, так как она требует SSL. Варианты: `false` ← (по умолчанию) `true`
junction_path строка добавлено в netapp.ontap 2.8.0	Путь соединения тома.
key_filepath строка добавлено в netapp.ontap 20.6.0	путь к файлу секретного ключа SSL-клиента.
name псевдонимы: volume строка / обязательно	Имя создаваемого тома-клона.
ontapi целое число	Версия API ontap для использования
parent_snapshot строка	Родительский снимок, на основе которого создается том-клон.
parent_volume строка / обязательно	Родительский том создаваемого тома-клона.
parent_vserver строка	Сервер виртуальных машин родительского тома, на основе которого создается клон.
password псевдонимы: pass строка	Пароль для указанного пользователя.
qos_policy_group_name строка	Имя группы qos-policy, которое должно быть установлено для тома-клона.
space_reserve строка	Настройка space_reserve, которая должна использоваться для тома-клона. Варианты: `"volume"` `"none"`
split логическое добавлено в netapp.ontap 20.2.0	Разделить том-клон от родительского тома. Варианты: `false` `true`
state строка	Необходимо ли создать клон тома. Варианты: `"present"` ← (по умолчанию)
uid целое число добавлено в netapp.ontap 2.9.0	Идентификатор пользователя UNIX для тома-клона.

use_rest string	Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль его поддерживает. Выдаётся предупреждение, если модуль не поддерживает REST. Выдаётся ошибка, если опция модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если опция REST не поддерживается в ZAPI. auto – будет пытаться использовать REST API, если модуль его поддерживает и опции модулей поддерживаются. В противном случае переходит к ZAPI. По умолчанию: `"auto"`
username aliases: user string	Может быть учётной записью уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации базовая аутентификация, с использованием имени пользователя и пароля, аутентификация с помощью SSL-сертификата, с использованием файла SSL-клиентского сертификата и, необязательно, файла закрытого ключа. Для использования сертификата, сертификат должен быть установлен в кластере ONTAP, и аутентификация с помощью сертификатов должна быть включена.
validate_certs boolean	Если установлено значение `no`, SSL-сертификаты не будут проверены. Это должно быть установлено только в `False` для сайтов, контролируемых лично, использующих самозаверяющие сертификаты. Варианты: `false` `true` ← (по умолчанию)
volume_type string	Параметр типа тома, который следует использовать для клонирования тома. Варианты: `"rw"` `"dp"`
vserver string / обязательно	Vserver, в котором должен быть создан клон тома.

Примечания

Примечание

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

Примеры

- name: create volume clone
  na_ontap_volume_clone:
    state: present
    username: "{{ netapp username }}"
    password: "{{ netapp password }}"
    hostname: "{{ netapp hostname }}"
    vserver: vs_hack
    parent_volume: normal_volume
    name: clone_volume_7
    space_reserve: none
    parent_snapshot: backup1
    junction_path: /clone_volume_7
    uid: 1
    gid: 1

Авторы

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