netapp_eseries.santricity.na_santricity_volume 模块 – NetApp E 系列管理存储卷（标准和精简）
注意
此模块是 netapp_eseries.santricity 集合（版本 1.4.1）的一部分。
如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install netapp_eseries.santricity。
要在剧本中使用它，请指定：netapp_eseries.santricity.na_santricity_volume。
概要
为 NetApp E/EF 系列存储阵列创建或删除卷（标准和精简）。
参数
参数 |
注释 |
|---|---|
允许卷大小扩展以满足所需的规范。 警告，当 *allows_expansion==false* 且现有卷需要扩展时，模块将继续并发出警告。 选择
|
|
用于使用 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。 |
|
指向 SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。 |
|
用于使用 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。 |
|
指示是否应在没有电池备份的情况下使用缓存。 警告，*cache_without_batteries==true* 且存储系统断电且没有电池备份，数据将丢失！ 选择
|
|
确定是否应为卷启用数据保证 (DA) 仅在创建新卷时以及在具有支持 DA 功能的驱动器的存储池上可用。 选择
|
|
要管理的卷的名称。 |
|
指定哪个控制器将是卷的主要所有者 不指定将允许控制器选择所有权。 选择
|
|
指示是否启用了自动缓存预读。 此选项对精简配置卷没有影响，因为精简卷的架构无法从预读缓存中受益。 选择
|
|
指示是否应为卷启用读取缓存。 选择
|
|
卷的段大小 所有值均以千比特为单位。 一些常见的选择包括 8、16、32、64、128、256 和 512，但选项取决于系统。 从 netapp_eseries.santricity.na_santricity_facts 中的 segment_sizes 下检索确定的系统列表。 当存储池为 raidDiskPool 时，段大小必须为 128kb。 此模块不允许段大小迁移 默认值： |
|
仅当 *state==”present”* 时才需要。 卷的大小，单位为 *size_unit*。 精简卷的情况下，虚拟卷的大小，单位为 *size_unit*。 精简配置卷的最大虚拟卷大小为 256tb；但是，可能存在其他操作系统级别的限制。 |
|
以字节为单位测量的总卷大小的容差；因此，如果总卷大小在 +/- *size_tolerance_b* 范围内，则不应调整大小。 此参数在不是由 na_santricity_volume 创建的现有卷的情况下可能很有用，因为由于卷对齐和开销，很难提供精确的大小。 默认值： |
|
用于解释大小参数的单位 pct 单位定义总可用存储池大小的百分比。 选择
|
|
是否应在卷上启用现有的 SSD 缓存（如果未定义 SSD 缓存，则失败） 默认值是忽略现有的 SSD 缓存设置。 选择
|
|
要管理的阵列的 ID。此值对于每个阵列必须是唯一的。 默认值： |
|
指定的卷是否应存在 选择
|
|
仅当请求 *state==”present”* 时才需要。 卷应驻留的存储池的名称。 |
|
卷是否应进行精简配置。 仅当 *raid_level==”raidDiskPool”* 时才能创建精简卷。 通常，由于性能影响，不建议使用精简配置。 选择
|
|
这是精简卷扩展策略。 当 *thin_volume_expansion_policy==”automatic”* 且超出 *thin_volume_growth_alert_threshold* 时，将自动扩展 *thin_volume_max_repo_size*。 当 *thin_volume_expansion_policy==”manual”* 且超出 *thin_volume_growth_alert_threshold* 时，存储系统将等待手动干预。 无法在此模块中修改现有精简卷的精简卷扩展策略。 一般来说，您几乎应该始终使用 *thin_volume_expansion_policy==”automatic*。 选择
|
|
这是精简配置存储库利用率阈值（以百分比表示）。 当最大存储库大小的已用存储百分比超过此值时，将发出警报，并且将执行 *thin_volume_expansion_policy*。 值必须介于或等于 10 和 99。 默认值： |
|
这是允许精简卷存储库增长的最大量。 仅当 thin_volume_expansion_policy==”automatic” 时才有意义。 当 thin_volume_max_repo_size 的 thin_volume_repo_size 百分比超过 thin_volume_growth_alert_threshold 时，将发出警告，并且存储阵列将执行 thin_volume_expansion_policy 策略。 当 thin_volume_expansion_policy==”automatic” 时，扩展操作将增加最大存储库大小。 默认值与 size 相同。 |
|
此值（以 size_unit 为单位）设置精简配置存储库的分配空间。 初始值必须在 4gb 到 256gb 之间（包括 4gb 和 256gb），增量为 4gb。 在扩展操作期间，增量必须在 4gb 到 256gb 之间（包括 4gb 和 256gb），增量为 4gb。 如果 thin_volume_expansion_policy==”automatic”，则此选项在扩展期间不起作用。 一般来说，您几乎应该始终使用 *thin_volume_expansion_policy==”automatic*。 |
|
是否应验证 https 证书？ 选择
|
|
包含卷本身元数据的字典。 字典键的长度不能超过 14 个字符 字典值的长度不能超过 240 个字符 |
|
强制模块等待扩展操作完成后再继续。 选择
|
|
包含卷的用途、用户、位置等元数据的字典（字典是为用户认为有用的任何内容而任意定义的） 当存储阵列上存在 workload_name 但元数据不同时，将更新工作负载定义。（更改将更新所有关联的卷！） 定义 metadata 时必须指定 workload_name。 字典键的长度不能超过 16 个字符 字典值的长度不能超过 60 个字符 |
|
由元数据定义的工作负载的标签。 当指定 workload_name 和 metadata 时，定义的工作负载将添加到存储阵列。 当存储阵列上存在 workload_name 但元数据不同时，将更新工作负载定义。（更改将更新所有关联的卷！） 可以使用 netapp_eseries.santricity.na_santricity_facts 检索现有工作负载。 |
|
指示是否应为卷启用写回缓存。 选择
|
|
指示是否应启用写缓存镜像。 选择
|
注释
注意
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: Create simple volume with workload tags (volume meta data)
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
state: present
name: volume
storage_pool_name: storage_pool
size: 300
size_unit: gb
workload_name: volume_tag
metadata:
key1: value1
key2: value2
- name: Create a thin volume
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
state: present
name: volume1
storage_pool_name: storage_pool
size: 131072
size_unit: gb
thin_provision: true
thin_volume_repo_size: 32
thin_volume_max_repo_size: 1024
- name: Expand thin volume's virtual size
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
state: present
name: volume1
storage_pool_name: storage_pool
size: 262144
size_unit: gb
thin_provision: true
thin_volume_repo_size: 32
thin_volume_max_repo_size: 1024
- name: Expand thin volume's maximum repository size
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
state: present
name: volume1
storage_pool_name: storage_pool
size: 262144
size_unit: gb
thin_provision: true
thin_volume_repo_size: 32
thin_volume_max_repo_size: 2048
- name: Delete volume
na_santricity_volume:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
state: absent
name: volume
返回值
常见返回值记录在此处，以下是此模块独有的字段
键 |
描述 |
|---|---|
卷的状态 已返回： 始终 示例： |