dellemc.powerflex.volume 模块 – 管理 Dell PowerFlex 上的卷
注意
此模块是 dellemc.powerflex 集合 (版本 2.5.0) 的一部分。
如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install dellemc.powerflex。您需要其他要求才能使用此模块，请参阅 要求 获取详细信息。
要在 playbook 中使用它，请指定： dellemc.powerflex.volume。
dellemc.powerflex 1.0.0 中的新增功能
概要
管理 PowerFlex 存储系统上的卷包括创建、获取详细信息、修改属性和删除卷。
它还包括向 SDC 添加/移除快照策略，将卷映射/取消映射到/从 SDC，以及列出关联的快照。
要求
执行此模块的主机需要以下要求。
Dell PowerFlex 存储系统版本 3.6 或更高版本。
PyPowerFlex 1.12.0。
参数
参数 |
注释 |
|---|---|
指定是否允许多个映射。 如果卷已映射到一个 SDC，则对于每个新的映射，必须将 allow_multiple_mappings 传递为 true。 选项
|
|
是否移除或分离快照策略。 要移除/分离快照策略，需要将空的 snapshot_policy_id/snapshot_policy_name 与 auto_snap_remove_type 一起传递。 如果快照策略名称/ID 传递为空，则 auto_snap_remove_type 默认值为 选项
|
|
卷大小的单位。默认为“GB”。 选项
|
|
压缩方法的类型。 选项
|
|
如果为 如果为 只有当 state 为 如果未指定，则默认为 选项
|
|
PowerFlex 主机的 IP 或 FQDN。 |
|
PowerFlex 主机的密码。 |
|
与 PowerFlex 主机通信的端口号。 默认值： |
|
保护域的 ID。 在创建卷期间，如果存在多个同名的存储池，则必须与存储池名称一起提及保护域名称或 ID。 与 protection_domain_name 互斥。 |
|
保护域的名称。 在创建卷期间，如果存在多个同名的存储池，则必须与存储池名称一起提及保护域名称或 ID。 与 protection_domain_id 互斥。 |
|
指定 SDC 参数。 |
|
定义卷所有映射的访问模式。 选项
|
|
卷网络带宽的限制。 需要以 1024 Kbps 的倍数提及。 要设置无限制，请传递 0。 |
|
卷 IOPS 的限制。 最小 IOPS 限制为 11，对于无限 iops，请指定 0。 |
|
SDC 的 ID。 指定 sdc_name、sdc_id 或 sdc_ip。 与 sdc_name 和 sdc_ip 互斥。 |
|
SDC 的 IP。 指定 sdc_name、sdc_id 或 sdc_ip。 与 sdc_id 和 sdc_ip 互斥。 |
|
SDC 的名称。 指定 sdc_name、sdc_id 或 sdc_ip。 与 sdc_id 和 sdc_ip 互斥。 |
|
SDC 的映射状态。 选项
|
|
卷的大小。 卷的大小将分配为 8 GB 的较高倍数。 |
|
快照策略的 ID。 要移除/分离快照策略，需要将空的 snapshot_policy_id/snapshot_policy_name 与 auto_snap_remove_type 一起传递。 |
|
快照策略的名称。 要移除/分离快照策略，需要将空的 snapshot_policy_id/snapshot_policy_name 与 auto_snap_remove_type 一起传递。 |
|
卷的状态。 选项
|
|
存储池的 ID。 创建卷需要存储池的名称或 ID。 与 storage_pool_name 互斥。 |
|
存储池的名称。 创建卷需要存储池的名称或 ID。 在创建期间，如果提供了存储池名称，则必须与存储池名称一起提及保护域名称或 ID。 与 storage_pool_id 互斥。 |
|
连接终止后的时间。 需要以秒为单位提及。 默认值： |
|
是否使用RM Cache。 选项
|
|
PowerFlex 主机的用户名。 |
|
布尔变量，用于指定是否验证 SSL 证书。
选项
|
|
卷的 ID。 除创建操作外，所有其他操作都可以使用vol_id执行。 与vol_name互斥。 |
|
卷的名称。 创建操作时必填。 在 PowerFlex 阵列中是唯一的。 与vol_id互斥。 |
|
卷的新名称。用于重命名卷。 |
|
卷配置类型。 选项
|
备注
注意
不支持check_mode。
名为“dellemc.powerflex”的集合中的模块旨在支持 Dell PowerFlex 存储平台。
示例
- name: Create a volume
dellemc.powerflex.volume:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
vol_name: "sample_volume"
storage_pool_name: "pool_1"
protection_domain_name: "pd_1"
vol_type: "THICK_PROVISIONED"
compression_type: "NORMAL"
use_rmcache: true
size: 16
state: "present"
- name: Map a SDC to volume
dellemc.powerflex.volume:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
vol_name: "sample_volume"
allow_multiple_mappings: true
sdc:
- sdc_id: "92A304DB-EFD7-44DF-A07E-D78134CC9764"
access_mode: "READ_WRITE"
sdc_state: "mapped"
state: "present"
- name: Unmap a SDC to volume
dellemc.powerflex.volume:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
vol_name: "sample_volume"
sdc:
- sdc_id: "92A304DB-EFD7-44DF-A07E-D78134CC9764"
sdc_state: "unmapped"
state: "present"
- name: Map multiple SDCs to a volume
dellemc.powerflex.volume:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
vol_name: "sample_volume"
protection_domain_name: "pd_1"
sdc:
- sdc_id: "92A304DB-EFD7-44DF-A07E-D78134CC9764"
access_mode: "READ_WRITE"
bandwidth_limit: 2048
iops_limit: 20
- sdc_ip: "198.10.xxx.xxx"
access_mode: "READ_ONLY"
allow_multiple_mappings: true
sdc_state: "mapped"
state: "present"
- name: Get the details of the volume
dellemc.powerflex.volume:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
vol_id: "fe6c8b7100000005"
state: "present"
- name: Modify the details of the Volume
dellemc.powerflex.volume:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
vol_name: "sample_volume"
storage_pool_name: "pool_1"
new_vol_name: "new_sample_volume"
size: 64
state: "present"
- name: Delete the Volume
dellemc.powerflex.volume:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
vol_name: "sample_volume"
delete_snapshots: false
state: "absent"
- name: Delete the Volume and all its dependent snapshots
dellemc.powerflex.volume:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
vol_name: "sample_volume"
delete_snapshots: true
state: "absent"
返回值
常见的返回值已在此处记录，以下是此模块特有的字段
键 |
描述 |
|---|---|
资源是否已更改。 返回值：始终返回 示例： |
|
卷的详细信息。 返回值：卷存在时返回 示例： |
|
卷的 ID。 返回值：成功时返回 |
|
已映射 SDC 的详细信息。 返回值：成功时返回 |
|
指定卷的映射访问模式。 返回值：成功时返回 |
|
SDC 的带宽限制。 返回值：成功时返回 |
|
SDC 的 IOPS 限制。 返回值：成功时返回 |
|
SDC 的 ID。 返回值：成功时返回 |
|
SDC 的 IP。 返回值：成功时返回 |
|
SDC 的名称。 返回值：成功时返回 |
|
卷的名称。 返回值：成功时返回 |
|
卷所在的保护域的 ID。 返回值：成功时返回 |
|
卷所在的保护域的名称。 返回值：成功时返回 |
|
卷的大小（GB）。 返回值：成功时返回 |
|
卷的大小（KB）。 返回值：成功时返回 |
|
与卷关联的快照策略的 ID。 返回值：成功时返回 |
|
与卷关联的快照策略的名称。 返回值：成功时返回 |
|
与卷关联的快照列表。 返回值：成功时返回 |
|
存储池的统计信息详情。 返回值：成功时返回 |
|
子卷的数量。 返回值：成功时返回 |
|
卷已映射的 SDC 数量。 返回值：成功时返回 |
|
卷所在的存储池的 ID。 返回值：成功时返回 |
|
卷所在的存储池的名称。 返回值：成功时返回 |