Spec-Zone.ru › Ansible 2.11

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
строка
    Варианты:
  • cluster_admin
  • vserver_admin
Указывает владельца политики SnapMirror.
password
строка
Пароль для указанного пользователя.

псевдонимы: pass
policy_name
строка / обязательно
Указывает имя политики SnapMirror.
policy_type
строка
    Варианты:
  • хранилище
  • async_mirror
  • mirror_vault
  • strict_sync_mirror
  • sync_mirror
Указывает тип политики 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API