Модуль netapp.ontap.na_ontap_cg_snapshot — Управление моментальными снимками групп согласованности NetApp ONTAP

Примечание

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

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

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

Чтобы использовать его в playbook, укажите: netapp.ontap.na_ontap_cg_snapshot.

Новый в netapp.ontap 2.7.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 или новее

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
cert_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу сертификата SSL-клиента (.pem). не поддерживается с python 2.6.
comment строка добавлен в netapp.ontap 22.8.0	Комментарий к копии снимка. Поддерживается только с REST.
consistency_group строка добавлен в netapp.ontap 22.8.0	Имя группы согласованности, для которой необходимо создать или удалить снимок. Допустимо только с REST.
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, где каждый элемент является целым числом. Когда `use_rest` задано в значение auto, это может привести к переключению на ZAPI в зависимости от версии и возможностей платформы. Игнорируется с ZAPI.
hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить стандартный порт (80 или 443) на этот порт.
https логическое	Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по сертификату SSL, так как она требует SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу закрытого ключа SSL-клиента.
ontapi целое число	Используемая версия API ontap
password псевдонимы: pass строка	Пароль для указанного пользователя.
snapmirror_label строка	Легко читаемый тег SnapMirror для прикрепления к снимкам копии группы согласованности.
snapshot строка / обязательно	Указанное имя снимка, создаваемого в каждом томе.
state строка	Указывает, создавать или удалять снимок. Значение ‘absent’ допустимо только с REST. Варианты: `"present"` ← (по умолчанию) `"absent"`
timeout строка	Выбор таймаута. Не поддерживается с REST. Варианты: `"urgent"` `"medium"` ← (по умолчанию) `"relaxed"`
use_rest строка	Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль его поддерживает. Выводится предупреждение, если модуль не поддерживает REST. Выводится ошибка, если опция модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если опция REST не поддерживается в ZAPI. auto – попытается использовать REST API, если модуль его поддерживает и опции модуля поддерживаются. В противном случае переключается на ZAPI. По умолчанию: `"auto"`
username псевдонимы: user строка	Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации: базовая аутентификация, с использованием имени пользователя и пароля, аутентификация по сертификату SSL, с использованием файла сертификата SSL-клиента и необязательно файла закрытого ключа. Для использования сертификата, сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам.

END_OF_DOCUMENT_MARKER

validate_certs boolean	Если установлено в `no`, сертификаты SSL не будут проверяться. Это следует устанавливать только в `False` для сайтов с самоподписанными сертификатами, находящимися под вашим контролем. Варианты: `false` `true` ← (по умолчанию)
volumes список / элементы=строка	Список томов на этом файловом сервере, которые являются частью этой операции с группой согласованности. Требуется для ZAPI.
vserver строка / обязательно	Имя vserver.

Примечания

Примечание

Поддержка REST требует ONTAP 9.10 или более поздней версии.
Операция удаления поддерживается только с REST.
Модули, начинающиеся с префикса na_ontap, разработаны для поддержки платформы хранения ONTAP.
https включён по умолчанию и рекомендуется. Для включения http на кластере необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name:
  na_ontap_cg_snapshot:
    state: present
    vserver: vserver_name
    snapshot: snapshot name
    volumes: vol_name
    username: "{{ netapp username }}"
    password: "{{ netapp password }}"
    hostname: "{{ netapp hostname }}"

- name: Create CG snapshot using CG name - REST
  na_ontap_cg_snapshot:
    state: present
    vserver: vserver_name
    snapshot: snapshot_name
    consistency_group: cg_name
    snapmirror_label: sm_label
    username: "{{ netapp username }}"
    password: "{{ netapp password }}"
    hostname: "{{ netapp hostname }}"

- name: Create CG snapshot using volumes - REST
  na_ontap_cg_snapshot:
    state: present
    vserver: vserver_name
    snapshot: snapshot_name
    volumes:
      - vol1
      - vol2
    snapmirror_label: sm_label
    username: "{{ netapp username }}"
    password: "{{ netapp password }}"
    hostname: "{{ netapp hostname }}"

- name: Delete CG snapshot - REST
  na_ontap_cg_snapshot:
    state: absent
    vserver: vserver_name
    snapshot: snapshot_name
    consistency_group: cg_name
    username: "{{ netapp username }}"
    password: "{{ netapp password }}"
    hostname: "{{ netapp hostname }}"

Авторы

Команда Ansible NetApp (@carchi8py)

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

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