netapp.ontap.na_ontap_snapshot_policy модуль — Управление политиками моментальных снимков 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_policy.
Введено в netapp.ontap 2.8.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 или более поздней версии.
Параметры
Параметр | Комментарии |
|---|---|
cert_filepath строка добавлено в netapp.ontap 20.6.0 | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. |
comment строка | Комментарий, понятный человеку, прикрепленный к снимку. Длина комментария может быть не более 255 символов. |
count список / элементы=целое число | Количество сохраняемых снимков, создаваемых по расписанию. |
enabled булево | Статус политики создания снимков, указывающий, будет ли политика включена или выключена. Варианты:
|
feature_flags словарь добавлено в netapp.ontap 20.5.0 | Включение или выключение новой функции. Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются. |
force_ontap_version строка добавлено в netapp.ontap 21.23.0 | Переопределение версии кластера ONTAP при использовании REST. Поведение не определено, если версия не соответствует целевому кластеру. Это предлагается как обходной путь, когда версия кластера не может быть прочитана из-за проблем с правами доступа. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Это должно быть в формате 9.10 или 9.10.1, где каждый элемент — целое число. Когда Игнорируется при использовании ZAPI. |
hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port целое число | Переопределить стандартный порт (80 или 443) на этот порт |
https булево | Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. Варианты:
|
key_filepath строка добавлено в netapp.ontap 20.6.0 | путь к файлу закрытого ключа SSL-клиента. |
name строка / обязательно | Имя политики создания снимков, которое нужно управлять. Максимальная длина строки — 256 символов. |
ontapi целое число | Используемая версия API ONTAP |
password псевдонимы: pass строка | Пароль для указанного пользователя. |
prefix список / элементы=строка добавлено в netapp.ontap 19.11.0 | Префикс имени снимка для расписания. Имя префикса должно быть уникальным в пределах политики. Нельзя задать другой префикс для расписания, которое уже назначено политике создания снимков. Префикс не может быть изменён после добавления расписания. |
retention_period список / элементы=строка добавлено в netapp.ontap 22.12.0 | Срок хранения копий снимков для расписания. Допустимые значения — «бесконечно» или продолжительность, указанная в формате ISO 8601. Значение, заданное в формате ISO 8061 для срока хранения, должно быть в секундах (PT0S - PT65535S), минутах (PT0M - PT60M), часах (PT0H - PT24H), днях (P0D - P36500D), месяцах (P0M - P1200M), годах (P0Y - P100Y). Поддерживается только с REST и требует ONTAP 9.12 или более поздней версии. |
schedule список / элементы=строка | Расписание, которое нужно добавить в политику. |
snapmirror_label список / элементы=строка добавлено в netapp.ontap 2.9.0 | Метка SnapMirror, назначенная каждому расписанию в пределах политики. Используйте пустую строку (‘’) для отсутствия метки. |
state строка | Если нужно создать, изменить или удалить политику создания снимков. Варианты:
|
use_rest string | Использовать REST или ZAPI. always – всегда использовать REST API, если модуль его поддерживает. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если опция модуля не поддерживается в REST. never – всегда использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если опция REST не поддерживается в ZAPI. auto – попытаться использовать REST API, если модуль его поддерживает и опции модуля поддерживаются. В противном случае переходит к ZAPI. По умолчанию: |
username aliases: user string | Может быть учетной записью на уровне кластера или SVM, в зависимости от того, нужен ли API на уровне кластера или SVM. Для получения дополнительной информации, пожалуйста, обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации
Для использования сертификата, он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам. |
validate_certs boolean | Если установлено Это следует установить только в Варианты:
|
vserver string добавлен в netapp.ontap 2.9.0 | Имя vserver для использования. В многоарендной среде назначение Политики снимков vserver ограничит ее использование этим vserver. |
Примечания
Примечание
- Модули с префиксом na_ontap разработаны для поддержки платформы хранения ONTAP.
- https включен по умолчанию и рекомендуется. Для включения http в кластере необходимо выполнить следующие команды «set -privilege advanced;» ‘system services web modify -http-enabled true;’
Примеры
- 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
Ссылки на сборку
© 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_policy_module.html
