ibm.storage_virtualize.ibm_sv_manage_snapshot 模块 – 此模块管理 IBM Storage Virtualize 系列系统上的快照（卷的 PiT 镜像）

注意

此模块是 ibm.storage_virtualize 集合（版本 2.5.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 模块提供通过“addsnapshot”、“chsnapshot”和“rmsnapshot”Storage Virtualize 命令管理快照的接口。

参数

参数

注释

clustername

字符串 / 必需

Storage Virtualize 系统的主机名或管理 IP。

domain

字符串

Storage Virtualize 系统的域。

当使用主机名作为参数 *clustername* 时有效。

ignorelegacy

布尔值

即使已经有使用卷作为源的旧版 FlashCopy 映射，也指定添加卷快照。

选项

  • false ← (默认)

  • true

log_path

字符串

调试日志文件的路径。

name

字符串

指定快照的名称。

old_name

字符串

指定快照的旧名称。

当 *state=present* 时有效，用于重命名现有快照。

ownershipgroup

字符串

指定所有者组的名称。

当 *state=present* 时有效，用于更新现有快照。

password

字符串

Storage Virtualize 系统的 REST API 密码。

如果不使用 *token* 来验证用户，则需要 *username* 和 *password* 参数。

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

字符串

指定要为其创建快照的卷的名称。

可以使用冒号分隔符指定卷名称列表。

当 *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

字符串

Storage Virtualize 系统的 REST API 用户名。

如果不使用 *token* 来验证用户，则需要 *username* 和 *password* 参数。

validate_certs

布尔值

验证证书。

选项

  • false ← (默认)

  • true

备注

注意

示例

- 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

作者

  • Sanjaikumaar M (@sanjaikumaar)

  • Sumit Kumar Gupta (@sumitguptaibm)