Модуль ibm.storage_virtualize.ibm_sv_manage_snapshot – Этот модуль управляет моментальными снимками (изображениями точек восстановления объёмов) на системах IBM Storage Virtualize
Примечание
Этот модуль входит в коллекцию ibm.storage_virtualize (версия 2.5.0).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install ibm.storage_virtualize.
Чтобы использовать её в playbook, укажите: ibm.storage_virtualize.ibm_sv_manage_snapshot.
Новое в ibm.storage_virtualize 1.9.0
Обзор
- В этой реализации моментальный снимок — это согласованное изображение объёмов в группе объёмов или списка независимых объёмов.
- Этот модуль Ansible предоставляет интерфейс для управления моментальными снимками с помощью команд Storage Virtualize «addsnapshot», «chsnapshot» и «rmsnapshot».
Параметры
Параметр | Комментарии |
|---|---|
clustername строка / обязательно | Имя хоста или IP-адрес управления системой Storage Virtualize. |
domain строка | Домен системы Storage Virtualize. Действительно, когда для параметра clustername используется имя хоста. |
ignorelegacy логическое значение | Указывает на добавление снимков тома, хотя уже существуют сопоставления FlashCopy legacy, использующие том в качестве источника. Варианты:
|
log_path строка | Путь к файлу журнала отладки. |
name строка | Указывает имя снимка. |
old_name строка | Указывает старое имя снимка. Действительно, когда state=present, для переименования существующего снимка. |
ownershipgroup строка | Указывает имя группы владельцев. Действительно, когда state=present, для обновления существующего снимка. |
password строка | Пароль API REST для системы 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 или более поздней. Варианты:
|
snapshot_pool строка | Указывает имя дочернего пула, в котором создаётся снимок. |
src_volume_names строка | Указывает имена томов, для которых будут созданы снимки. Список имён томов можно указать с разделителем двоеточие. Действительно, когда state=present, для создания снимка. |
src_volumegroup_name строка | Указывает имя группы томов-источников, для которой создаётся снимок. src_volumegroup_name и src_volume_names взаимно исключают друг друга при создании снимка. Требуется один из параметров src_volumegroup_name или src_volume_names для создания снимка. |
state строка / обязательно | Создаёт, обновляет ( Варианты:
|
token строка | Токен аутентификации для проверки пользователя в системе Storage Virtualize. Для генерации токена используйте модуль ibm.storage_virtualize.ibm_svc_auth. |
username строка | Имя пользователя API REST для системы Storage Virtualize. Параметры username и password необходимы, если не используется token для аутентификации пользователя. |
validate_certs логическое значение | Проверка сертификатов. Варианты:
|
Примечания
Примечание
- Этот модуль поддерживает
check_mode. - Этот модуль автоматизирует новую функцию создания моментальных снимков, реализованную в Storage Virtualize, которая использует упрощенную модель управления. Пользователи, которым требуется гибкость, доступная с устаревшим FlashCopy, могут продолжить использование существующего модуля ibm.storage_virtualize.ibm_svc_manage_flashcopy.
- Моментальные снимки, созданные этим модулем Ansible, не доступны напрямую с хостов. Чтобы создать новую группу доступных хостам томов из моментального снимка, используйте модуль ibm.storage_virtualize.ibm_svc_manage_volumegroup.
Примеры
- 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
snapshot_pool: Pool0Childpool0
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
snapshot_pool: Pool0Childpool0
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
Ссылки на сборку
© 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/ibm/storage_virtualize/ibm_sv_manage_snapshot_module.html