Модуль ibm.storage_virtualize.ibm_sv_manage_snapshot — управление моментальными снимками (образами тома на определённый момент времени) в системах семейства IBM Storage Virtualize

Примечание

Этот модуль входит в коллекцию ibm.storage_virtualize (версия 3.3.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install ibm.storage_virtualize.

Чтобы использовать её в плейбуке, укажите: ibm.storage_virtualize.ibm_sv_manage_snapshot.

Добавлено в ibm.storage_virtualize 1.9.0

Краткое описание
Параметры
Примечания
Примеры

Краткое описание

В этой реализации моментальный снимок представляет собой взаимно согласованный образ томов в группе томов или списка независимых томов.
Этот модуль Ansible предоставляет интерфейс для управления моментальными снимками с помощью команд Storage Virtualize «addsnapshot», «chsnapshot» и «rmsnapshot».

Параметры

Параметр	Комментарии
clustername строка / обязательный	Имя хоста, IP-адрес управления или IP-адрес раздела системы Storage Virtualize.
domain строка	Домен системы Storage Virtualize. Допустимо, если для параметра clustername указано имя хоста.
ignorelegacy логический	Указывает, следует ли добавлять моментальные снимки тома, даже если уже существуют устаревшие сопоставления FlashCopy, использующие этот том в качестве источника. Варианты: `false` ← (по умолчанию) `true`
log_path строка	Путь к файлу журнала отладки.
name строка	Указывает имя моментального снимка.
old_name строка	Указывает прежнее имя моментального снимка. Допустимо при state=present для переименования существующего моментального снимка.
ownershipgroup строка	Указывает имя группы владельцев. Допустимо при state=present для обновления существующего моментального снимка.
password строка	Пароль REST API для системы Storage Virtualize. Параметры username и password обязательны, если для аутентификации пользователя не используется token.
retentiondays целое число добавлено в ibm.storage_virtualize 1.10.0	Указывает срок хранения в днях. Параметры safeguarded и retentiondays необходимо указывать вместе. Применяется при state=present для создания защищённого моментального снимка.
retentionminutes целое число добавлено в ibm.storage_virtualize 2.3.0	Указывает срок хранения в минутах в диапазоне от 1 до 1440. Параметры retentionminutes и retentiondays являются взаимоисключающими. Применяется при state=present для создания временного моментального снимка.
safeguarded логический добавлено в ibm.storage_virtualize 1.10.0	Флаг для создания защищённого моментального снимка. Параметры safeguarded и retentiondays необходимо указывать вместе. Поддерживается в сборках SV 8.5.2.0 и новее. Варианты: `false` `true`
snapshot_pool строка	Указывает имя дочернего пула, в котором создаётся моментальный снимок.
src_volume_names строка	Указывает имя/UID томов, для которых создаются моментальные снимки. Список имён томов можно указать, разделив их двоеточиями. Допустимо при state=present для создания моментального снимка.
src_volumegroup_name строка	Указывает имя исходной группы томов, для которой создаётся моментальный снимок. Параметры src_volumegroup_name и src_volume_names являются взаимоисключающими при создании моментального снимка. Для создания моментального снимка необходимо указать один из параметров: src_volumegroup_name или src_volume_names.
state строка / обязательный	Создаёт, обновляет (`present`), восстанавливает из (`restore`) или удаляет (`absent`) моментальный снимок. Варианты: `"present"` `"restore"` `"absent"`
token строка	Токен аутентификации для проверки пользователя в системе Storage Virtualize. Чтобы сгенерировать токен, используйте модуль ibm.storage_virtualize.ibm_svc_auth.
username строка	Имя пользователя REST API для системы Storage Virtualize. Параметры username и password обязательны, если для аутентификации пользователя не используется token.
validate_certs логический	Проверяет сертификат. Варианты: `false` ← (по умолчанию) `true`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль автоматизирует новую функцию Snapshot, реализованную в Storage Virtualize и использующую упрощённую модель управления. Пользователи, которым необходима гибкость устаревшей функции FlashCopy, могут продолжить использовать существующий модуль ibm.storage_virtualize.ibm_svc_manage_flashcopy.
Моментальные снимки, созданные этим модулем Ansible, недоступны напрямую с хостов. Чтобы создать из моментального снимка новую группу томов, доступных хостам, используйте модуль ibm.storage_virtualize.ibm_svc_manage_volumegroup.
При восстановлении локальных моментальных снимков, существовавших до настройки высокой доступности (HA), синхронизация HA будет приостановлена до завершения восстановления снимков.
Этот модуль поддерживает вход в систему через IP-адрес раздела.

Примеры

- name: Create volumegroup snapshot
  ibm.storage_virtualize.ibm_sv_manage_snapshot:
   clustername: '{{ clustername }}'
   username: '{{ username }}'
   password: '{{ password }}'
   name: ansible_1
   src_volumegroup_name: volumegroup1
   snapshot_pool: Pool0Childpool0
   state: present
- name: Create volumes snapshot
  ibm.storage_virtualize.ibm_sv_manage_snapshot:
   clustername: '{{ clustername }}'
   username: '{{ username }}'
   password: '{{ password }}'
   name: ansible_2
   src_volume_names: vdisk0:vdisk1
   snapshot_pool: Pool0Childpool0
   state: present
- name: Create safeguarded snapshot
  ibm.storage_virtualize.ibm_sv_manage_snapshot:
   clustername: '{{ clustername }}'
   username: '{{ username }}'
   password: '{{ password }}'
   name: ansible_2
   src_volume_names: vdisk0:vdisk1
   safeguarded: true
   retentiondays: 1
   snapshot_pool: Pool0Childpool0
   state: present
- name: Update snapshot ansible_2
  ibm.storage_virtualize.ibm_sv_manage_snapshot:
   clustername: '{{ clustername }}'
   username: '{{ username }}'
   password: '{{ password }}'
   name: ansible_new
   old_name: ansible_2
   ownershipgroup: ownershipgroup0
   state: present
- name: Restore all volumes of a volumegroup from a snapshot
  ibm.storage_virtualize.ibm_sv_manage_snapshot:
   clustername: '{{ clustername }}'
   username: '{{ username }}'
   password: '{{ password }}'
   name: snapshot0
   src_volumegroup_name: volumegroup1
   state: restore
- name: Restore subset of volumes of a volumegroup from snapshot
  ibm.storage_virtualize.ibm_sv_manage_snapshot:
   clustername: '{{ clustername }}'
   username: '{{ username }}'
   password: '{{ password }}'
   name: snapshot0
   src_volumegroup_name: volumegroup1
   src_volume_names: vdisk0:vdisk1
   state: restore
- name: Create transient snapshot
  ibm.storage_virtualize.ibm_sv_manage_snapshot:
   clustername: '{{ clustername }}'
   username: '{{ username }}'
   password: '{{ password }}'
   name: snapshot0
   src_volume_names: vdisk0:vdisk1
   safeguarded: true
   retentionminutes: 5
   snapshot_pool: Pool0Childpool0
   state: present
- name: Delete volumegroup snapshot
  ibm.storage_virtualize.ibm_sv_manage_snapshot:
   clustername: '{{ clustername }}'
   username: '{{ username }}'
   password: '{{ password }}'
   name: ansible_1
   src_volumegroup_name: volumegroup1
   state: absent
- name: Delete volume snapshot
  ibm.storage_virtualize.ibm_sv_manage_snapshot:
   clustername: '{{ clustername }}'
   username: '{{ username }}'
   password: '{{ password }}'
   name: ansible_new
   state: absent

Авторы

Sanjaikumaar M (@sanjaikumaar)
Sumit Kumar Gupta (@sumitguptaibm)

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

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ibm/storage_virtualize/ibm_sv_manage_snapshot_module.html