модуль netapp.ontap.na_ontap_volume_snaplock — управление сроком хранения SnapLock тома NetApp ONTAP.

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_volume_snaplock.

Добавлено в netapp.ontap 20.2.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Изменяет срок хранения SnapLock томов в NetApp ONTAP.

Требования

На хосте, который выполняет этот модуль, должны быть установлены следующие компоненты.

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 или более поздняя версия.

Параметры

Параметр	Описание
autocommit_period строка	Задает период автоматической фиксации для тома SnapLock. Формат: «<число> <единицы измерения>», например «8 hours»; допустимы следующие единицы измерения: секунды минуты часы дни месяцы годы
cert_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
default_retention_period строка	Задает применяемый период хранения по умолчанию. Формат: «<число> <единицы измерения>», например «10 days»; допустимы следующие единицы измерения: секунды минуты часы дни месяцы годы Если для этого параметра указано значение «max», в качестве периода хранения по умолчанию будет использоваться maximum_retention_period.
feature_flags словарь добавлено в netapp.ontap 20.5.0	Включает или отключает новую функцию. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.
hostname строка / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Заменяет порт по умолчанию (80 или 443) указанным портом.
https логический	Включает и отключает HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при использовании аутентификации по SSL-сертификату, поскольку для нее требуется SSL. Варианты: `false` ← (по умолчанию) `true`
is_volume_append_mode_enabled логический	Указывает, должен ли быть включен или отключен режим добавления данных в том. Изменить этот параметр можно только тогда, когда том не подключен и не содержит данных или копий Snapshot. Режим добавления данных в том не поддерживается для томов журнала аудита SnapLock. Если этот режим включен, все файлы, созданные на томе с разрешением на запись, по умолчанию будут файлами WORM, допускающими добавление данных. Все файлы WORM, допускающие добавление данных, которые не изменялись дольше периода автоматической фиксации тома, также фиксируются в состоянии WORM, доступном только для чтения. Варианты: `false` `true`
key_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
maximum_retention_period строка	Задает применяемый максимально допустимый период хранения. Формат: «<число> <единицы измерения>», например «2 years»; допустимы следующие единицы измерения: секунды минуты часы дни месяцы годы
minimum_retention_period строка	Задает применяемый минимально допустимый период хранения. Формат: «<число> <единицы измерения>», например «1 days»; допустимы следующие единицы измерения: секунды минуты часы дни месяцы годы
name строка / обязательный	Имя тома, которым нужно управлять.
ontapi целое число	Версия API ONTAP, которую следует использовать.
password псевдонимы: pass строка	Пароль указанного пользователя.
use_rest строка	Этот модуль поддерживает только ZAPI; переключение на REST невозможно. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — всегда использовать ZAPI. По умолчанию: `"never"`
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 строка / обязательный	Имя используемого vserver.

Примечания

Примечание

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

Примеры

- name: Set volume snaplock
  netapp.ontap.na_ontap_volume_snaplock:
    vserver: ansibleSVM
    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)

Ссылки на коллекцию

© 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_volume_snaplock_module.html