netapp.ontap.na_ontap_snapshot_policy – NetApp ONTAP управлять политикой моментальных снимков
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в книге задач укажите: netapp.ontap.na_ontap_snapshot_policy.
Новое в версии 2.8.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;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cert_filepath строка добавлен в 20.6.0 версии netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. | |
| comment строка | Человекочитаемый комментарий, прикреплённый к снимку. Размер комментария может быть не более 255 символов. | |
| count список / элементы=целое число | Количество сохраняемых снимков, созданных по расписанию. | |
| enabled булево |
| Статус политики создания снимков, указывающий, будет ли политика включена или отключена. |
| feature_flags словарь добавлен в 20.5.0 версии netapp.ontap | Включение или отключение новой функции. Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) на этот порт | |
| https булево |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. |
| key_filepath строка добавлен в 20.6.0 версии netapp.ontap | путь к файлу закрытого ключа SSL-клиента. | |
| name строка / обязательно | Имя политики создания снимков, подлежащей управлению. Максимальная длина строки — 256 символов. | |
| ontapi целое число | Версия API ontap для использования | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| prefix список / элементы=строка добавлен в 19.10.1 версии netapp.ontap | Префикс имени снимка для расписания. Префиксное имя должно быть уникальным в рамках политики. Нельзя задать другой префикс для расписания, которое уже было назначено политике создания снимков. Префикс не может быть изменен после добавления расписания. | |
| schedule список / элементы=строка | Расписание, подлежащее добавлению в политику. | |
| snapmirror_label список / элементы=строка добавлен в 2.9.0 версии netapp.ontap | Метка SnapMirror, назначенная каждому расписанию внутри политики. Для отсутствия метки используйте пустую строку (''). | |
| state строка |
| Если вы хотите создать, изменить или удалить политику создания снимков. |
| use_rest строка | Значение по умолчанию: "авто" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае будет возвращено к ZAPI. всегда — всегда будет использоваться REST API никогда — всегда будет использоваться ZAPI авто — будет использоваться REST API |
| username строка | Это может быть учётная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. базовая аутентификация с использованием имени пользователя и пароля, 2. аутентификация по SSL-сертификату с использованием файла SSL-сертификата клиента и, по желанию, файла закрытого ключа. Для использования сертификата, сертификат должен быть установлен в кластере ONTAP, и аутентификация по сертификату должна быть включена. псевдонимы: user | |
| validate_certs булево |
| Если установлено значение no, сертификаты SSL не будут проверены.Это следует установить только в False случаях использования на сайтах с собственным контролем, использующих самозаверяющие сертификаты. |
| vserver строка добавлено в 2.9.0 netapp.ontap | Имя vserver для использования. В многоарендной среде присвоение политики создания снимков vserver ограничит её использование этим vserver. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create Snapshot policy
na_ontap_snapshot_policy:
state: present
name: ansible2
schedule: hourly
prefix: hourly
count: 150
enabled: True
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
hostname: "{{ netapp_hostname }}"
https: False
- name: Create Snapshot policy with multiple schedules
na_ontap_snapshot_policy:
state: present
name: ansible2
schedule: ['hourly', 'daily', 'weekly', 'monthly', '5min']
prefix: ['hourly', 'daily', 'weekly', 'monthly', '5min']
count: [1, 2, 3, 4, 5]
enabled: True
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
hostname: "{{ netapp_hostname }}"
https: False
- name: Create Snapshot policy owned by a vserver
na_ontap_snapshot_policy:
state: present
name: ansible3
vserver: ansible
schedule: ['hourly', 'daily', 'weekly', 'monthly', '5min']
prefix: ['hourly', 'daily', 'weekly', 'monthly', '5min']
count: [1, 2, 3, 4, 5]
snapmirror_label: ['hourly', 'daily', 'weekly', 'monthly', '']
enabled: True
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
hostname: "{{ netapp_hostname }}"
https: False
- name: Modify Snapshot policy with multiple schedules
na_ontap_snapshot_policy:
state: present
name: ansible2
schedule: ['daily', 'weekly']
count: [20, 30]
snapmirror_label: ['daily', 'weekly']
enabled: True
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
hostname: "{{ netapp_hostname }}"
https: False
- name: Delete Snapshot policy
na_ontap_snapshot_policy:
state: absent
name: ansible2
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
hostname: "{{ netapp_hostname }}"
https: False
Авторы
- Команда 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_policy_module.html