модуль netapp.ontap.na_ontap_storage_unit_snapshot — снимок единицы хранения 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_snapshot.

Добавлено в 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 строка добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
comment строка	Комментарий, связанный со снимком.
expiry_time строка	Указывает время истечения срока действия снимка. Например: 2025-04-09T07:30:00-04:00. Снимки с указанным временем истечения срока действия нельзя удалить до окончания срока хранения.
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, где каждый элемент является целым числом.
from_name строка	Указывает имя снимка, который нужно переименовать.
hostname строка / обязательный	Имя узла или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределяет порт по умолчанию (80 или 443), задавая этот порт.
https логическое значение	Включает или отключает https. Игнорируется при использовании REST, поскольку поддерживается только https. Игнорируется при использовании аутентификации с сертификатом SSL, для которой требуется SSL. Допустимые значения: `false` ← (по умолчанию) `true`
key_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
name строка / обязательный	Указывает имя снимка.
password псевдонимы: pass строка	Пароль указанного пользователя.
snapmirror_label строка	Указывает метку для операций SnapMirror.
state строка	Указывает, должна ли указанная единица хранения существовать. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
storage_unit строка / обязательный	Указывает единицу хранения, в которой находится снимок.
use_lambda логическое значение добавлено в netapp.ontap 23.4.0	Указывает, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Допустимые значения: `false` ← (по умолчанию) `true`
use_rest строка	Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, выводится предупреждение. По умолчанию: `"always"`
username псевдонимы: user строка	Это может быть учетная запись уровня кластера или уровня SVM в зависимости от того, какой API требуется — уровня кластера или уровня SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью сертификата SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Чтобы использовать сертификат, его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs логическое значение	Если задано значение `no`, сертификаты SSL не проверяются. Задавайте это значение только для `False` на контролируемых вами сайтах, использующих самоподписанные сертификаты. Допустимые значения: `false` `true` ← (по умолчанию)
vserver строка / обязательный	Указывает SVM, в которой находится единица хранения.

Примечания

Примечание

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

Примеры

- name: Create a snapshot for LUN storage unit
  netapp.ontap.na_ontap_storage_unit_snapshot:
    state: present
    name: lun1_snap1
    vserver: ansibleSVM
    storage_unit: lun1
    expiry_time: 2025-04-09T07:30:00-04:00
    snapmirror_label: my_label
    comment: "snapshot for lun1"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Update a snapshot
  netapp.ontap.na_ontap_storage_unit_snapshot:
    name: lun1_snap1
    vserver: ansibleSVM
    storage_unit: lun1
    expiry_time: 2025-04-09T08:30:00-04:00
    snapmirror_label: another_label
    comment: "updated expiry date, label"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Rename a storage unit snapshot
  netapp.ontap.na_ontap_storage_unit_snapshot:
    name: lun1_snapshot1
    from_name: lun1_snap1
    vserver: ansibleSVM
    storage_unit: lun1
    expiry_time: 2025-04-09T08:30:00-04:00
    snapmirror_label: another_label
    comment: "snapshot for lun1"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Delete a snapshot
  netapp.ontap.na_ontap_mav_approval_group:
    state: absent
    name: lun1_snapshot1
    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_snapshot_module.html