netapp_eseries.santricity.na_santricity_storagepool 模块 – NetApp E-Series 管理卷组和磁盘池

注意

此模块是 netapp_eseries.santricity 集合（版本 1.4.1）的一部分。

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

要安装它，请使用：ansible-galaxy collection install netapp_eseries.santricity。

要在 playbook 中使用它，请指定：netapp_eseries.santricity.na_santricity_storagepool。

概要

  • 为 NetApp E 系列存储阵列创建或删除卷组和磁盘池。

参数

参数

注释

api_password

string / 必填

用于通过 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。

api_url

string / 必填

指向 SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。

示例 https://prod-1.wahoo.acme.com:8443/devmgr/v2

api_username

string / 必填

用于通过 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。

criteria_drive_count

整数

用于构建存储池的磁盘数量。

当 state==”present” 时，必须指定 criteria_drive_count 或 criteria_min_usable_capacity。

如果此数字超过已存在的磁盘数量，则将扩展该池（请参阅下面的扩展说明）

criteria_drive_interface_type

字符串

在选择存储池的驱动器时使用的接口类型

如果未提供，则将考虑所有接口类型。

选择

  • "scsi"

  • "fibre"

  • "sata"

  • "pata"

  • "fibre520b"

  • "sas"

  • "sas4k"

  • "nvme4k"

criteria_drive_max_size

浮点数

在为存储池选择驱动器时要考虑的最大单个驱动器大小（以 size_unit 为单位）。

criteria_drive_min_size

浮点数

在为存储池选择驱动器时要考虑的最小单个驱动器大小（以 size_unit 为单位）。

criteria_drive_require_da

布尔值

确保使用仅支持数据保证 (DA) 的驱动器创建存储池。

仅适用于新的存储池；现有存储池无法转换。

选择

  • false ←（默认）

  • true

criteria_drive_require_fde

布尔值

是否要求驱动器具有全盘加密功能才能添加到存储池中

选择

  • false ←（默认）

  • true

criteria_drive_type

字符串

在搜索可用候选驱动器时要使用的磁盘类型（hdd 或 ssd）。

如果未指定，则将评估每种驱动器类型，直到找到成功的驱动器候选者，从最常见的驱动器类型开始。

选择

  • "hdd"

  • "ssd"

criteria_min_usable_capacity

浮点数

存储池的最小大小（以 size_unit 为单位）。

当 state==”present” 时，必须指定 criteria_drive_count 或 criteria_min_usable_capacity。

如果此值超过其当前大小，则将扩展该池。（请参阅下面的扩展说明）

当存储系统包含混合驱动器并且指定了 usable_drives 时，请勿使用，因为可用容量可能不准确。

criteria_size_unit

字符串

用于解释大小参数的单位

选择

  • "bytes"

  • "b"

  • "kb"

  • "mb"

  • "gb" ←（默认）

  • "tb"

  • "pb"

  • "eb"

  • "zb"

  • "yb"

ddp_critical_threshold_pct

整数

当已分配的存储量达到阈值时发出严重警报。

仅当 raid_level==”raidDiskPool” 时适用。

设置 ddp_critical_threshold_pct==0 以禁用警报。

默认值： 85

ddp_warning_threshold_pct

整数

当已分配的存储量达到阈值时发出警告警报。

仅当 raid_level==”raidDiskPool” 时适用。

设置 ddp_warning_threshold_pct==0 以禁用警报。

默认值： 0

erase_secured_drives

布尔值

如果 state==”absent”，则将擦除所有存储池驱动器

如果 state==”present”，则删除所有已启用安全性的可用存储阵列驱动器。

选择

  • false

  • true ←（默认）

name

string / 必填

要管理的存储池的名称

raid_level

字符串

要创建的存储池的 RAID 级别。

仅当 state==”present” 时才需要。

当 raid_level==”raidDiskPool” 时，根据存储阵列规格，需要 criteria_drive_count >= 10 或 criteria_drive_count >= 11。

当 raid_level==”raid0” 时，需要 1<=criteria_drive_count。

当 raid_level==”raid1” 时，需要 2<=criteria_drive_count。

当 raid_level==”raid3” 时，需要 3<=criteria_drive_count<=30。

当 raid_level==”raid5” 时，需要 3<=criteria_drive_count<=30。

当 raid_level==”raid6” 时，需要 5<=criteria_drive_count<=30。

请注意，raidAll 将被视为 raidDiskPool，而 raid3 将被视为 raid5。

选择

  • “raidAll”

  • “raid0”

  • “raid1”

  • “raid3”

  • “raid5”

  • “raid6”

  • "raidDiskPool" ←（默认）

remove_volumes

布尔值

在删除存储池之前，请删除池中的所有卷。

选择

  • false

  • true ←（默认）

reserve_drive_count

整数

设置存储池为重建操作保留的驱动器数量。

仅在 raid 磁盘池上有效。

secure_pool

布尔值

启用存储池上的静态数据安全功能。

仅当池中的所有驱动器都具有安全功能（FDE、FIPS 或混合）时才有效。

警告：一旦启用安全性，如果不擦除驱动器，则无法禁用它。

选择

  • false ←（默认）

  • true

ssid

字符串

要管理的阵列的 ID。此值对于每个阵列必须是唯一的。

默认值： "1"

state

字符串

指定的存储池是否应存在。

请注意，删除存储池目前需要先删除所有已定义的卷。

选择

  • "present" ←（默认）

  • “absent”

usable_drives

字符串

以逗号分隔的托盘/驱动器插槽列表，用于选择驱动器候选（将跳过已使用的驱动器）。

每个驱动器条目表示为 <tray_number>:<(可选) drawer_number>:<drive_slot_number>（例如，99:0 是基本托盘的驱动器插槽 0）。

基本托盘的默认标识符为 99，扩展托盘按照它们连接的顺序添加，但这些标识符可以由用户更改。

请注意，具有多个抽屉的托盘仍然为所有驱动器都有一个专用的驱动器插槽，并且插槽号不依赖于抽屉；但是，如果您计划进行抽屉保护，则需要相应地排序。

当未提供usable_drives时，驱动器候选将由存储系统选择。

validate_certs

布尔值

是否应验证 https 证书？

选择

  • false

  • true ←（默认）

说明

注意

  • 由于扩展卷组的性质耗时，扩展操作是非阻塞的

  • 传统的卷组（raid0、raid1、raid5、raid6）是按照存储阵列指示的步骤执行的。将尝试每个必需的步骤，直到请求失败，这很可能是因为所需的扩展时间。

  • raidUnsupported 将被视为 raid0，raidAll 将被视为 raidDiskPool，而 raid3 将被视为 raid5。

  • 如果可能，将选择托盘丢失保护和抽屉丢失保护。

  • E-Series Ansible 模块需要 Web Services Proxy (WSP) 的实例才能管理存储系统，或者需要支持嵌入式 Web Services API 的 E-Series 存储系统。

  • 嵌入式 Web 服务目前在 E2800、E5700、EF570 和更新的硬件型号上可用。

  • netapp_eseries.santricity.netapp_e_storage_system 可用于配置由 WSP 实例管理的系统。

示例

- name: No disk groups
  na_santricity_storagepool:
    ssid: "{{ ssid }}"
    name: "{{ item }}"
    state: absent
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"

返回值

常见的返回值记录在此处，以下是此模块独有的字段

键

描述

msg

字符串

成功消息

返回： 成功

示例： "为创建的池提供的 Json 事实。"

作者

  • Nathan Swartz (@swartzn)

  • Vu Tran (@VuTran007)