ibm.storage_virtualize.ibm_svc_manage_volumegroup 模块 – 此模块管理 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_svc_manage_volumegroup

ibm.storage_virtualize 1.6.0 中的新增功能

概要

  • 用于管理 'mkvolumegroup'、'chvolumegroup' 和 'rmvolumegroup' 命令的 Ansible 接口。

参数

参数

注释

clustername

字符串 / 必需

Storage Virtualize 系统的hostname 或管理 IP。

domain

字符串

Storage Virtualize 系统的域。

当 hostname 用于参数 clustername 时有效。

draftpartition

字符串

在 ibm.storage_virtualize 2.5.0 中添加

指定要分配给卷组的草稿分区名称。

state=present 时适用。

支持 Storage Virtualize 系列系统 8.6.3.0 或更高版本。

evictvolumes

布尔值

在 ibm.storage_virtualize 2.2.0 中添加

如果指定为 `True`,则删除卷组,但不删除卷。

state=absent 时适用,删除卷组,保留关联的卷。

支持 Storage Virtualize 系列系统 8.6.2.0 或更高版本。

选择

  • false

  • true

fromsourcegroup

字符串

在 ibm.storage_virtualize 1.9.0 中添加

指定快照的父卷组。 这用于在新卷组中预填充新卷。

在从现有快照创建主机可访问卷组时有效。

fromsourcevolumes

字符串

在 ibm.storage_virtualize 2.3.0 中添加

指定父卷的冒号分隔列表。

当与类型参数和快照结合使用时,这允许用户创建卷组,其中包含快照中存在映像的那些卷的子集。

state=present 时适用,从快照的卷子集创建卷组克隆或瘦克隆。

支持 Storage Virtualize 系列系统 8.6.2.0 或更高版本。

ignoreuserfcmaps

字符串

在 ibm.storage_virtualize 1.10.0 中添加

允许用户通过调度程序或使用 `addsnapshot` 手动创建快照。 只有当卷组中的卷用作用户遗留 FlashCopy 映射的源时,才能使用此功能。

在创建和更新卷组期间有效。

支持 Storage Virtualize 系列系统 8.5.2.0 或更高版本。

选择

  • "yes"

  • "no"

iogrp

字符串

在 ibm.storage_virtualize 1.9.0 中添加

指定新卷的 I/O 组。

在从现有快照创建主机可访问卷组时有效。

log_path

字符串

调试日志文件的路径。

name

字符串 / 必需

指定卷组的名称。

noownershipgroup

布尔值

如果指定为 `True`,则将对象从其所属的所有权组中移除。

参数 ownershipgroupnoownershipgroup 是互斥的。

state=present 时适用,修改现有卷组。

选择

  • false

  • true

nopartition

布尔值

在 ibm.storage_virtualize 2.1.0 中添加

如果指定为 `True`,则将卷组从存储分区中移除。

参数 partitionnopartition 是互斥的。

state=present 时适用,修改现有卷组。

支持 Storage Virtualize 系列系统 8.6.1.0 或更高版本。

选择

  • false

  • true

noreplicationpolicy

布尔值

在 ibm.storage_virtualize 1.10.0 中添加

如果指定为 `True`,则移除分配给卷组的复制策略。

参数 replicationpolicynoreplicationpolicy 是互斥的。

state=present 时适用,修改现有卷组。

支持 Storage Virtualize 系列系统 8.5.2.1 或更高版本。

选择

  • false

  • true

nosafeguardpolicy

布尔值

如果指定为 `True`,则移除分配给卷组的 Safeguarded 策略。

参数 safeguardpolicynamenosafeguardpolicy 是互斥的。

state=present 时适用,修改现有卷组。

选择

  • false

  • true

nosnapshotpolicy

布尔值

在 ibm.storage_virtualize 1.9.0 中添加

如果指定为 `True`,则移除分配给卷组的快照策略。

参数 snapshotpolicynosnapshotpolicy 是互斥的。

state=present 时适用,修改现有卷组。

选择

  • false

  • true

old_name

字符串

在 ibm.storage_virtualize 2.0.0 中添加

指定重命名期间卷组的旧名称。

state=present 时有效,重命名现有卷组。

ownershipgroup

字符串

指定要将对象添加到的所有权组的名称。

ownershipgroup 与参数 safeguardpolicynamenoownershipgroup 互斥。

state=present 时适用。

partition

字符串

在 ibm.storage_virtualize 2.1.0 中添加

指定要分配给卷组的存储分区的名称。

state=present 时适用。

支持 Storage Virtualize 系列系统 8.6.1.0 或更高版本。

password

字符串

Storage Virtualize 系统的 REST API 密码。

如果未使用 token 来验证用户身份,则需要参数 usernamepassword

policystarttime

字符串

指定要进行首次 Safeguarded 备份的时间。

此参数也可以与快照策略关联。

使用 policystarttime 时,需要 safeguardpolicyname

接受的格式为 YYMMDDHHMM。

state=present 时适用。

pool

字符串

在 ibm.storage_virtualize 1.9.0 中添加

指定要创建目标卷的池名称。

在从现有快照创建主机可访问卷组时有效。

replicationpolicy

字符串

在 ibm.storage_virtualize 1.10.0 中添加

指定要分配给卷组的复制策略的名称。

state=present 时适用。

支持 Storage Virtualize 系列系统 8.5.2.1 或更高版本。

safeguarded

布尔值

在 ibm.storage_virtualize 1.10.0 中添加

如果指定,快照策略将创建受保护的快照。

应与 snapshotpolicy 一起指定。

在创建和更新卷组期间有效。

支持 Storage Virtualize 系列系统 8.5.2.0 或更高版本。

选择

  • false ← (默认)

  • true

safeguardpolicyname

字符串

要分配给卷组的受保护策略的名称。

safeguardpolicyname 与参数 nosafeguardpolicyownershipgroup 互斥。

state=present 时适用。

snapshot

字符串

在 ibm.storage_virtualize 1.9.0 中添加

指定用于预填充新卷组中新卷的快照的名称。

从现有快照创建主机可访问的卷组时是必需的。

snapshotpolicy

字符串

在 ibm.storage_virtualize 1.9.0 中添加

要分配给卷组的快照策略的名称。

snapshotpolicy 与参数 nosnapshotpolicyownershipgroup 互斥。

state=present 时适用。

snapshotpolicysuspended

字符串

在 ibm.storage_virtualize 1.9.0 中添加

指定是否在此卷组上暂停(yes)或恢复(no)快照策略。

state=present 时适用,修改现有卷组。

选择

  • "yes"

  • "no"

state

字符串 / 必需

创建或更新(present)或删除(absent)卷组。

选择

  • "absent"

  • "present"

token

字符串

用于在 Storage Virtualize 系统上验证用户的身份验证令牌。

要生成令牌,请使用 ibm.storage_virtualize.ibm_svc_auth 模块。

type

字符串

在 ibm.storage_virtualize 1.9.0 中添加

指定要从快照创建的卷组的类型。

在从现有快照创建主机可访问卷组时有效。

选择

  • "clone"

  • "thinclone"

username

字符串

用于 Storage Virtualize 系统的 REST API 用户名。

如果未使用 token 来验证用户身份,则需要参数 usernamepassword

validate_certs

布尔值

验证证书。

选择

  • false ← (默认)

  • true

备注

注意

  • 此模块支持 check_mode

  • 受保护策略和快照策略不能同时使用。因此,参数 snapshotpolicysafeguardpolicyname 是互斥的。

示例

- name: Create a new volume group
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: present
- name: Delete a volume group
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: absent
- name: Update existing volume group to remove ownershipgroup and attach a safeguardpolicy to it
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: present
    noownershipgroup: True
    safeguardpolicyname: sg1
- name: Update volumegroup with snapshot policy and remove safeguarded policy
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    nosafeguardpolicy: true
    snapshotpolicy: sp1
    state: present
- name: Update volumegroup with safeguarded snapshot policy and ignoreuserfcmaps
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    safeguarded: true
    snapshotpolicy: sp1
    ignoreuserfcmaps: yes
    state: present
- name: Suspend snapshot policy in an existing volume group
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    snapshotpolicysuspended: true
    state: present
- name: Create host accessible volume group from an existing snapshot
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: host_accessible_vg
    type: clone
    snapshot: snapshot0
    fromsourcegroup: vg0
    pool: Pool0
    state: present
- name: Create a volumegroup thinclone from a list of volumes
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    type: thinclone
    fromsourcevolumes: vol1:vol2
    pool: Pool0
    state: present
- name: Create a volumegroup clone from a list of volumes
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    type: clone
    fromsourcevolumes: vol1:vol2
    pool: Pool0
    state: present
- name: Delete a volume group, keeping volumes which were associated with volumegroup
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: absent
    evictvolumes: true
- name: Add new or existing volumegroup to a draft partition
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: present
    draftpartition: partition_name

作者

  • Shilpi Jain(@Shilpi-J)

  • Sanjaikumaar M (@sanjaikumaar)

  • Sumit Kumar Gupta (@sumitguptaibm)

  • Sandip G. Rajbanshi (@Sandip-Rajbanshi)