netapp.ontap.na_ontap_nfs 模块 – NetApp ONTAP NFS 状态
注意
此模块是 netapp.ontap 集合 (版本 22.13.0) 的一部分。
如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install netapp.ontap。您需要其他要求才能使用此模块，请参阅 要求 获取详细信息。
要在 playbook 中使用它，请指定：netapp.ontap.na_ontap_nfs。
netapp.ontap 2.6.0 中的新增功能
摘要
启用或禁用 ONTAP 上的 NFS
要求
在执行此模块的主机上需要以下要求。
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 或更高版本。
参数
参数 |
注释 |
|---|---|
SSL 客户端证书文件（.pem）的路径。 python 2.6 不支持。 |
|
启用或禁用新功能。 这可以用来启用实验性功能或禁用破坏向后兼容性的新功能。 支持的键和值可能会在未经通知的情况下更改。未知键将被忽略。 |
|
使用 REST 时覆盖集群 ONTAP 版本。 如果版本与目标集群不匹配，则行为未定义。 这是在由于权限问题无法读取集群版本时提供的解决方法。请参阅 https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues。 这应该采用 9.10 或 9.10.1 的形式，每个元素都是整数。 当 ZAPI 忽略。 |
|
ONTAP 实例的主机名或 IP 地址。 |
|
使用此端口覆盖默认端口（80 或 443） |
|
启用和禁用 https。 使用 REST 时忽略，因为仅支持 https。 使用 SSL 证书身份验证时忽略，因为它需要 SSL。 选项
|
|
SSL 客户端密钥文件的路径。 |
|
NFSv3 的状态。 选项
|
|
NFSv3 客户端在遍历文件系统时是否看到 FSID 更改的状态。 选项
|
|
NFSv4 的状态。 选项
|
|
NFS v4.0 ACL 功能的状态 选项
|
|
NFS v4.0 读取委托功能的状态。 选项
|
|
NFS v4.0 转发的状态。 选项
|
|
NFS v4.0 写入委托功能的状态。 选项
|
|
NFSv41 的状态。
请为此选项专门使用 选项
|
|
NFS v4.1 ACL 功能的状态 选项
|
|
NFSv41 pNFS 的状态。 选项
|
|
NFS v4.1 读取委托功能的状态。 选项
|
|
NFS v4.1 转发的状态。 选项
|
|
NFS v4.1 写入委托功能的状态。 选项
|
|
NFSv4 客户端在遍历文件系统时是否看到 FSID 更改的状态。 选项
|
|
要使用的 nfsv4_id_domain 的名称。 |
|
NFSv4 数字 ID 的状态。 选项
|
|
要使用的 ONTAP API 版本 |
|
指定用户的密码。 |
|
使用 REST 时可以设置或修改此选项。 它需要 ONTAP 9.11.0 或更高版本。 |
|
指定 Windows ACL 是否影响 NFS 中的 root 访问。 如果启用此选项，则 NFS 中的 root 访问将忽略设置在文件或目录上的 NT ACL。 选项
|
|
指定是否跳过对来自 root/owner 的 NFS WRITE 调用的权限检查。 对于将只读文件复制到具有可继承 ACL 的目标文件夹，必须启用此选项。 选项
|
|
使用 REST 时可以设置或修改此选项。 它需要 ONTAP 9.11.0 或更高版本。 |
|
指定文件所有权是否只能由超级用户更改，或者非 root 用户是否也可以更改文件所有权。 如果此选项设置为 restricted，则即使磁盘上的权限允许非 root 用户更改文件所有权，文件所有权也只能由超级用户更改。 如果此选项设置为 unrestricted，则超级用户和非 root 用户都可以根据磁盘上的权限授予的访问权限来更改文件所有权。 如果此选项设置为 use-export-policy，则将根据相关的导出规则更改文件所有权。 选项
|
|
控制对已设置 NT ACL 的文件或目录显示给 NFSv3 和 NFSv4 客户端的权限。 如果为 true，则显示的权限基于 NT ACL 授予任何用户的最大访问权限。 如果为 false，则显示的权限基于 NT ACL 授予任何用户的最小访问权限。 选项
|
|
指定 NFSv3 安全性更改如何影响 NTFS 卷。 如果将此选项设置为 ignore，ONTAP 将忽略 NFSv3 安全性更改。 如果将此选项设置为 fail，则会覆盖相关导出规则中设置的 UNIX 安全性选项。 如果将此选项设置为 use_export_policy，ONTAP 将根据相关导出规则处理 NFSv3 安全性更改。 选项
|
|
指定 Kerberos over NFS 允许的加密类型。 |
|
指定 RPCSEC_GSS 上下文在删除之前允许保持未使用的秒数。 |
|
指定的 NFS 是否应启用或禁用。如果不存在，则创建 NFS 服务。 选项
|
|
SVM 是否允许 showmount。 使用 REST 时，从 ONTAP 9.8 版本开始支持。 选项
|
|
NFS 是否应该存在。 选项
|
|
启用 TCP（从 ONTAP 9.3 开始支持）。 选项
|
|
TCP 最大传输大小（字节）。默认值为 65536。 此选项需要 REST 中的 ONTAP 9.11.0 或更高版本。 |
|
启用 UDP（从 ONTAP 9.3 开始支持）。 选项
|
|
是否使用 REST 或 ZAPI。 always – 如果模块支持 REST，则始终使用 REST API。如果模块不支持 REST，则会发出警告。如果模块选项在 REST 中不受支持，则会发出错误。 never – 如果模块支持 ZAPI，则始终使用 ZAPI。如果 REST 选项在 ZAPI 中不受支持，则可能会发出错误。 auto – 如果模块支持 REST 并且支持模块选项，则尝试使用 REST API。否则恢复为 ZAPI。 默认值： |
|
这可以是集群范围或 SVM 范围的帐户，具体取决于是否需要集群级或 SVM 级 API。 更多信息，请阅读文档 https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/。 支持两种身份验证方法
要使用证书，必须已在 ONTAP 集群中安装该证书，并且必须已启用证书身份验证。 |
|
如果设置为 仅应在使用自签名证书的个人控制站点上将其设置为 选项
|
|
要使用的 vserver 的名称。 |
|
vstorage_state 的状态。 选项
|
|
使用 REST 时可以设置或修改此选项。 它需要 ONTAP 9.11.0 或更高版本。 |
|
指定 NFS 服务器的默认 Windows 用户。 |
|
指定是否启用将未知 UID 映射到默认 Windows 用户。 选项
|
|
指定是否启用 NFSv3 MS-DOS 客户端支持。 选项
|
注释
注意
以 na_ontap 为前缀的模块旨在支持 ONTAP 存储平台。
默认情况下启用 https，建议使用。要在集群上启用 http，必须运行以下命令“set -privilege advanced;”“system services web modify -http-enabled true;”
示例
- name: change nfs status
netapp.ontap.na_ontap_nfs:
state: present
service_state: stopped
vserver: vs_hack
nfsv3: disabled
nfsv4: disabled
nfsv41: enabled
tcp: disabled
udp: disabled
vstorage_state: disabled
nfsv4_id_domain: example.com
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: create nfs configuration - REST
netapp.ontap.na_ontap_nfs:
state: present
service_state: stopped
vserver: vs_hack
nfsv3: disabled
nfsv4: disabled
nfsv41: enabled
tcp: disabled
udp: disabled
vstorage_state: disabled
nfsv4_id_domain: example.com
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Modify nfs configuration - REST
netapp.ontap.na_ontap_nfs:
state: present
vserver: vs_hack
root:
ignore_nt_acl: true
skip_write_permission_check: true
security:
chown_mode: restricted
nt_acl_display_permission: true
ntfs_unix_security: fail
rpcsec_context_idle: 5
windows:
v3_ms_dos_client_enabled: true
map_unknown_uid_to_default_user: false
default_user: test_user
tcp_max_xfer_size: 16384
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Delete nfs configuration
netapp.ontap.na_ontap_nfs:
state: absent
vserver: vs_hack
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"