dellemc.unity.storagepool 模块 – 管理 Unity 上的存储池

注意

此模块是 dellemc.unity 集合 (版本 2.0.0) 的一部分。

如果您使用的是 ansible 包,则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install dellemc.unity。您需要其他要求才能使用此模块,请参阅 要求 以了解详细信息。

要在 playbook 中使用它,请指定:dellemc.unity.storagepool

dellemc.unity 1.1.0 中的新增功能

概要

  • 管理 Unity 存储系统上的存储池包含以下操作:获取存储池的详细信息、创建存储池、修改存储池。

要求

执行此模块的主机需要以下要求。

  • Dell Unity 存储设备版本 5.1 或更高版本。

  • Ansible-core 2.14 或更高版本。

  • Python 3.9、3.10 或 3.11。

  • Storops Python SDK 1.2.11。

参数

参数

注释

alert_threshold

整数

系统将生成有关池中可用空间的警报的阈值,以百分比指定。

最小阈值限制为 50。

最大阈值限制为 84。

fast_cache

字符串

指示是否为存储池启用了快速缓存。

Enabled - 为池启用了 FAST Cache。

Disabled - 为池禁用了 FAST Cache。

选项

  • "enabled"

  • "disabled"

fast_vp

字符串

指示是否为池启用计划的数据重新定位。

Enabled - 为池启用了计划的数据重新定位。

Disabled - 为池禁用了计划的数据重新定位。

选项

  • "enabled"

  • "disabled"

is_harvest_enabled

布尔值

启用/禁用基于池空间使用情况的快照自动删除。

选项

  • false

  • true

is_snap_harvest_enabled

布尔值

启用/禁用基于池空间使用情况的快照自动删除。

选项

  • false

  • true

new_pool_name

字符串

存储池的新名称,在存储系统中唯一。

password

字符串 / 必需

Unity 管理服务器的密码。

pool_description

字符串

存储池的描述。

pool_harvest_high_threshold

浮点数

池中使用的空间最大阈值,超过此阈值,系统将自动开始删除池中的快照。

当为系统和池启用了基于池空间使用情况的快照自动删除时适用。

最小池收获高阈值是 1。

最大池收获高阈值是 99。

pool_harvest_low_threshold

浮点数

池中使用的空间最小阈值,低于此阈值,系统将自动停止删除池中的快照。

当为系统和池启用了基于池空间使用情况的快照自动删除时适用。

最小池收获低阈值是 0。

最大池收获低阈值是 98。

pool_id

字符串

池实例的唯一标识符。

pool_name

字符串

存储池的名称,在存储系统中唯一。

pool_type

字符串

指示存储池类型。

选项

  • "TRADITIONAL"

  • "DYNAMIC"

port

整数

与 Unity 管理服务器进行通信的端口号。

默认值: 443

raid_groups

字典

从磁盘创建 RAID 组并将其添加到池的参数。

disk_group_id

字符串

磁盘组的 ID。

disk_num

整数

磁盘数量。

raid_type

字符串

RAID 组类型或 RAID 等级。

选项

  • "None"

  • "RAID5"

  • "RAID0"

  • "RAID1"

  • "RAID3"

  • "RAID10"

  • "RAID6"

  • "Mixed"

  • "Automatic"

stripe_width

字符串

RAID 组条带宽度,包括奇偶校验或镜像磁盘。

选项

  • "BEST_FIT"

  • "2"

  • "4"

  • "5"

  • "6"

  • "8"

  • "9"

  • "10"

  • "12"

  • "13"

  • "14"

  • "16"

snap_harvest_high_threshold

浮点数

快照中使用的空间最大阈值,超过此阈值,系统将自动开始删除池中的快照。

当为池启用了基于池空间使用情况的快照自动删除时适用。

最小快照收获高阈值是 1。

最大快照收获高阈值是 99。

snap_harvest_low_threshold

浮点数

快照中使用的空间最小阈值,低于此阈值,系统将停止自动删除池中的快照。

当为池启用了基于池空间使用情况的快照自动删除时适用。

最小快照收获低阈值是 0。

最大快照收获低阈值是 98。

state

字符串 / 必需

定义存储池是否应该存在。

Present - 指示存储池应存在于系统中。

Absent - 指示存储池不应存在于系统中。

选项

  • "absent"

  • "present"

unispherehost

字符串 / 必需

Unity 管理服务器的 IP 地址或 FQDN。

username

字符串 / 必需

Unity 管理服务器的用户名。

validate_certs

别名:verifycert

布尔值

布尔变量,指定是否验证 SSL 证书。

true - 指示应验证 SSL 证书。

false - 指示不应验证 SSL 证书。

选项

  • false

  • true ← (默认)

注释

注意

  • 不允许通过 Ansible 模块删除存储池。

  • 不支持 check_mode

  • 此集合中名为“dellemc.unity”的模块旨在支持 Dell Unity 存储平台。

示例

- name: Get Storage pool details using pool_name
  dellemc.unity.storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_name: "{{pool_name}}"
    state: "present"

- name: Get Storage pool details using pool_id
  dellemc.unity.storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_id: "{{pool_id}}"
    state: "present"

- name: Modify Storage pool attributes using pool_name
  dellemc.unity.storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_name: "{{pool_name}}"
    new_pool_name: "{{new_pool_name}}"
    pool_description: "{{pool_description}}"
    fast_cache: "{{fast_cache_enabled}}"
    fast_vp: "{{fast_vp_enabled}}"
    state: "present"

- name: Modify Storage pool attributes using pool_id
  dellemc.unity.storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_id: "{{pool_id}}"
    new_pool_name: "{{new_pool_name}}"
    pool_description: "{{pool_description}}"
    fast_cache: "{{fast_cache_enabled}}"
    fast_vp: "{{fast_vp_enabled}}"
    state: "present"

- name: Create a StoragePool
  dellemc.unity.storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_name: "Test"
    pool_description: "test pool"
    raid_groups:
      disk_group_id: "dg_16"
      disk_num: 2
      raid_type: "RAID10"
      stripe_width: "BEST_FIT"
    alert_threshold: 50
    is_harvest_enabled: true
    pool_harvest_high_threshold: 60
    pool_harvest_low_threshold: 40
    is_snap_harvest_enabled: true
    snap_harvest_high_threshold: 70
    snap_harvest_low_threshold: 50
    fast_vp: "enabled"
    fast_cache: "enabled"
    pool_type: "DYNAMIC"
    state: "present"

返回值

常见的返回值已在 此处 记录,以下是此模块特有的字段

描述

changed

布尔值

存储池是否已更改。

返回值:始终返回

示例: true

storage_pool_details

字典

存储池详细信息。

返回值:存储池存在时返回。

示例: {"alert_threshold": 50, "creation_time": "2022-03-08 14:05:32+00:00", "description": "", "drives": [{"disk_technology": "SAS", "id": "dpe_disk_22", "name": "DPE Drive 22", "size": 590860984320, "tier_type": "PERFORMANCE"}, {"disk_technology": "SAS", "id": "dpe_disk_23", "name": "DPE Drive 23", "size": 590860984320, "tier_type": "PERFORMANCE"}, {"disk_technology": "SAS", "id": "dpe_disk_24", "name": "DPE Drive 24", "size": 590860984320, "tier_type": "PERFORMANCE"}], "existed": true, "harvest_state": "UsageHarvestStateEnum.IDLE", "hash": 8744642897210, "health": {"UnityHealth": {"hash": 8744642799842}}, "id": "pool_280", "is_all_flash": false, "is_empty": false, "is_fast_cache_enabled": false, "is_fast_vp_enabled": false, "is_harvest_enabled": true, "is_snap_harvest_enabled": true, "metadata_size_subscribed": 105763569664, "metadata_size_used": 57176752128, "name": "test_pool", "object_id": 12884902146, "pool_fast_vp": {"UnityPoolFastVp": {"hash": 8744647518980}}, "pool_space_harvest_high_threshold": 59.0, "pool_space_harvest_low_threshold": 40.0, "pool_type": "StoragePoolTypeEnum.DYNAMIC", "raid_type": "RaidTypeEnum.RAID10", "rebalance_progress": null, "size_free": 470030483456, "size_free_with_unit": "437.75 GB", "size_subscribed": 447215820800, "size_subscribed_with_unit": "416.5 GB", "size_total": 574720311296, "size_total_with_unit": "535.25 GB", "size_used": 76838068224, "size_used_with_unit": "71.56 GB", "snap_size_subscribed": 128851369984, "snap_size_subscribed_with_unit": "120.0 GB", "snap_size_used": 2351104, "snap_size_used_with_unit": "2.24 MB", "snap_space_harvest_high_threshold": 80.0, "snap_space_harvest_low_threshold": 60.0, "tiers": {"UnityPoolTierList": [{"disk_count": [0, 3, 0], "existed": true, "hash": 8744643017382, "name": ["Extreme Performance", "Performance", "Capacity"], "pool_units": [null, {"UnityPoolUnitList": [{"UnityPoolUnit": {"hash": 8744642786759, "id": "rg_4"}}, {"UnityPoolUnit": {"hash": 8744642786795, "id": "rg_5"}}]}, null], "raid_type": ["RaidTypeEnum.NONE", "RaidTypeEnum.RAID10", "RaidTypeEnum.NONE"], "size_free": [0, 470030483456, 0], "size_moving_down": [0, 0, 0], "size_moving_up": [0, 0, 0], "size_moving_within": [0, 0, 0], "size_total": [0, 574720311296, 0], "size_used": [0, 104689827840, 0], "stripe_width": [null, "RaidStripeWidthEnum._2", null], "tier_type": ["TierTypeEnum.EXTREME_PERFORMANCE", "TierTypeEnum.PERFORMANCE", "TierTypeEnum.CAPACITY"]}]}}

drives

列表 / 元素=字符串

指示与存储池关联的驱动器的信息。

返回值:成功

disk_technology

字符串

指示驱动器的磁盘技术。

返回值:成功

id

字符串

驱动器的唯一标识符。

返回值:成功

name

字符串

指示驱动器的名称。

返回值:成功

size

字符串

指示驱动器的大小。

返回值:成功

tier_type

字符串

指示驱动器的层类型。

返回值:成功

id

字符串

池 ID,池的唯一标识符。

返回值:成功

is_fast_cache_enabled

布尔值

指示是否为存储池启用快速缓存。true - 为池启用了 FAST Cache。false - 为池禁用了 FAST Cache。

返回值:成功

is_fast_vp_enabled

布尔值

指示是否为存储池启用计划的数据重新定位。true - 为池启用了计划的数据重新定位。false - 为池禁用了计划的数据重新定位。

返回值:成功

name

字符串

池名称,在存储系统中唯一。

返回值:成功

size_free_with_unit

字符串

以易于阅读的形式指示 size_free 及其相应的单位。

返回值:成功

size_subscribed_with_unit

字符串

以易于阅读的形式指示 size_subscribed 及其相应的单位。

返回值:成功

size_total_with_unit

字符串

以易于阅读的形式指示 size_total 及其相应的单位。

返回值:成功

size_used_with_unit

字符串

以易于阅读的形式指示 size_used 及其相应的单位。

返回值:成功

snap_size_subscribed_with_unit

字符串

以易于阅读的形式指示 snap_size_subscribed 及其相应的单位。

返回值:成功

snap_size_used_with_unit

字符串

以易于阅读的形式指示 snap_size_used 及其相应的单位。

返回值:成功

作者

  • Ambuj Dubey (@AmbujDube)