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。 有效范围是 1024 到 1048576。 |
|
每个设备的最大并发重新平衡 I/O 数量。 有效范围是 1 到 20。 |
|
用于重新平衡 I/O 优先级的策略。
当应用程序I/O正在进行时， 选项
|
|
设置存储池的复制日志容量。 |
|
设置存储池的RM缓存写入处理模式。 直通 写入跳过缓存，仅存储在存储中。 缓存 写入同时存储在缓存和存储中（默认值）。 仅对大小为4k字节倍数的I/O执行缓存。 选项
|
|
设置特定存储池的备用百分比。 |
|
存储池的状态。 选项
|
|
存储池的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。 返回：成功 |