netapp.ontap.na_ontap_snapmirror_policy – NetApp ONTAP создание, удаление или изменение политик SnapMirror
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap
Для использования в книге задач укажите: netapp.ontap.na_ontap_snapmirror_policy
Новое в версии 20.3.0: от netapp.ontap
Обзор
- Создание, изменение или удаление политики SnapMirror NetApp ONTAP
- Добавление, изменение и удаление правил политики SnapMirror
- Следующие параметры не поддерживаются в REST: ‘owner’, ‘restart’, ‘transfer_priority’, ‘tries’, ‘ignore_atime’, ‘common_snapshot_schedule’
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Физическая или виртуальная кластеризованная система 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 строка | Указывает комментарий к политике SnapMirror. | |
| common_snapshot_schedule строка | Указывает расписание общей копии моментальных снимков, связанное с политикой, необходимо только для strict_sync_mirror и sync_mirror. | |
| feature_flags словарь добавлен в 20.5.0 netapp.ontap | Включить или отключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) на указанный порт | |
| https логическое значение |
| Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. |
| ignore_atime логическое значение |
| Указывает, игнорировать ли файлы, у которых изменилось только время доступа, при инкрементных передачах. Применяется только к отношениям хранилища SnapMirror. |
| is_network_compression_enabled логическое значение |
| Указывает, включена ли сжатие сети для передач. |
| keep список / элементы=целое число добавлен в 20.7.0 netapp.ontap | Количество сохраняемых правил политики SnapMirror для созданных моментальных снимков. Требуется при определении правил политики. | |
| key_filepath строка добавлен в 20.6.0 netapp.ontap | путь к файлу закрытого ключа SSL клиента. | |
| ontapi целое число | Версия API ontap для использования | |
| owner строка |
| Указывает владельца политики SnapMirror. |
| password строка | Пароль для указанного пользователя. алиасы: pass | |
| policy_name строка / обязательно | Указывает имя политики SnapMirror. | |
| policy_type строка |
| Указывает тип политики SnapMirror. Изменение типа существующей политики SnapMirror не поддерживается |
| prefix список / элементы=строка добавлен в 20.7.0 netapp.ontap | Префикс правила политики SnapMirror. Необязательно при определении правил политики. Установите в '' для того, чтобы не устанавливать или удалить существующий пользовательский префикс. Имя префикса должно быть уникальным в рамках политики. При указании пользовательского префикса также необходимо указать расписание. | |
| restart строка |
| Определяет поведение SnapMirror, если прерванная передача существует, применяется только к защите данных. |
| schedule список / элементы=строка добавлен в 20.7.0 netapp.ontap | Расписание правила политики SnapMirror. Необязательно при определении правил политики. Установите в '' для того, чтобы не устанавливать или удалить расписание. При указании расписания можно установить пользовательский префикс, в противном случае префикс будет установлен в snapmirror_label. | |
| snapmirror_label список / элементы=строка добавлен в 20.7.0 netapp.ontap | Метка правила политики SnapMirror. Обязательно при определении правил политики. Используйте пустой список для удаления всех определенных пользователем правил. | |
| state строка |
| Указывает, должна ли существовать указанная политика SnapMirror. |
| transfer_priority строка |
| Указывает приоритет, с которым выполняется передача SnapMirror. |
| tries строка | Указывает количество попыток. | |
| use_rest строка | По умолчанию: "авто" | API REST, если он поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае он вернется к 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, и должна быть включена аутентификация по сертификату. алиасы: пользователь | |
| validate_certs логическое значение |
| Если установлено в no, сертификаты SSL не будут проверены.Это следует устанавливать только в False используется на контролируемых лично сайтах, использующих самоподписанные сертификаты. |
| vserver строка / обязательно | Указывает vserver для политики SnapMirror. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create SnapMirror policy
na_ontap_snapmirror_policy:
state: present
vserver: "SVM1"
policy_name: "ansible_policy"
policy_type: "mirror_vault"
comment: "created by ansible"
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
https: true
validate_certs: false
- name: Modify SnapMirror policy
na_ontap_snapmirror_policy:
state: present
vserver: "SVM1"
policy_name: "ansible_policy"
policy_type: "async_mirror"
transfer_priority: "low"
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
https: true
validate_certs: false
- name: Create SnapMirror policy with basic rules
na_ontap_snapmirror_policy:
state: present
vserver: "SVM1"
policy_name: "ansible_policy"
policy_type: "async_mirror"
snapmirror_label: ['daily', 'weekly', 'monthly']
keep: [7, 5, 12]
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
https: true
validate_certs: false
- name: Create SnapMirror policy with rules and schedules (no schedule for daily rule)
na_ontap_snapmirror_policy:
state: present
vserver: "SVM1"
policy_name: "ansible_policy"
policy_type: "mirror_vault"
snapmirror_label: ['daily', 'weekly', 'monthly']
keep: [7, 5, 12]
schedule: ['','weekly','monthly']
prefix: ['','','monthly_mv']
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
https: true
validate_certs: false
- name: Modify SnapMirror policy with rules, remove existing schedules and prefixes
na_ontap_snapmirror_policy:
state: present
vserver: "SVM1"
policy_name: "ansible_policy"
policy_type: "mirror_vault"
snapmirror_label: ['daily', 'weekly', 'monthly']
keep: [7, 5, 12]
schedule: ['','','']
prefix: ['','','']
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
https: true
validate_certs: false
- name: Modify SnapMirror policy, delete all rules (excludes builtin rules)
na_ontap_snapmirror_policy:
state: present
vserver: "SVM1"
policy_name: "ansible_policy"
policy_type: "mirror_vault"
snapmirror_label: []
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
https: true
validate_certs: false
- name: Delete SnapMirror policy
na_ontap_snapmirror_policy:
state: absent
vserver: "SVM1"
policy_type: "async_mirror"
policy_name: "ansible_policy"
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
https: true
validate_certs: 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_snapmirror_policy_module.html