netapp_eseries.santricity.netapp_e_storagepool 模块 – NetApp E 系列管理卷组和磁盘池

注意

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

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

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

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

netapp_eseries.santricity 2.2.0 中的新增功能

概要 

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

参数 

参数	注释
api_password 字符串 / 必需	用于对 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。
api_url 字符串 / 必需	SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。示例 https://prod-1.wahoo.acme.com/devmgr/v2
api_username 字符串 / 必需	用于对 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。
criteria_drive_count 整数	用于构建存储池的磁盘数量。当 state==”present” 时，必须指定 criteria_drive_count 或 criteria_min_usable_capacity。如果此数字超过已就位的磁盘数量，则池将被扩展（参见下面的扩展说明）
criteria_drive_interface_type 字符串	选择存储池驱动器时使用的接口类型如果未提供，则将考虑所有接口类型。选项 `"sas"` `"sas4k"` `"fibre"` `"fibre520b"` `"scsi"` `"sata"` `"pata"`
criteria_drive_min_size 浮点数	选择存储池驱动器时要考虑的最小单个驱动器大小（以 size_unit 为单位）。
criteria_drive_require_da 布尔值 netapp_eseries.santricity 2.9.0 中新增	确保存储池将仅使用具有数据保证 (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。如果此值超过其当前大小，则池将被扩展。（参见下面的扩展说明）
criteria_size_unit 字符串	用于解释大小参数的单位选项 `"bytes"` `"b"` `"kb"` `"mb"` `"gb"` ← (默认) `"tb"` `"pb"` `"eb"` `"zb"` `"yb"`
erase_secured_drives 布尔值	如果 state==”absent”，则将擦除所有存储池驱动器如果 state==”present”，则删除所有启用了安全性的可用存储阵列驱动器。选项 `false` `true` ← (默认)
name 字符串 / 必需	要管理的存储池的名称
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"`
validate_certs 布尔值	是否验证 https 证书？选项 `false` `true` ← (默认)

备注 

注意

由于扩展卷组非常耗时，扩展操作是非阻塞的。
传统卷组 (raid0、raid1、raid5、raid6) 按存储阵列指定的步骤执行。将尝试每个必需的步骤，直到请求失败（这可能是由于所需的扩展时间）。
raidUnsupported 将被视为 raid0，raidAll 将被视为 raidDiskPool，raid3 将被视为 raid5。
如果可能，将选择托盘丢失保护和抽屉丢失保护。
E 系列 Ansible 模块需要 Web 服务代理 (WSP) 实例可用以管理存储系统，或者支持嵌入式 Web 服务 API 的 E 系列存储系统。
嵌入式 Web 服务目前适用于 E2800、E5700、EF570 和更新的硬件型号。
netapp_eseries.santricity.netapp_e_storage_system 可用于配置由 WSP 实例管理的系统。

示例 

- name: No disk groups
  netapp_e_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事实数据"`

作者

Kevin Hulquest (@hulquest)
Nathan Swartz (@ndswartz)