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_countcriteria_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_countcriteria_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-Series Ansible 模块需要 Web Services Proxy (WSP) 的一个实例来管理存储系统,或者需要一个支持嵌入式 Web Services API 的 E-Series 存储系统。

  • 嵌入式 Web Services 目前在 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 facts。"

作者

  • Kevin Hulquest (@hulquest)

  • Nathan Swartz (@ndswartz)