Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_volume_clone — управление клонами томов NetApp ONTAP.

Примечание

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

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

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

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

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

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

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

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

Требования

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

  • 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.

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, где каждый элемент — целое число.

Если для use_rest задано значение auto, этот параметр может принудительно переключить модуль на ZAPI с учётом версии и возможностей платформы.

Игнорируется при использовании ZAPI.

gid

integer

добавлено в netapp.ontap 2.9.0

Идентификатор группы UNIX для тома-клона.

hostname

string / обязательный

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

integer

Переопределение порта по умолчанию (80 или 443).

https

boolean

Включение и отключение HTTPS.

Игнорируется при использовании REST, поскольку поддерживается только HTTPS.

Игнорируется при использовании аутентификации с сертификатом SSL, так как для неё требуется SSL.

Допустимые значения:

  • false ← (по умолчанию)
  • true

junction_path

string

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

Путь соединения тома.

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.

name

псевдонимы: volume

string / обязательный

Имя создаваемого клона тома.

ontapi

integer

Версия API ONTAP, которую следует использовать.

parent_snapshot

string

Родительский снимок, на основе которого создаётся клон тома.

parent_volume

string / обязательный

Родительский том для создаваемого клона.

parent_vserver

string

Vserver родительского тома, на основе которого создаётся клон.

password

псевдонимы: pass

string

Пароль указанного пользователя.

qos_policy_group_name

string

Имя группы политик QoS, задаваемой для клона тома.

space_reserve

string

Настройка space_reserve для клона тома.

Допустимые значения:

  • "volume"
  • "none"

split

boolean

добавлено в netapp.ontap 20.2.0

Отделение клона тома от родительского тома.

Допустимые значения:

  • false
  • true

state

string

Следует ли создать клон тома.

Допустимые значения:

  • "present" ← (по умолчанию)

time_out

integer

добавлено в netapp.ontap 23.2.0

Если задан параметр wait_for_completion, указывает время ожидания операции клонирования/разделения в секундах.

Поддерживается только при использовании REST.

Значение по умолчанию: 180

uid

integer

добавлено в netapp.ontap 2.9.0

Идентификатор пользователя UNIX для тома-клона.

use_lambda

boolean

добавлено в netapp.ontap 23.2.0

Определяет, следует ли использовать прокси-функцию AWS Lambda для подключения к системе ONTAP.

Поддерживается только при использовании REST.

Допустимые значения:

  • false ← (по умолчанию)
  • true

use_rest

string

Использовать REST или ZAPI.

always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выводится предупреждение. Если параметр модуля не поддерживается в REST, выводится ошибка.

never — всегда использовать ZAPI, если модуль его поддерживает. Если параметр REST не поддерживается в ZAPI, может быть выведена ошибка.

auto — пытаться использовать REST API, если модуль поддерживает REST и используемые параметры поддерживаются. В противном случае переключаться на ZAPI.

Значение по умолчанию: "always"

username

псевдонимы: user

string

Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или SVM.

Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

Поддерживаются два метода аутентификации:

  1. Базовая аутентификация с использованием имени пользователя и пароля.
  2. Аутентификация с помощью сертификата SSL с использованием файла сертификата SSL-клиента и, при необходимости, файла закрытого ключа.

Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.

validate_certs

boolean

Если задано значение no, сертификаты SSL проверяться не будут.

Устанавливайте это значение только для False на самостоятельно контролируемых сайтах, использующих самоподписанные сертификаты.

Допустимые значения:

  • false
  • true ← (по умолчанию)

volume_type

string

Настройка типа тома для клона тома.

Допустимые значения:

  • "rw"
  • "dp"

vserver

string / обязательный

Vserver, в котором следует создать клон тома.

wait_for_completion

boolean

добавлено в netapp.ontap 23.2.0

Задайте для этого параметра значение «true» для синхронного выполнения.

При асинхронном выполнении работа завершается сразу после отправки запроса, а операция продолжается в фоновом режиме.

Поддерживается только при использовании REST.

Допустимые значения:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Create volume clone - ZAPI
  netapp.ontap.na_ontap_volume_clone:
    state: present
    vserver: ansibleSVM
    parent_volume: source_volume
    name: cloned_volume
    space_reserve: none
    parent_snapshot: backup1
    junction_path: /cloned_volume
    uid: 1
    gid: 1
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: never

- name: Split an existing volume clone - REST
  netapp.ontap.na_ontap_volume_clone:
    state: present
    vserver: ansibleSVM
    parent_volume: source_volume
    name: cloned_volume
    split: true
    wait_for_completion: true
    time_out: 90
    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_volume_clone_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API