ibm.spectrum_virtualize.ibm_svc_manage_volume 模块 – 此模块管理 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_volume。

注意

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

ibm.spectrum_virtualize 1.6.0 中的新增功能

概要

• 管理“mkvolume”、“rmvolume”和“chvdisk”卷命令的 Ansible 接口。

参数

参数	注释
buffersize 字符串	指定卷将作为缓冲区为精简配置和压缩卷保留的池容量。 必须指定参数“精简”或“压缩”才能使用此参数。 默认缓冲区大小为 2%。 使用 *buffersize* 时，需要 *精简* 或 *压缩*。 当 *state=present* 时有效，用于创建卷。
cloud_account_name 字符串 在 ibm.spectrum_virtualize 1.11.0 中添加	指定云帐户名称。 当 *enable_cloud_snapshot=true* 时有效。
clustername 字符串 / 必需	Spectrum Virtualize 存储系统的 hostname 或管理 IP。
compressed 布尔值	指定要创建压缩卷。 参数“压缩”和“精简”是互斥的。 当 *state=present* 时有效，用于创建压缩卷。 选项 false true
deduplicated 布尔值	指定要创建重复数据删除卷。 当 *state=present* 时有效，用于创建重复数据删除卷。 选项 false true
domain 字符串	Spectrum Virtualize 存储系统的域。 当使用 hostname 作为参数 *clustername* 时有效。
enable_cloud_snapshot 布尔值 在 ibm.spectrum_virtualize 1.11.0 中添加	指定启用或禁用云快照。 当 *state=present* 时有效，用于修改现有卷。 选项 false true
iogrp 字符串	指定 I/O 组名称列表。列表中的组名必须用逗号分隔。 创建新卷时，列表中的第一个 I/O 组将同时添加为缓存和访问 I/O 组，而其余 I/O 组将添加为访问 I/O 组。 此参数支持更新功能。 当 *state=present* 时有效，用于创建或修改卷。
log_path 字符串	调试日志文件的路径。
name 字符串 / 必需	指定要分配给新卷的名称。
novolumegroup 布尔值	如果指定为 `True`，则卷将从其关联的卷组中移除。 参数“novolumegroup”和“volumegroup”是互斥的。 当 *state=present* 时有效，用于修改卷。 选项 false true
old_name 字符串 在 ibm.spectrum_virtualize 1.9.0 中添加	在重命名期间指定卷的旧名称。 当 *state=present* 时有效，用于重命名现有卷。
password 字符串	Spectrum Virtualize 存储系统的 REST API 密码。 如果不使用 *token* 来验证用户，则参数 *username* 和 *password* 是必需的。
pool 字符串	指定创建卷时要使用的存储池的名称。 当 *state=present* 时，此参数是必需的，用于创建卷。
size 字符串	定义卷的大小。此参数也可用于调整现有卷的大小。 当 *state=present* 时，用于创建或修改卷是必需的。
state 字符串 / 必需	创建或更新 (present) 或删除 (absent) 卷。 选项 "absent" "present"
thin 布尔值	指定要创建精简配置卷。 参数“精简”和“压缩”是互斥的。 当 *state=present* 时有效，用于创建精简配置卷。 选项 false true
token 字符串	用于验证 Spectrum Virtualize 存储系统上用户的身份验证令牌。 要生成令牌，请使用 ibm_svc_auth 模块。
unit 字符串	指定与“size”参数指定的容量一起使用的单位。 使用 *unit* 时，需要 *size*。 选项 "b" "kb" "mb" ← (默认) "gb" "tb" "pb"
username 字符串	Spectrum Virtualize 存储系统的 REST API 用户名。 如果不使用 *token* 来验证用户，则参数 *username* 和 *password* 是必需的。
validate_certs 布尔值	验证证书。 选项 false ← (默认) true
volumegroup 字符串	指定要将卷添加到其中的卷组的名称。 参数“volumegroup”和“novolumegroup”是互斥的。 当 *state=present* 时有效，用于创建或修改卷。

备注

注意

• 此模块支持check_mode。

示例

- name: Create a volume
  ibm.spectrum_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{domain}}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0, io_grp1"
    volumegroup: "test_volumegroup"
- name: Create a thin-provisioned volume
  ibm.spectrum_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0, io_grp1"
    thin: true
    buffersize: 10%
- name: Create a compressed volume
  ibm.spectrum_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0, io_grp1"
    compressed: true
    buffersize: 10%
- name: Creating a volume with iogrp- io_grp0
  ibm.spectrum_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain}}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0"
- name: Adding a new iogrp- io_grp1
  ibm.spectrum_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0, iogrp1"
- name: Rename an existing volume
  ibm.spectrum_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    old_name: "volume_name"
    name: "new_volume_name"
    state: "present"
- name: Enable cloud backup in an existing volume
  ibm.spectrum_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "volume_name"
    enable_cloud_snapshot: true
    cloud_account_name: "aws_acc"
    state: "present"
- name: Delete a volume
  ibm.spectrum_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "new_volume_name"
    state: "absent"

作者

• Sreshtant Bohidar(@Sreshtant-Bohidar)

资源链接

• 问题追踪器
• 代码仓库