netapp.ontap.na_ontap_snapmirror_policy – NetApp ONTAP создание, удаление или изменение политик SnapMirror
Примечание
Этот плагин входит в коллекцию netapp.ontap (версия 21.1.1).
Для его установки используйте: 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’
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Ansible 2.9
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью ‘pip install netapp-lib’
- netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает лучшую обработку ошибок при подключении.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и выше.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Чтобы включить 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 строка | По умолчанию: "авто" | REST API, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае будет использоваться ZAPI. всегда -- всегда использовать REST API никогда -- всегда использовать ZAPI авто -- попытаться использовать REST API |
| username строка | Это может быть учетная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Для получения дополнительной информации обратитесь к документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. аутентификация по протоколу basic, используя имя пользователя и пароль, 2. аутентификация по SSL-сертификату, используя файл SSL-сертификата клиента, и необязательно файл закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам. псевдонимы: user | |
| validate_certs булево |
| Если установлено в no, SSL-сертификаты не будут проверены.Это следует устанавливать только в False используемых на сайтах с собственным контролем, использующих самозаверяемые сертификаты. |
| vserver строка / обязательно | Указывает SVM для политики 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
Авторы
- Команда Ansible NetApp (@carchi8py) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/netapp/ontap/na_ontap_snapmirror_policy_module.html