netapp.ontap.na_ontap_svm 模块 – NetApp ONTAP SVM
注意
此模块是 netapp.ontap 集合 (版本 22.13.0) 的一部分。
如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install netapp.ontap。您需要其他要求才能使用此模块，有关详细信息，请参阅 需求。
要在 playbook 中使用它，请指定： netapp.ontap.na_ontap_svm。
netapp.ontap 2.6.0 新增功能
概要
在 NetApp ONTAP 上创建、修改或删除 SVM
需求
执行此模块的主机需要以下要求。
Ansible 2.9 或更高版本 - 建议使用 2.12 或更高版本。
Python3 - 建议使用 3.9 或更高版本。
使用 ZAPI 时，需要 netapp-lib 2018.11.13 或更高版本（使用“pip install netapp-lib”安装），强烈建议使用 netapp-lib 2020.3.12，因为它提供了更好的连接问题错误报告。
物理或虚拟集群式 Data ONTAP 系统，模块支持 Data ONTAP 9.1 及更高版本，REST 支持需要 ONTAP 9.6 或更高版本。
参数
参数 |
注释 |
|---|---|
创建 SVM 时，它将处于运行状态，除非另有指定。 在 ZAPI 中忽略此项。 选项
|
|
为卷操作分配的聚合列表。 这些聚合可以与其他 Vserver 共享。 在 vserver-create 中指定时，此字段表示分配给 Vserver 用于卷操作的聚合列表。 作为 vserver-get-iter 调用的一部分时，这将返回具有作为 aggr 列表一部分指定的任何聚合的 Vserver 列表。 |
|
允许的协议。 此字段表示 Vserver 上允许的协议列表。 在修改时，此字段应包含现有列表以及要添加的新协议列表，以防止数据中断。 可能的值 nfs NFS 协议， cifs CIFS 协议， fcp FCP 协议， iscsi iSCSI 协议， ndmp NDMP 协议， s3 S3 协议， http HTTP 协议 - 仅限 ZAPI， nvme NVMe 协议 |
|
SSL 客户端证书文件（.pem）的路径。 不支持 python 2.6。 |
|
在 vserver-create 中指定时，此字段表示与 Vserver 关联的注释。 作为 vserver-get-iter 调用的一部分时，这将返回匹配的 Vserver 列表。 |
|
启用或禁用新功能。 这可以用来启用实验性功能或禁用破坏向后兼容性的新功能。 支持的键和值可能会在未经通知的情况下更改。未知键将被忽略。 |
|
使用 REST 时覆盖集群 ONTAP 版本。 如果版本与目标集群不匹配，则行为未定义。 这是在由于权限问题无法读取集群版本时提供的解决方法。请参阅 https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues。 这应采用 9.10 或 9.10.1 的形式，每个元素都是一个整数。 当 在 ZAPI 中忽略此项。 |
|
要重命名的 SVM 的名称 |
|
ONTAP 实例的主机名或 IP 地址。 |
|
使用此端口覆盖默认端口 (80 或 443) |
|
启用和禁用 https。 使用 REST 时忽略，因为仅支持 https。 使用 SSL 证书身份验证时忽略，因为它需要 SSL。 选项
|
|
如果目标支持 REST，则设置为 true 时，忽略 当 选项
|
|
IP空间名称 创建后无法修改。 |
|
SSL客户端密钥文件路径。 |
|
SVM使用的语言 默认为C.UTF-8 可能的语言值 c POSIX ar 阿拉伯语 cs 捷克语 da 丹麦语 de 德语 en 英语 en_us 美式英语 es 西班牙语 fi 芬兰语 fr 法语 he 希伯来语 hr 克罗地亚语 hu 匈牙利语 it 意大利语 ja 日语 euc-j ja_v1 日语 euc-j ja_jp.pck 日文 PCK (sjis) ja_jp.932 日文 cp932 ja_jp.pck_v2 日文 PCK (sjis) ko 韩语 no 挪威语 nl 荷兰语 pl 波兰语 pt 葡萄牙语 ro 罗马尼亚语 ru 俄语 sk 斯洛伐克语 sl 斯洛文尼亚语 sv 瑞典语 tr 土耳其语 zh 简体中文 zh.gbk 简体中文 (GBK) zh_tw 繁体中文 euc-tw zh_tw.big5 繁体中文 Big 5 utf8mb4 大多数值都接受.utf_8后缀，例如fr.utf_8 |
|
可在vserver上创建的卷的最大数量。 需要整数或 |
|
要管理的SVM的名称。 使用module_defaults时，vserver是一个方便的别名。 |
|
要使用的ontap api版本 |
|
指定用户的密码。 |
|
SVM的根卷。 创建后无法修改。 |
|
将创建根卷的聚合。 创建后无法修改。 |
|
根卷的安全样式。 在vserver创建中指定时，此字段表示Vserver根卷的安全样式。 在vserver-get-iter调用中指定时，这将返回匹配的Vserver列表。 仅适用于无限卷的“unified”安全样式不能应用于Vserver的根卷。 创建后无法修改。 选项
|
|
启用的协议，仅适用于REST。 如有需要，服务将启动。可能需要有效的许可证。
如果服务不存在，则保持不变。 |
|
CIFS协议服务 |
|
如果为true，则SVM管理员可以管理CIFS服务。如果为false，则只有集群管理员可以管理该服务。 选项
|
|
FCP协议服务 |
|
如果为true，则SVM管理员可以管理FCP服务。如果为false，则只有集群管理员可以管理该服务。 选项
|
|
如果允许，设置为true将启用FCP服务。 选项
|
|
iSCSI协议服务 |
|
如果为true，则SVM管理员可以管理iSCSI服务。如果为false，则只有集群管理员可以管理该服务。 选项
|
|
如果允许，设置为true将启用iSCSI服务。 选项
|
|
网络数据管理协议服务 |
|
如果设置为true，则SVM管理员可以管理NDMP服务 如果为false，则只有集群管理员可以管理该服务。 需要ONTAP 9.10.1或更高版本。 选项
|
|
NFS协议服务 |
|
如果为true，则SVM管理员可以管理NFS服务。如果为false，则只有集群管理员可以管理该服务。 选项
|
|
如果允许，设置为true将启用NFS服务。 选项
|
|
nvme协议服务 |
|
如果为true，则SVM管理员可以管理NVMe服务。如果为false，则只有集群管理员可以管理该服务。 选项
|
|
如果允许，设置为true将启用NVMe服务。 选项
|
|
s3服务 |
|
如果为true，则SVM管理员可以管理s3服务。如果为false，则只有集群管理员可以管理该服务。 需要ONTAP 9.7.0或更高版本。 选项
|
|
所有Vserver卷的默认快照策略设置。除非卷创建请求明确提供快照策略或卷稍后使用特定快照策略进行修改，否则此策略将分配给在此Vserver中创建的所有卷。卷级快照策略始终会覆盖默认的Vserver范围快照策略。 |
|
指定的SVM是否存在。 选项
|
|
要创建的vserver的子类型。 创建后无法修改。 选项
|
|
是否使用REST或ZAPI。 always – 如果模块支持REST，则始终使用REST API。如果模块不支持REST，则会发出警告。如果REST中不支持模块选项，则会发出错误。 never – 如果模块支持ZAPI，则始终使用ZAPI。如果ZAPI中不支持REST选项，则可能会发出错误。 auto – 如果模块支持REST并且支持模块选项，则尝试使用REST API。否则恢复为ZAPI。 默认： |
|
这可以是集群范围或SVM范围的帐户，具体取决于是否需要集群级别或SVM级别的API。 更多信息，请阅读文档 https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/。 支持两种身份验证方法
要使用证书，必须已将证书安装在ONTAP集群中，并且必须已启用证书身份验证。 |
|
如果设置为 仅当在使用自签名证书的个人控制站点上使用时，才应将其设置为 选项
|
|
web服务安全配置。 证书名称需要ONTAP 9.8或更高版本。 其他选项需要ONTAP 9.10.1或更高版本。 |
|
集群和节点管理接口用于TLS连接请求的证书名称。 证书必须是“server”类型。 |
|
是否启用了客户端身份验证。 选项
|
|
是否启用了在线证书状态协议验证。 选项
|
备注
注意
以na_ontap为前缀的模块旨在支持ONTAP存储平台。
https默认启用并推荐使用。要在集群上启用http，必须运行以下命令“set -privilege advanced;” “system services web modify -http-enabled true;”
示例
- name: Create SVM
netapp.ontap.na_ontap_svm:
state: present
name: ansibleVServer
root_volume: vol1
root_volume_aggregate: aggr1
root_volume_security_style: mixed
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Create SVM
netapp.ontap.na_ontap_svm:
state: present
services:
cifs:
allowed: true
fcp:
allowed: true
nfs:
allowed: true
enabled: true
s3:
allowed: true
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
https: true
validate_certs: false
- name: Stop SVM REST
netapp.ontap.na_ontap_svm:
state: present
name: ansibleVServer
admin_state: stopped
use_rest: always
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"