netapp.ontap.na_ontap_snapshot – NetApp ONTAP управлять моментальными снимками
Примечание
Этот плагин входит в сборку netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в книге задач укажите: netapp.ontap.na_ontap_snapshot.
Новое в версии 2.6.0: of netapp.ontap
Обзор
- Создание/изменение/удаление моментальных снимков ONTAP
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Ansible 2.6
- Ansible 2.9 или более поздняя версия настоятельно рекомендуется, так как она включает новую систему доставки сборок.
- Python2 netapp-lib (2017.10.30) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает лучшую обработку ошибок для проблем с подключением.
- Чтобы включить http в кластере, необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| async_bool boolean |
| Если true, моментальный снимок создается асинхронно. |
| cert_filepath string добавлен в 20.6.0 of netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с Python 2.6. | |
| comment string | Человекочитаемый комментарий, прикрепленный к моментальному снимку. Размер комментария может составлять не более 255 символов. | |
| feature_flags dictionary добавлен в 20.5.0 of netapp.ontap | Включить или отключить новую функцию. Это может быть использовано для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| from_name string добавлен в 2.8.0 of netapp.ontap | Имя существующего моментального снимка, который нужно переименовать. | |
| hostname string / required | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port integer | Переопределить порт по умолчанию (80 или 443) на этот порт | |
| https boolean |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL. |
| ignore_owners boolean |
| если это поле true, моментальный снимок будет удалён, даже если к нему обращаются другие процессы. |
| key_filepath string добавлен в 20.6.0 of netapp.ontap | путь к файлу закрытого ключа SSL-клиента. | |
| ontapi integer | Версия API ontap, которую использовать | |
| password string | Пароль для указанного пользователя. псевдонимы: pass | |
| snapmirror_label string | Человекочитаемый тег SnapMirror, прикрепленный к моментальному снимку. Размер тега может составлять не более 31 символа. | |
| snapshot string / required | Имя моментального снимка, который необходимо управлять. Максимальная длина строки — 256 символов. | |
| snapshot_instance_uuid string | 128-битный уникальный идентификатор моментального снимка, представленный в формате UUID. | |
| state string |
| Если требуется создать/изменить моментальный снимок или удалить его. |
| use_rest string | По умолчанию: "auto" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае будет использоваться ZAPI. всегда -- всегда будет использоваться REST API никогда -- всегда будет использоваться ZAPI автоматически -- будет использоваться попытка использовать REST API |
| username string | Это может быть учётная запись, связанная с кластером или SVM, в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. базовая аутентификация, использующая имя пользователя и пароль, 2. аутентификация по SSL-сертификату, использующая файл SSL-сертификата клиента и необязательно файл закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификату. псевдонимы: user | |
| validate_certs boolean |
| Если установлено в no, SSL-сертификаты не будут проверяться.Это следует установить только в False на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов. |
| volume string / required | Имя тома, на котором должен быть создан моментальный снимок. | |
| vserver string / required | Имя сервера виртуальных машин |
Примечания
Примечание
- Модули с префиксом na_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: create SnapShot
tags:
- create
na_ontap_snapshot:
state: present
snapshot: "{{ snapshot name }}"
volume: "{{ vol name }}"
comment: "i am a comment"
vserver: "{{ vserver name }}"
username: "{{ netapp username }}"
password: "{{ netapp password }}"
hostname: "{{ netapp hostname }}"
- name: delete SnapShot
tags:
- delete
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
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) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/netapp/ontap/na_ontap_snapshot_module.html
