netapp_eseries.santricity.netapp_e_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.netapp_e_volume。
netapp_eseries.santricity 2.2.0 中的新增功能
概要
创建或删除 NetApp E/EF 系列存储阵列的卷（标准和精简配置）。
参数
参数 |
注释 |
|---|---|
用于向 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。 |
|
SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。示例 https://prod-1.wahoo.acme.com/devmgr/v2 |
|
用于向 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。 |
|
指示是否应在没有电池备份的情况下使用缓存。 警告，如果 cache_without_batteries==true 并且存储系统断电且没有电池备份，则数据将会丢失！ 选项
|
|
确定是否应为卷启用数据保证 (DA) 仅在创建新卷以及在支持 DA 功能的驱动器的存储池上可用。 选项
|
|
wait_for_initialization 操作终止之前的持续时间（以秒为单位）。 wait_for_initialization==True 才能对模块的操作产生任何影响。 |
|
包含卷用途、用户、位置等的元数据的字典（字典是为用户认为有用的任何内容任意定义的） 如果存储阵列上存在 workload_name 但元数据不同，则将更新工作负载定义。（更改将更新所有关联的卷！） 定义 metadata 时必须指定 workload_name。 |
|
要管理的卷的名称。 |
|
指定哪个控制器将成为卷的主要所有者 不指定将允许控制器选择所有权。 选项
|
|
指示是否启用自动缓存预读。 此选项对精简配置的卷无效，因为精简配置卷的体系结构无法从预读缓存中受益。 选项
|
|
指示是否应为卷启用读取缓存。 选项
|
|
卷的段大小 所有值均以千字节为单位。 一些常见的选项包括“8”、“16”、“32”、“64”、“128”、“256”和“512”，但选项取决于系统。 从 netapp_eseries.santricity.netapp_e_facts 下的 segment_sizes 中检索最终的系统列表。 如果存储池是 raidDiskPool，则段大小必须为 128kb。 此模块不允许段大小迁移 默认值： |
|
仅当 state==’present’ 时才需要。 以 size_unit 为单位的卷大小。 精简配置卷的虚拟卷大小（以 size_unit 为单位）。 精简配置卷的最大虚拟卷大小为 256tb；但是，可能存在其他操作系统级别的限制。 |
|
用于解释 size 参数的单位 选项
|
|
是否应在卷上启用现有的 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_unit为单位）相同。 |
|
此值（以size_unit为单位）设置精简配置存储库的分配空间。 初始值必须在4GB和256GB之间（包含4GB和256GB），且必须是4GB的倍数。 在扩展操作期间，增量必须在4GB和256GB之间（包含4GB和256GB），且必须是4GB的倍数。 如果thin_volume_expansion_policy==”automatic”，则此选项在扩展期间无效。 一般来说，您几乎总是应该使用 thin_volume_expansion_policy==”automatic。 |
|
是否应验证https证书？ 选项
|
|
强制模块在继续之前等待扩展操作完成。 选项
|
|
元数据定义的工作负载标签。 当指定workload_name和metadata时，将把定义的工作负载添加到存储阵列。 如果存储阵列上存在 workload_name 但元数据不同，则将更新工作负载定义。（更改将更新所有关联的卷！） 可以使用netapp_eseries.santricity.netapp_e_facts检索现有工作负载。 |
|
指示是否应为卷启用写回缓存。 选项
|
注释
注意
E 系列 Ansible 模块需要 Web 服务代理 (WSP) 实例可用以管理存储系统，或者支持嵌入式 Web 服务 API 的 E 系列存储系统。
嵌入式 Web 服务目前适用于 E2800、E5700、EF570 和更新的硬件型号。
可以使用netapp_eseries.santricity.netapp_e_storage_system配置由 WSP 实例管理的系统。
示例
- name: Create simple volume with workload tags (volume meta data)
netapp_e_volume:
ssid: "{{ ssid }}"
api_url: "{{ netapp_api_url }}"
api_username: "{{ netapp_api_username }}"
api_password: "{{ netapp_api_password }}"
validate_certs: "{{ netapp_api_validate_certs }}"
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
netapp_e_volume:
ssid: "{{ ssid }}"
api_url: "{{ netapp_api_url }}"
api_username: "{{ netapp_api_username }}"
api_password: "{{ netapp_api_password }}"
validate_certs: "{{ netapp_api_validate_certs }}"
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
netapp_e_volume:
ssid: "{{ ssid }}"
api_url: "{{ netapp_api_url }}"
api_username: "{{ netapp_api_username }}"
api_password: "{{ netapp_api_password }}"
validate_certs: "{{ netapp_api_validate_certs }}"
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
netapp_e_volume:
ssid: "{{ ssid }}"
api_url: "{{ netapp_api_url }}"
api_username: "{{ netapp_api_username }}"
api_password: "{{ netapp_api_password }}"
validate_certs: "{{ netapp_api_validate_certs }}"
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
netapp_e_volume:
ssid: "{{ ssid }}"
api_url: "{{ netapp_api_url }}"
api_username: "{{ netapp_api_username }}"
api_password: "{{ netapp_api_password }}"
validate_certs: "{{ netapp_api_validate_certs }}"
state: absent
name: volume
返回值
常见的返回值已在此处记录，以下是此模块特有的字段
键 |
描述 |
|---|---|
卷的状态 返回值：始终返回 示例： |