netapp.ontap.na_ontap_snapshot модуль — Управление моментальными снимками NetApp ONTAP

Примечание

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

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

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

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

Новое в netapp.ontap 2.6.0

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

Обзор

Создание/Изменение/Удаление моментальных снимков 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 или более поздней версии

Параметры

Параметр	Комментарии
async_bool boolean	Если значение true, то создание снимка выполняется асинхронно. Варианты: `false` `true`
cert_filepath string добавлен в netapp.ontap 20.6.0	путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
comment string	Добавляемый в снимок человекочитаемый комментарий. Длина комментария может быть не более 255 символов.
expiry_time string добавлен в netapp.ontap 21.8.0	Время истечения действия снимка, доступно только с REST. Формат должен соответствовать часовому поясу, настроенному в кластере.
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.
from_name string добавлен в netapp.ontap 2.8.0	Имя существующего снимка, который нужно переименовать.
hostname string / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределить стандартный порт (80 или 443) на указанный порт.
https boolean	Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации SSL-сертификата, так как она требует SSL. Варианты: `false` ← (по умолчанию) `true`
ignore_owners boolean	Если значение true, то снимок будет удалён, даже если к нему обращаются другие процессы. Варианты: `false` `true`
key_filepath string добавлен в netapp.ontap 20.6.0	путь к файлу закрытого ключа SSL-клиента.
ontapi integer	Версия ontap API, которая будет использоваться.
password псевдонимы: pass string	Пароль для указанного пользователя.
snapmirror_label string	Добавляемая в снимок человекочитаемая метка SnapMirror. Длина метки может быть не более 31 символа. Поддерживается REST на Ontap 9.7 и выше.
snapshot string / обязательно	Имя снимка, который нужно обработать. Максимальная длина строки — 256 символов.
snapshot_instance_uuid string	Уникальный идентификатор снимка из 128 бит, представленный в формате UUID.
state string	Если необходимо создать/изменить снимок или удалить его. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_rest string	Использовать REST или ZAPI. always — всегда использовать REST API, если модуль его поддерживает. Выводится предупреждение, если модуль не поддерживает REST. Выдается ошибка, если параметр модуля не поддерживается в REST. never — всегда использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI. auto — попытаться использовать REST API, если модуль его поддерживает, и параметры модуля поддерживаются. В противном случае переходит на ZAPI. По умолчанию: `"auto"`

имя_пользователя псевдонимы: user строка	Это может быть учётная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения более подробной информации, пожалуйста, обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации аутентификация по протоколу basic, используя имя пользователя и пароль, аутентификация по сертификату SSL, используя файл сертификата ssl-клиента и, необязательно, файл закрытого ключа. Для использования сертификата, сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам.
validate_certs логическое значение	Если установлено в `no`, сертификаты SSL не будут проверены. Это следует устанавливать только в `False` на сайтах, контролируемых лично, использующих самозаверяющие сертификаты. Варианты: `false` `true` ← (по умолчанию)
volume строка / обязательно	Имя тома, на котором будет создан снимок.
vserver строка / обязательно	Имя Vserver

Примечания

Примечание

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

Примеры

- name: create SnapShot
  tags:
    - create
  netapp.ontap.na_ontap_snapshot:
    state: present
    snapshot: "{{ snapshot name }}"
    volume: "{{ vol name }}"
    comment: "i am a comment"
    expiry_time: "2022-02-04T14:00:00-05:00"
    vserver: "{{ vserver name }}"
    username: "{{ netapp username }}"
    password: "{{ netapp password }}"
    hostname: "{{ netapp hostname }}"
- name: delete SnapShot
  tags:
    - delete
  netapp.ontap.na_ontap_snapshot:
    state: absent
    snapshot: "{{ snapshot name }}"
    volume: "{{ vol name }}"
    vserver: "{{ vserver name }}"
    username: "{{ netapp username }}"
    password: "{{ netapp password }}"
    hostname: "{{ netapp hostname }}"
- name: modify SnapShot
  tags:
    - modify
  netapp.ontap.na_ontap_snapshot:
    state: present
    snapshot: "{{ snapshot name }}"
    comment: "New comments are great"
    volume: "{{ vol name }}"
    vserver: "{{ vserver name }}"
    username: "{{ netapp username }}"
    password: "{{ netapp password }}"
    hostname: "{{ netapp hostname }}"

Авторы

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