netapp.ontap.na_ontap_volume_snaplock – NetApp ONTAP управление удержанием моментальных снимков томов.
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Чтобы использовать его в книге задач, укажите: netapp.ontap.na_ontap_volume_snaplock.
Новое в версии 20.2.0: модуля netapp.ontap
Обзор
- Изменяет удержание моментальных снимков томов в NetApp 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;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| autocommit_period строка | Устанавливает период автокоммита для тома моментальных снимков. Формат: "<число> <единицы измерения>", например, "8 часов", допустимые единицы измерения: секунды минуты часы дни месяцы годы | |
| cert_filepath строка добавлен в 20.6.0 netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. | |
| default_retention_period строка | Устанавливает период удержания по умолчанию, который будет применяться. Формат: "<число> <единицы измерения>", например, "10 дней", допустимые единицы измерения: секунды минуты часы дни месяцы годы Если этот параметр задан как "max", тогда maximum_retention_period будет использоваться как период удержания по умолчанию. | |
| feature_flags словарь добавлен в 20.5.0 netapp.ontap | Включение или выключение новой функции. Это может быть использовано для включения экспериментальной функции или выключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) этим портом | |
| https булево |
| Включение и отключение https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по сертификату SSL, так как она требует SSL. |
| is_volume_append_mode_enabled булево |
| Указывает, должен ли быть включен или выключен режим добавления тома. Его можно изменить только тогда, когда том не смонтирован и не имеет данных или моментальных копий. Режим добавления тома не поддерживается для томов журналов аудита SnapLock. При включении все файлы, созданные с правами записи на томе, по умолчанию будут файлами, добавляемыми в режиме WORM. Все файлы, добавляемые в режиме WORM, которые не изменялись в течение периода времени, превышающего период автокоммита тома, также будут переведены в состояние только для чтения WORM. |
| key_filepath строка добавлен в 20.6.0 netapp.ontap | путь к файлу ключа SSL-клиента. | |
| maximum_retention_period строка | Указывает максимальный разрешенный период удержания, который будет применяться. Формат: "<число> <единицы измерения>", например, "2 года", допустимые единицы измерения: секунды минуты часы дни месяцы годы | |
| minimum_retention_period строка | Указывает минимальный разрешенный период удержания, который будет применяться. Формат: "<число> <единицы измерения>", например, "1 день", допустимые единицы измерения: секунды минуты часы дни месяцы годы | |
| name строка / обязательно | Имя тома, который нужно управлять. | |
| ontapi целое число | Версия API ontap для использования | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| use_rest строка | Значение по умолчанию: "auto" | 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 строка / обязательно | Имя vserver для использования. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Set volume snaplock
na_ontap_volume_snaplock:
vserver: svm
name: ansibleVolume
default_retention_period: "5 days"
minimum_retention_period: "0 years"
maximum_retention_period: "10 days"
is_volume_append_mode_enabled: False
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Авторы
- Команда 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_volume_snaplock_module.html
