ibm.storage_virtualize.ibm_svc_manage_flashcopy 模块 – 此模块管理 IBM Storage Virtualize 系列系统上的 FlashCopy 映射

注意

此模块是 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_svc_manage_flashcopy。

ibm.storage_virtualize 1.4.0 中的新增功能

概要 

Ansible 接口用于管理“mkfcmap”、“rmfcmap”和“chfcmap”卷命令。此模块配置“克隆”、“快照”或“备份”类型的 FlashCopy 映射。

参数 

参数	注释
clustername 字符串 / 必需	Storage Virtualize 系统的主机名或管理 IP。
consistgrp 字符串	指定要向其添加 FlashCopy 映射的一致性组的名称。参数 consistgrp 和 noconsistgrp 互斥。当 state=present 时有效，用于创建或修改 FlashCopy 映射。
copyrate 字符串	指定复制速率。速率在 0-150 之间变化。如果未指定，则使用克隆的默认复制速率 50 和快照的 0。当 state=present 时有效，用于创建或修改 FlashCopy 映射。
copytype 字符串	创建 FlashCopy 映射时指定复制类型。当 state=present 时必需，用于创建 FlashCopy 映射。选项 `"snapshot"` `"clone"` `"backup"`
domain 字符串	Storage Virtualize 系统的域。当对参数 clustername 使用主机名时有效。
force 布尔值	使目标卷联机。如果 FlashCopy 映射处于停止状态，则需要此参数。当 state=absent 时有效，用于删除 FlashCopy 映射。选项 `false` `true`
grainsize 字符串	指定 FlashCopy 映射的粒度大小。 grainsize 可以设置为 64 或 256。默认值为 256。当 state=present 时有效，用于创建 FlashCopy 映射。
log_path 字符串	调试日志文件的路径。
mdiskgrp 字符串	指定创建目标卷时要使用的存储池的名称。如果未指定，则使用与源卷关联的池。当 state=present 时有效，用于创建 FlashCopy 映射。
name 字符串 / 必需	指定 FlashCopy 映射的名称。
noconsistgrp 布尔值	如果指定为 True，则 FlashCopy 映射将从一致性组中移除。参数 noconsistgrp 和 consistgrp 互斥。当 state=present 时有效，用于修改 FlashCopy 映射。选项 `false` `true`
old_name 字符串	指定 mdiskgrp 的旧名称。当 state=present 时适用，用于重命名现有 mdiskgrp。
password 字符串	Storage Virtualize 系统的 REST API 密码。如果不使用 token 来验证用户，则需要参数 username 和 password。
source 字符串	指定源卷的名称。当 state=present 时必需，用于创建 FlashCopy 映射。
state 字符串 / 必需	创建或更新 (`present`) 或删除 (`absent`) FlashCopy 映射。选项 `"present"` `"absent"`
target 字符串	指定目标卷的名称。当 state=present 时必需，用于创建 FlashCopy 映射。
token 字符串在 ibm.storage_virtualize 1.5.0 中添加	用于验证 Storage Virtualize 系统上用户的身份验证令牌。要生成令牌，请使用 ibm_svc_auth 模块。
username 字符串	Storage Virtualize 系统的 REST API 用户名。如果不使用 token 来验证用户，则需要参数 username 和 password。
validate_certs 布尔值	验证证书。选项 `false` ← (默认) `true`

备注 

注意

此模块支持 check_mode。

示例 

- name: Create FlashCopy mapping for snapshot
  ibm.storage_virtualize.ibm_svc_manage_flashcopy:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    state: present
    name: snapshot-name
    copytype: snapshot
    source: source-volume-name
    target: target-volume-name
    mdiskgrp: Pool0
    consistgrp: consistencygroup-name
    copyrate: 50
    grainsize: 64
- name: Create FlashCopy mapping for clone
  ibm.storage_virtualize.ibm_svc_manage_flashcopy:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    state: present
    name: snapshot-name
    copytype: clone
    source: source-volume-name
    target: target-volume-name
    mdiskgrp: Pool0
    consistgrp: consistencygroup-name
    copyrate: 50
    grainsize: 64
- name: Create FlashCopy mapping for backup
  ibm.storage_virtualize.ibm_svc_manage_flashcopy:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    state: present
    name: snapshot-name
    copytype: backup
    source: source-volume-name
    target: target-volume-name
    mdiskgrp: Pool0
    copyrate: 50
    grainsize: 64
- name: Delete FlashCopy mapping for snapshot
  ibm.storage_virtualize.ibm_svc_manage_flashcopy:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: snapshot-name
    state: absent
    force: true
- name: Delete FlashCopy mapping for clone
  ibm.storage_virtualize.ibm_svc_manage_flashcopy:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: clone-name
    state: absent
    force: true

作者

Sreshtant Bohidar(@Sreshtant-Bohidar)