ibm.spectrum_virtualize.ibm_svc_manage_volumegroup 模块 – 此模块管理 IBM Spectrum Virtualize 系列存储系统上的卷组

注意

此模块是 ibm.spectrum_virtualize 集合 (版本 2.0.0) 的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install ibm.spectrum_virtualize。

要在 playbook 中使用它，请指定： ibm.spectrum_virtualize.ibm_svc_manage_volumegroup。

注意

ibm.spectrum_virtualize 集合已重命名为 ibm.storage_virtualize，并将从 Ansible 12 中移除。如果您使用 ibm.spectrum_virtualize 中的内容，请更新 playbook 和角色中的 FQCN！创建新的 playbook 或角色时，请直接使用 ibm.storage_virtualize 中的内容。

ibm.spectrum_virtualize 1.6.0 中的新增功能

概要 

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

参数 

参数	注释
clustername 字符串 / 必需	Spectrum Virtualize 存储系统的 hostname 或管理 IP。
domain 字符串	Spectrum Virtualize 存储系统的域名。当参数 clustername 使用 hostname 时有效。
fromsourcegroup 字符串在 ibm.spectrum_virtualize 1.9.0 中添加	指定快照的父卷组。这用于在新卷组中预填充新卷。在从现有快照创建主机可访问卷组期间有效。
ignoreuserfcmaps 字符串在 ibm.spectrum_virtualize 1.10.0 中添加	允许用户通过调度程序或使用 `addsnapshot` 手动创建快照。只有当卷组中的卷用作用户旧版 FlashCopy 映射的来源时，才能使用此功能。在创建和更新卷组期间有效。从 Spectrum Virtualize 系列存储系统 8.5.2.0 或更高版本支持。选项 `"yes"` `"no"`
iogrp 字符串在 ibm.spectrum_virtualize 1.9.0 中添加	指定新卷的 I/O 组。在从现有快照创建主机可访问卷组期间有效。
log_path 字符串	调试日志文件的路径。
name 字符串 / 必需	指定卷组的名称。
noownershipgroup 布尔值	如果指定为 `True`，则对象将从其所属的所有权组中移除。参数 ownershipgroup 和 noownershipgroup 是互斥的。当 state=present 用于修改现有卷组时适用。选项 `false` `true`
noreplicationpolicy 布尔值在 ibm.spectrum_virtualize 1.10.0 中添加	如果指定为 `True`，则移除分配给卷组的复制策略。参数 replicationpolicy 和 noreplicationpolicy 是互斥的。当 state=present 用于修改现有卷组时适用。从 Spectrum Virtualize 系列存储系统 8.5.2.1 或更高版本支持。选项 `false` `true`
nosafeguardpolicy 布尔值	如果指定为 `True`，则移除分配给卷组的安全策略。参数 safeguardpolicyname 和 nosafeguardpolicy 是互斥的。当 state=present 用于修改现有卷组时适用。选项 `false` `true`
nosnapshotpolicy 布尔值在 ibm.spectrum_virtualize 1.9.0 中添加	如果指定为 `True`，则移除分配给卷组的快照策略。参数 snapshotpolicy 和 nosnapshotpolicy 是互斥的。当 state=present 用于修改现有卷组时适用。选项 `false` `true`
ownershipgroup 字符串	指定要将对象添加到其中的所有权组的名称。 ownershipgroup 与参数 safeguardpolicyname 和 noownershipgroup 互斥。当 state=present 时适用。
password 字符串	Spectrum Virtualize 存储系统的 REST API 密码。如果不使用 token 验证用户，则参数 username 和 password 是必需的。
policystarttime 字符串	指定第一次执行安全备份的时间。此参数也可以与快照策略关联。使用 policystarttime 时，需要 safeguardpolicyname。可接受的格式为 YYMMDDHHMM。当 state=present 时适用。
pool 字符串在 ibm.spectrum_virtualize 1.9.0 中添加	指定要创建目标卷的池名称。在从现有快照创建主机可访问卷组期间有效。
replicationpolicy 字符串在 ibm.spectrum_virtualize 1.10.0 中添加	指定要分配给卷组的复制策略的名称。当 state=present 时适用。从 Spectrum Virtualize 系列存储系统 8.5.2.1 或更高版本支持。
safeguarded 布尔值在 ibm.spectrum_virtualize 1.10.0 中添加	如果指定，则快照策略将创建受保护的快照。应与 snapshotpolicy 一起指定。在创建和更新卷组期间有效。从 Spectrum Virtualize 系列存储系统 8.5.2.0 或更高版本支持。选项 `false` ← (默认) `true`
safeguardpolicyname 字符串	要分配给卷组的安全策略的名称。 safeguardpolicyname 与参数 nosafeguardpolicy 和 ownershipgroup 互斥。当 state=present 时适用。
snapshot 字符串在 ibm.spectrum_virtualize 1.9.0 中添加	指定用于在新卷组中预填充新卷的快照的名称。从现有快照创建主机可访问卷组时需要。
snapshotpolicy 字符串在 ibm.spectrum_virtualize 1.9.0 中添加	要分配给卷组的快照策略的名称。 snapshotpolicy 与参数 nosnapshotpolicy 和 ownershipgroup 互斥。当 state=present 时适用。
snapshotpolicysuspended 字符串在 ibm.spectrum_virtualize 1.9.0 中添加	指定是否暂停 (`yes`) 或恢复 (`no`) 此卷组上的快照策略。当 state=present 用于修改现有卷组时适用。选项 `"yes"` `"no"`
state 字符串 / 必需	创建或更新 (`present`) 或移除 (`absent`) 卷组。选项 `"absent"` `"present"`
token 字符串	用于在 Spectrum Virtualize 存储系统上验证用户的身份验证令牌。要生成令牌，请使用 ibm.spectrum_virtualize.ibm_svc_auth 模块。
type 字符串在 ibm.spectrum_virtualize 1.9.0 中添加	指定要从快照创建的卷组的类型。在从现有快照创建主机可访问卷组期间有效。选项 `"clone"` `"thinclone"`
username 字符串	Spectrum Virtualize 存储系统的 REST API 用户名。如果不使用 token 验证用户，则参数 username 和 password 是必需的。
validate_certs 布尔值	验证证书。选项 `false` ← (默认) `true`

备注 

注意

此模块支持check_mode。
安全策略和快照策略不能同时使用。因此，参数snapshotpolicy和safeguardpolicyname是互斥的。

示例 

- name: Create a new volume group
  ibm.spectrum_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.spectrum_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.spectrum_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.spectrum_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.spectrum_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.spectrum_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.spectrum_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

作者

Shilpi Jain(@Shilpi-J)
Sanjaikumaar M (@sanjaikumaar)

ibm.spectrum_virtualize.ibm_svc_manage_volumegroup 模块 – 此模块管理 IBM Spectrum Virtualize 系列存储系统上的卷组

概要

参数

备注

示例

作者

相关链接

概要 

参数 

备注 

示例 