netapp.ontap.na_ontap_name_mappings 模块 – NetApp ONTAP 名称映射

注意

此模块是 netapp.ontap 集合（版本 22.13.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install netapp.ontap。您需要进一步的要求才能使用此模块，请参阅要求了解详细信息。

要在 playbook 中使用它，请指定：netapp.ontap.na_ontap_name_mappings。

netapp.ontap 22.0.0 中的新增功能

概要

  • 在 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 或更高版本。

参数

参数

注释

cert_filepath

字符串

在 netapp.ontap 20.6.0 中添加

SSL 客户端证书文件（.pem）的路径。

不支持 Python 2.6。

client_match

字符串

在搜索模式时匹配的客户端工作站 IP 地址。

示例 ‘10.254.101.111/28’

客户端匹配值可以是以下任何格式： - 作为具有子网掩码（表示为位数）的 IPv4 地址；例如，10.1.12.0/24 - 作为具有子网掩码（表示为位数）的 IPv6 地址；例如，fd20:8b1e:b255:4071::/64 - 作为具有网络掩码的 IPv4 地址；例如，10.1.16.0/255.255.255.0 - 作为主机名

direction

字符串 / 必需

应用名称映射的方向。

可能的值为：krb_unix - Kerberos 主体名称到 UNIX 用户名 win_unix - Windows 用户名到 UNIX 用户名 unix_win - UNIX 用户名到 Windows 用户名映射 s3_unix - S3 用户名到 UNIX 用户名映射 s3_win - S3 用户名到 Windows 用户名映射

s3_unix 和 s3_win 需要 ONTAP 9.12.1 或更高版本。

选择

  • "krb_unix"

  • "win_unix"

  • "unix_win"

  • "s3_unix"

  • "s3_win"

feature_flags

字典

在 netapp.ontap 20.5.0 中添加

启用或禁用新功能。

这可用于启用实验性功能或禁用破坏向后兼容性的新功能。

支持的键和值可能会在没有通知的情况下更改。未知的键将被忽略。

force_ontap_version

字符串

在 netapp.ontap 21.23.0 中添加

当使用 REST 时覆盖集群 ONTAP 版本。

如果版本与目标集群不匹配，则行为未定义。

当由于权限问题而无法读取集群版本时，这作为一种解决方法提供。请参阅 https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues。

这应采用 9.10 或 9.10.1 的形式，每个元素都是一个整数。

from_index

整数

如果找不到具有索引的条目，则通过重新索引 from_index 的条目来创建它。

如果找不到 index 和 from_index 的条目，则会报告错误。

最小值是 1，最大值是 2147483647。

需要 ONTAP 版本 9.7 或更高版本。

hostname

字符串 / 必需

ONTAP 实例的主机名或 IP 地址。

http_port

整数

使用此端口覆盖默认端口（80 或 443）

https

布尔值

启用和禁用 https。

当使用 REST 时，由于仅支持 https，因此将被忽略。

当使用 SSL 证书身份验证时，由于它需要 SSL，因此将被忽略。

选择

  • false ←（默认）

  • true

index

整数 / 必需

在名称映射列表中的位置。

最小值是 1，最大值是 2147483647。

key_filepath

字符串

在 netapp.ontap 20.6.0 中添加

SSL 客户端密钥文件的路径。

password

别名：pass

字符串

指定用户的密码。

pattern

字符串

在搜索可用作替换的名称时使用的模式。

该模式是 UNIX 样式的正则表达式。

当从 Windows 映射到 UNIX 时，正则表达式不区分大小写，并且从 Kerberos 映射到 UNIX 和从 UNIX 映射到 Windows 时，正则表达式区分大小写。

最小长度为 1，最大长度为 256。

对于每个虚拟服务器索引，模式应该是唯一的。

示例：ENGCIFS_AD_USER。

替换

字符串

如果与此条目关联的模式匹配，则用作替换的名称。

最小长度为 1，最大长度为 256。

示例：unix_user1。

状态

字符串

指定名称映射是否应存在。

选择

  • "present" ←（默认）

  • "absent"

use_rest

字符串

此模块仅支持 REST。

always – 将始终使用 REST API。如果模块不支持 REST，则会发出警告。

默认值： "always"

用户名

别名：user

字符串

这可以是集群范围的帐户或 SVM 范围的帐户，具体取决于需要集群级别 API 还是 SVM 级别 API。

有关更多信息，请阅读文档 https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/。

支持两种身份验证方法

  1. 基本身份验证，使用用户名和密码，

  2. SSL 证书身份验证，使用 SSL 客户端证书文件，以及可选的私钥文件。

要使用证书，必须已在 ONTAP 集群中安装证书，并且必须启用证书身份验证。

validate_certs

布尔值

如果设置为 no，则不会验证 SSL 证书。

仅当在个人控制的站点上使用自签名证书时，才应将其设置为 False。

选择

  • false

  • true ←（默认）

vserver

字符串 / 必需

要使用的虚拟服务器的名称。

注释

注意

  • 以 na_ontap 为前缀的模块旨在支持 ONTAP 存储平台。

  • 默认情况下启用 https 并推荐使用。要在集群上启用 http，您必须运行以下命令“set -privilege advanced;” “system services web modify -http-enabled true;”

示例

- name: create name mappings configuration
  netapp.ontap.na_ontap_name_mappings:
    vserver: vserverName
    direction: win_unix
    index: 1
    pattern: ENGCIFS_AD_USER
    replacement: unix_user
    client_match: 10.254.101.111/28
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: modify name mappings configuration
  netapp.ontap.na_ontap_name_mappings:
    vserver: vserverName
    direction: win_unix
    index: 1
    pattern: ENGCIFS_AD_USERS
    replacement: unix_user1
    client_match: 10.254.101.112/28
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Swap name mappings position
  netapp.ontap.na_ontap_name_mappings:
    vserver: vserverName
    direction: win_unix
    index: 1
    pattern: ENGCIFS_AD_USERS
    replacement: unix_user1
    from_index: 2
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete name mappings configuration
  netapp.ontap.na_ontap_name_mappings:
    vserver: vserverName
    direction: win_unix
    index: 1
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

作者

  • NetApp Ansible 团队 (@carchi8py)