dellemc.powerflex.storagepool 模块 – 管理 Dell PowerFlex 存储池
注意
此模块是 dellemc.powerflex 集合（版本 2.5.0）的一部分。
如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install dellemc.powerflex。您需要更多要求才能使用此模块，有关详细信息，请参阅 要求。
要在 playbook 中使用它，请指定：dellemc.powerflex.storagepool。
dellemc.powerflex 1.0.0 中的新增功能
概要
Dell PowerFlex 存储池模块包括获取存储池的详细信息、创建新的存储池以及修改存储池的属性。
要求
执行此模块的主机需要满足以下要求。
Dell PowerFlex 存储系统版本 3.6 或更高版本。
PyPowerFlex 1.12.0。
参数
参数 |
注释 |
|---|---|
设置触发容量使用警报的阈值。 警报阈值是根据每个存储池容量扣除定义的备用容量后计算得出的。 |
|
存储池的非备用容量的阈值，将触发关键优先级警报，以百分比表示。 |
|
存储池的非备用容量的阈值，将触发高优先级警报，以百分比表示。 此值必须低于critical_threshold。 |
|
启用/禁用特定存储池的碎片整理。 选项
|
|
启用/禁用特定存储池的重新平衡。 选项
|
|
启用/禁用特定存储池的重建。 选项
|
|
启用/禁用特定存储池上的零填充。 选项
|
|
PowerFlex 主机的 IP 或 FQDN。 |
|
存储池中设备的类型。 选项
|
|
设置存储池的重建/重新平衡并行限制。 |
|
PowerFlex 主机的密码。 |
|
启用/禁用特定存储池的持久校验和。 |
|
校验和构建过程的带宽限制（单位为 KB/s）。 有效范围为 1024 到 10240。 默认值： |
|
启用/禁用持久校验和。 选项
|
|
读取数据时验证校验和。 选项
|
|
与 PowerFlex 主机进行通信的端口号。 默认值： |
|
设置存储池的受保护维护模式 I/O 优先级策略。 |
|
受保护维护模式迁移 I/O 的最大带宽，单位为 KB/秒/设备。 有效范围为 1024 到 1048576。 |
|
每个设备允许的最大并发受保护维护模式迁移 I/O 数。 有效范围为 1 到 20。 |
|
受保护维护模式的 I/O 优先级策略。
如果应用程序 I/O 正在进行，还应将受保护维护模式迁移 I/O 的带宽限制为为bw_limit_per_device定义的限制。 选项
|
|
保护域的 ID。 在创建池时，必须提及保护域名或 ID。 与protection_domain_name互斥。 |
|
保护域的名称。 在创建池时，必须提及保护域名或 ID。 与protection_domain_id互斥。 |
|
设置存储池的重新平衡 I/O 优先级策略。 |
|
每个设备的重新平衡 I/O 的最大带宽，单位为 KB/s。 有效范围为 1024 到 1048576。 |
|
每个设备允许的最大并发重新平衡 I/O 数。 有效范围为 1 到 20。 |
|
用于重新平衡 I/O 优先级的策略。
选项
|
|
设置存储池的复制日志容量。 |
|
设置存储池的 RM 缓存写入处理模式。 Passthrough 写入跳过缓存，仅存储在存储中。 Cached 写入同时存储在缓存和存储中（默认）。 仅对大小为 4k 字节倍数的 IO 执行缓存。 选项
|
|
设置特定存储池的备用百分比。 |
|
存储池的状态。 选项
|
|
存储池的 ID。 它是自动生成的，因此在创建存储池期间不应提供。 与 storage_pool_name 互斥。 |
|
存储池的名称。 如果找到多个同名的存储池，则需要保护域 ID/名称才能执行任务。 与 storage_pool_id 互斥。 |
|
可以提供存储池的新名称。 此参数用于重命名存储池。 |
|
连接终止的时间。 以秒为单位提及。 默认值: |
|
在特定存储池上启用/禁用 RFcache。 选项
|
|
在特定存储池上启用/禁用 RMcache。 选项
|
|
PowerFlex 主机的用户名。 |
|
指定是否验证 SSL 证书的布尔变量。
选项
|
|
设置特定存储池的 V-Tree 迁移的 I/O 优先级策略。 |
|
每个设备每秒 V-Tree 迁移 I/O 的最大带宽，单位为 KB。 有效范围为 1024 到 25600。 |
|
每个设备并发 V-Tree 迁移 I/O 的最大数量。 有效范围为 1 到 20。 |
|
受保护维护模式的 I/O 优先级策略。
如果应用程序 I/O 正在进行，还应将 V-Tree 迁移 I/O 的带宽限制为为 bw_limit_per_device 定义的限制。 选项
|
注释
注意
仅在修改期间支持 TRANSITIONAL 媒体类型。
支持 check_mode。
名为 ‘dellemc.powerflex’ 的集合中存在的模块旨在支持 Dell PowerFlex 存储平台。
示例
- name: Get the details of storage pool by name
dellemc.powerflex.storagepool:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
storage_pool_name: "sample_pool_name"
protection_domain_name: "sample_protection_domain"
state: "present"
- name: Get the details of storage pool by id
dellemc.powerflex.storagepool:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
storage_pool_id: "abcd1234ab12r"
state: "present"
- name: Create a new Storage pool
dellemc.powerflex.storagepool:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
storage_pool_name: "{{ pool_name }}"
protection_domain_name: "{{ protection_domain_name }}"
cap_alert_thresholds:
high_threshold: 30
critical_threshold: 50
media_type: "TRANSITIONAL"
enable_zero_padding: true
rep_cap_max_ratio: 40
rmcache_write_handling_mode: "Passthrough"
spare_percentage: 80
enable_rebalance: false
enable_fragmentation: false
enable_rebuild: false
use_rmcache: true
use_rfcache: true
parallel_rebuild_rebalance_limit: 3
protected_maintenance_mode_io_priority_policy:
policy: "unlimited"
rebalance_io_priority_policy:
policy: "unlimited"
vtree_migration_io_priority_policy:
policy: "limitNumOfConcurrentIos"
concurrent_ios_per_device: 10
persistent_checksum:
enable: false
state: "present"
- name: Modify a Storage pool by name
dellemc.powerflex.storagepool:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
storage_pool_name: "{{ pool_name }}"
protection_domain_name: "{{ protection_domain_name }}"
storage_pool_new_name: "pool_name_new"
cap_alert_thresholds:
high_threshold: 50
critical_threshold: 70
enable_zero_padding: false
rep_cap_max_ratio: 60
rmcache_write_handling_mode: "Passthrough"
spare_percentage: 90
enable_rebalance: true
enable_fragmentation: true
enable_rebuild: true
use_rmcache: true
use_rfcache: true
parallel_rebuild_rebalance_limit: 6
protected_maintenance_mode_io_priority_policy:
policy: "limitNumOfConcurrentIos"
concurrent_ios_per_device: 4
rebalance_io_priority_policy:
policy: "favorAppIos"
concurrent_ios_per_device: 10
bw_limit_per_device: 4096
vtree_migration_io_priority_policy:
policy: "limitNumOfConcurrentIos"
concurrent_ios_per_device: 10
persistent_checksum:
enable: true
validate_on_read: true
builder_limit: 1024
state: "present"
返回值
通用返回值记录在此处 此处，以下是此模块特有的字段
键 |
描述 |
|---|---|
资源是否已更改。 返回: 总是 示例: |
|
存储池的详细信息。 返回: 当存储池存在时 Sample: |
|
保护域下存储池的 ID。 返回: 成功 |
|
存储池中设备的类型。 返回: 成功 |
|
保护域下存储池的名称。 返回: 成功 |
|
池所在的保护域的 ID。 返回: 成功 |
|
池所在的保护域的名称。 返回: 成功 |
|
存储池的统计信息详细信息。 返回: 成功 |
|
存储池的总容量。 返回: 成功 |
|
存储池的设备 ID。 返回: 成功 |
|
存储池的未使用容量。 返回: 成功 |
|
在特定存储池上启用/禁用 RFcache。 返回: 成功 |
|
在特定存储池上启用/禁用 RMcache。 返回: 成功 |