dellemc.unity.nasserver 模块 – 管理 Unity 存储系统上的 NAS 服务器

注意

此模块是 dellemc.unity 集合 (版本 2.0.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install dellemc.unity。您需要其他要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定： dellemc.unity.nasserver。

dellemc.unity 1.1.0 中的新增功能

概要 

管理 Unity 存储系统上的 NAS 服务器包括获取和修改 NAS 服务器。

要求 

执行此模块的主机需要以下要求。

Dell Unity 存储设备版本 5.1 或更高版本。
Ansible-core 2.14 或更高版本。
Python 3.9、3.10 或 3.11。
Storops Python SDK 1.2.11。

参数 

参数	注释
allow_unmapped_user 布尔值	此标志用于在任何用户映射失败的情况下强制禁用访问。如果 `true`，则在任何用户映射失败的情况下启用访问。如果 `false`，则在任何用户映射失败的情况下禁用访问。可以在修改 NAS 服务器时提及。选项 `false` `true`
current_unix_directory_service 字符串	这是用于查询 UNIX 身份信息（例如 UID、GID、网络组）的目录服务。可以在修改 NAS 服务器时提及。选项 `"NONE"` `"NIS"` `"LOCAL"` `"LDAP"` `"LOCAL_THEN_NIS"` `"LOCAL_THEN_LDAP"`
default_unix_user 字符串	在 Windows 到 Unix 用户映射失败的情况下用于授予访问权限的默认 Unix 用户名。可以在修改 NAS 服务器时提及。
default_windows_user 字符串	在 Unix 到 Windows 用户映射失败的情况下用于授予访问权限的默认 Windows 用户名。可以在修改 NAS 服务器时提及。
enable_windows_to_unix_username_mapping 布尔值	此参数指示是否启用了 Unix 到/从 Windows 用户名映射。可以在修改 NAS 服务器时提及。选项 `false` `true`
is_backup_only 布尔值	它指定 NAS 服务器是否仅用作备份。可以在修改 NAS 服务器时提及。选项 `false` `true`
is_multiprotocol_enabled 布尔值	此参数指示是否启用了多协议共享模式。可以在修改 NAS 服务器时提及。选项 `false` `true`
is_packet_reflect_enabled 布尔值	如果必须反射数据包，则此参数必须设置为 `true`。可以在修改 NAS 服务器时提及。选项 `false` `true`
is_replication_destination 布尔值	它指定 NAS 服务器是否为复制目标。可以在修改 NAS 服务器时提及。选项 `false` `true`
nas_server_id 字符串	NAS 服务器的 ID。需要 nas_server_name 或 nas_server_id 来执行任务。参数 nas_server_name 和 nas_server_id 是互斥的。
nas_server_name 字符串	NAS 服务器的名称。需要 nas_server_name 或 nas_server_id 来执行任务。参数 nas_server_name 和 nas_server_id 是互斥的。
nas_server_new_name 字符串	NAS 服务器的新名称。可以在修改 NAS 服务器时提及。
password 字符串 / 必需	Unity 管理服务器的密码。
port 整数	与 Unity 管理服务器进行通信的端口号。默认值： `443`
replication_params 字典	启用复制所需的设置。
destination_nas_server_name 字符串	目标 NAS 服务器的名称。默认值为源 NAS 服务器名称前缀为“DR_”。
destination_pool_id 字符串	分配目标 LUN 的池 ID。与 destination_pool_name 互斥。
destination_pool_name 字符串	分配目标 LUN 的池名称。与 destination_pool_id 互斥。
destination_sp 字符串	目标 NAS 服务器的存储进程选项 `"SPA"` `"SPB"`
is_backup 布尔值	指示目标 NAS 服务器是否为备份。选项 `false` `true`
new_replication_name 字符串	要将会话重命名为的复制名称。
remote_system 字典	正在配置复制到的远程系统的详细信息。如果 replication_type 为 `remote`，则应指定 remote_system 选项。
remote_system_host 字符串 / 必需	远程 Unity Unisphere 主机的 IP 或 FQDN。
remote_system_password 字符串 / 必需	远程 Unity Unisphere 主机的密码。
remote_system_port 整数	托管远程 Unity Unisphere 的端口。默认值： `443`
remote_system_username 字符串 / 必需	远程 Unity Unisphere 主机的用户名。
remote_system_verifycert 布尔值	布尔变量，用于指定是否验证远程 Unity Unisphere 主机的 SSL 证书。 `true` - 表示应验证 SSL 证书。 `false` - 表示不应验证 SSL 证书。选项 `false` `true` ← (默认值)
replication_mode 字符串	复制模式。启用复制时，此参数必填。选项 `"异步"` `"手动"`
replication_name 字符串	用户定义的复制会话名称。
replication_type 字符串	复制类型。选项 `"本地"` `"远程"`
rpo 整数	系统同步源 LUN 和目标 LUN 之前等待的最长时间。如果replication_mode 为 `asynchronous`，则应指定rpo 选项。值应在 `5` 到 `1440` 之间。
replication_reuse_resource 布尔值	此参数指示是否要使用现有的 NAS 服务器进行复制。选项 `false` `true`
replication_state 字符串	复制状态。选项 `"启用"` `"禁用"`
state 字符串 / 必需	定义阵列上 NAS 服务器的状态。此值表示任务执行后系统中应存在 NAS 服务器。在此版本中，不支持删除 NAS 服务器。因此，如果为任何现有 NAS 服务器将 state 设置为 `absent`，则会抛出错误。对于任何不存在的 NAS 服务器，如果 state 设置为 `absent`，则它将返回 None。选项 `"存在"` `"不存在"`
unispherehost 字符串 / 必需	Unity 管理服务器的 IP 地址或 FQDN。
username 字符串 / 必需	Unity 管理服务器的用户名。
validate_certs 别名：verifycert 布尔值	布尔变量，用于指定是否验证 SSL 证书。 `true` - 表示应验证 SSL 证书。 `false` - 表示不应验证 SSL 证书。选项 `false` `true` ← (默认值)

备注 

注意

不支持check_mode。
此集合中名为“dellemc.unity”的模块旨在支持 Dell Unity 存储平台。

示例 

- name: Get Details of NAS Server
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "{{nas_server_name}}"
    state: "present"

- name: Modify Details of NAS Server
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "{{nas_server_name}}"
    nas_server_new_name: "updated_sample_nas_server"
    is_replication_destination: false
    is_backup_only: false
    is_multiprotocol_enabled: true
    allow_unmapped_user: true
    default_unix_user: "default_unix_sample_user"
    default_windows_user: "default_windows_sample_user"
    enable_windows_to_unix_username_mapping: true
    current_unix_directory_service: "LDAP"
    is_packet_reflect_enabled: true
    state: "present"

- name: Enable replication for NAS Server on Local System
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_id: "nas_10"
    replication_reuse_resource: false
    replication_params:
      replication_name: "test_replication"
      destination_nas_server_name: "destination_nas"
      replication_mode: "asynchronous"
      rpo: 60
      replication_type: "local"
      destination_pool_name: "Pool_Ansible_Neo_DND"
      destination_sp: "SPA"
      is_backup: true
    replication_state: "enable"
    state: "present"

- name: Enable replication for NAS Server on Remote System
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_reuse_resource: false
    replication_params:
      replication_name: "test_replication"
      destination_nas_server_name: "destination_nas"
      replication_mode: "asynchronous"
      rpo: 60
      replication_type: "remote"
      remote_system:
        remote_system_host: '10.10.10.10'
        remote_system_verifycert: false
        remote_system_username: 'test1'
        remote_system_password: 'test1!'
      destination_pool_name: "fastVP_pool"
      destination_sp: "SPA"
      is_backup: true
    replication_state: "enable"
    state: "present"

- name: Enable replication for NAS Server on Remote System in existing NAS Server
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_reuse_resource: true
    replication_params:
      destination_nas_server_name: "destination_nas"
      replication_mode: "asynchronous"
      rpo: 60
      replication_type: "remote"
      replication_name: "test_replication"
      remote_system:
        remote_system_host: '10.10.10.10'
        remote_system_verifycert: false
        remote_system_username: 'test1'
        remote_system_password: 'test1!'
      destination_pool_name: "fastVP_pool"
    replication_state: "enable"
    state: "present"

- name: Modify replication on the nasserver
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_params:
      replication_name: "test_repl"
      new_replication_name: "test_repl_updated"
      replication_mode: "asynchronous"
      rpo: 50
    replication_state: "enable"
    state: "present"

- name: Disable replication on the nasserver
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_state: "disable"
    state: "present"

- name: Disable replication by specifying replication_name on the nasserver
  dellemc.unity.nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_params:
      replication_name: "test_replication"
    replication_state: "disable"
    state: "present"

返回值 

常见的返回值已在此处记录，以下是此模块特有的字段

键	描述
changed 布尔值	资源是否已更改。返回值：始终示例： `true`
nas_server_details 字典	NAS 服务器详细信息。返回值：NAS 服务器存在时。示例： {"allow_unmapped_user": null, "cifs_server": {"UnityCifsServerList": [{"UnityCifsServer": {"hash": 8761756885270, "id": "cifs_34"}}]}, "current_sp": {"UnityStorageProcessor": {"hash": 8761756885273, "id": "spb"}}, "current_unix_directory_service": "NasServerUnixDirectoryServiceEnum.NIS", "default_unix_user": null, "default_windows_user": null, "existed": true, "file_dns_server": {"UnityFileDnsServer": {"hash": 8761756885441, "id": "dns_12"}}, "file_interface": {"UnityFileInterfaceList": [{"UnityFileInterface": {"hash": 8761756889908, "id": "if_37"}}]}, "filesystems": null, "hash": 8761757005084, "health": {"UnityHealth": {"hash": 8761756867588}}, "home_sp": {"UnityStorageProcessor": {"hash": 8761756867618, "id": "spb"}}, "id": "nas_10", "is_backup_only": false, "is_multi_protocol_enabled": false, "is_packet_reflect_enabled": false, "is_replication_destination": false, "is_replication_enabled": true, "is_windows_to_unix_username_mapping_enabled": null, "name": "dummy_nas", "pool": {"UnityPool": {"hash": 8761756885360, "id": "pool_7"}}, "preferred_interface_settings": {"UnityPreferredInterfaceSettings": {"hash": 8761756885438, "id": "preferred_if_10"}}, "replication_type": "ReplicationTypeEnum.REMOTE", "size_allocated": 3489660928, "tenant": null, "virus_checker": {"UnityVirusChecker": {"hash": 8761756885426, "id": "cava_10"}}}
allow_unmapped_user 布尔值	如果任何用户映射失败，则启用/禁用访问状态。返回值：成功
current_unix_directory_service 字符串	用于查询 UNIX 身份信息（如 UID、GID、网络组）的目录服务。返回值：成功
default_unix_user 字符串	在 Windows 到 Unix 用户映射失败的情况下用于授予访问权限的默认 Unix 用户名。返回值：成功
default_windows_user 字符串	在 Unix 到 Windows 用户映射失败的情况下用于授予访问权限的默认 Windows 用户名。返回值：成功
id 字符串	NAS 服务器的 ID。返回值：成功
is_backup_only 布尔值	NAS 服务器是否仅用作备份。返回值：成功
is_multi_protocol_enabled 布尔值	指示是否启用了多协议共享模式。返回值：成功
is_packet_reflect_enabled 布尔值	如果必须启用数据包反射。返回值：成功
is_replication_destination 布尔值	如果 NAS 服务器是复制目标，则为 true。返回值：成功
is_windows_to_unix_username_mapping_enabled 布尔值	指示是否启用了 Unix 到/从 Windows 用户名映射。返回值：成功
name 字符串	NAS 服务器的名称。返回值：成功

作者

P Srinivas Rao (@srinivas-rao5)