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 接口。
参数
参数 |
注释 |
---|---|
Storage Virtualize 系统的hostname 或管理 IP。 |
|
Storage Virtualize 系统的域。 当 hostname 用于参数 clustername 时有效。 |
|
指定要分配给卷组的草稿分区名称。 当 state=present 时适用。 支持 Storage Virtualize 系列系统 8.6.3.0 或更高版本。 |
|
如果指定为 `True`,则删除卷组,但不删除卷。 当 state=absent 时适用,删除卷组,保留关联的卷。 支持 Storage Virtualize 系列系统 8.6.2.0 或更高版本。 选择
|
|
指定快照的父卷组。 这用于在新卷组中预填充新卷。 在从现有快照创建主机可访问卷组时有效。 |
|
指定父卷的冒号分隔列表。 当与类型参数和快照结合使用时,这允许用户创建卷组,其中包含快照中存在映像的那些卷的子集。 当 state=present 时适用,从快照的卷子集创建卷组克隆或瘦克隆。 支持 Storage Virtualize 系列系统 8.6.2.0 或更高版本。 |
|
允许用户通过调度程序或使用 `addsnapshot` 手动创建快照。 只有当卷组中的卷用作用户遗留 FlashCopy 映射的源时,才能使用此功能。 在创建和更新卷组期间有效。 支持 Storage Virtualize 系列系统 8.5.2.0 或更高版本。 选择
|
|
指定新卷的 I/O 组。 在从现有快照创建主机可访问卷组时有效。 |
|
调试日志文件的路径。 |
|
指定卷组的名称。 |
|
如果指定为 `True`,则将对象从其所属的所有权组中移除。 参数 ownershipgroup 和 noownershipgroup 是互斥的。 当 state=present 时适用,修改现有卷组。 选择
|
|
如果指定为 `True`,则将卷组从存储分区中移除。 参数 partition 和 nopartition 是互斥的。 当 state=present 时适用,修改现有卷组。 支持 Storage Virtualize 系列系统 8.6.1.0 或更高版本。 选择
|
|
如果指定为 `True`,则移除分配给卷组的复制策略。 参数 replicationpolicy 和 noreplicationpolicy 是互斥的。 当 state=present 时适用,修改现有卷组。 支持 Storage Virtualize 系列系统 8.5.2.1 或更高版本。 选择
|
|
如果指定为 `True`,则移除分配给卷组的 Safeguarded 策略。 参数 safeguardpolicyname 和 nosafeguardpolicy 是互斥的。 当 state=present 时适用,修改现有卷组。 选择
|
|
如果指定为 `True`,则移除分配给卷组的快照策略。 参数 snapshotpolicy 和 nosnapshotpolicy 是互斥的。 当 state=present 时适用,修改现有卷组。 选择
|
|
指定重命名期间卷组的旧名称。 当 state=present 时有效,重命名现有卷组。 |
|
指定要将对象添加到的所有权组的名称。 ownershipgroup 与参数 safeguardpolicyname 和 noownershipgroup 互斥。 当 state=present 时适用。 |
|
指定要分配给卷组的存储分区的名称。 当 state=present 时适用。 支持 Storage Virtualize 系列系统 8.6.1.0 或更高版本。 |
|
Storage Virtualize 系统的 REST API 密码。 如果未使用 token 来验证用户身份,则需要参数 username 和 password。 |
|
指定要进行首次 Safeguarded 备份的时间。 此参数也可以与快照策略关联。 使用 policystarttime 时,需要 safeguardpolicyname。 接受的格式为 YYMMDDHHMM。 当 state=present 时适用。 |
|
指定要创建目标卷的池名称。 在从现有快照创建主机可访问卷组时有效。 |
|
指定要分配给卷组的复制策略的名称。 当 state=present 时适用。 支持 Storage Virtualize 系列系统 8.5.2.1 或更高版本。 |
|
如果指定,快照策略将创建受保护的快照。 应与 snapshotpolicy 一起指定。 在创建和更新卷组期间有效。 支持 Storage Virtualize 系列系统 8.5.2.0 或更高版本。 选择
|
|
要分配给卷组的受保护策略的名称。 safeguardpolicyname 与参数 nosafeguardpolicy 和 ownershipgroup 互斥。 当 state=present 时适用。 |
|
指定用于预填充新卷组中新卷的快照的名称。 从现有快照创建主机可访问的卷组时是必需的。 |
|
要分配给卷组的快照策略的名称。 snapshotpolicy 与参数 nosnapshotpolicy 和 ownershipgroup 互斥。 当 state=present 时适用。 |
|
指定是否在此卷组上暂停( 当 state=present 时适用,修改现有卷组。 选择
|
|
创建或更新( 选择
|
|
用于在 Storage Virtualize 系统上验证用户的身份验证令牌。 要生成令牌,请使用 ibm.storage_virtualize.ibm_svc_auth 模块。 |
|
指定要从快照创建的卷组的类型。 在从现有快照创建主机可访问卷组时有效。 选择
|
|
用于 Storage Virtualize 系统的 REST API 用户名。 如果未使用 token 来验证用户身份,则需要参数 username 和 password。 |
|
验证证书。 选择
|
备注
注意
此模块支持
check_mode
。受保护策略和快照策略不能同时使用。因此,参数 snapshotpolicy 和 safeguardpolicyname 是互斥的。
示例
- 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