dellemc.unity.filesystem 模块 – 管理 Unity 存储系统上的文件系统
注意
此模块是 dellemc.unity 集合 (版本 2.0.0) 的一部分。
如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install dellemc.unity。您需要其他要求才能使用此模块，请参阅 要求 获取详细信息。
要在 playbook 中使用它，请指定：dellemc.unity.filesystem。
dellemc.unity 1.1.0 中的新增功能
概要
管理 Unity 存储系统上的文件系统包括创建新的文件系统、修改文件系统的 snapschedule 属性、修改文件系统属性、显示文件系统详细信息、显示文件系统快照、显示文件系统 snapschedule、删除与文件系统关联的 snapschedule、删除文件系统、创建具有配额配置的新文件系统、启用、修改和禁用复制。
要求
执行此模块的主机需要以下要求。
Dell Unity 存储设备版本 5.1 或更高版本。
Ansible-core 2.14 或更高版本。
Python 3.9、3.10 或 3.11。
Storops Python SDK 1.2.11。
参数
参数 |
注释 |
|---|---|
文件系统的访问策略。 选项
|
|
文件系统大小的单位。如果未指定，则默认为 选项
|
|
布尔变量，指定是否启用压缩。压缩仅支持精简文件系统。 选项
|
|
关于文件系统的描述。 可以通过传递空字符串 (“”) 来删除描述。 |
|
文件系统的 ID。 它只能用于获取、修改或删除操作。 它与 *filesystem_name* 互斥。 |
|
文件系统的名称。仅在创建操作中必填。所有操作都支持通过 *filesystem_name* 进行。 它与 *filesystem_id* 互斥。 |
|
布尔变量，指定它是否是精简文件系统。 选项
|
|
文件系统锁定策略。这些策略选项控制是否必须遵守 NFSv4 范围锁。 选项
|
|
将托管文件系统的 NAS 服务器的 ID。 |
|
将托管文件系统的 NAS 服务器的名称。 |
|
Unity 管理服务器的密码。 |
|
这是将创建文件系统的池的 ID。 必须提供 *pool_name* 或 *pool_id* 来创建新的文件系统。 |
|
这是将创建文件系统的池的名称。 必须提供 *pool_name* 或 *pool_id* 来创建新的文件系统。 |
|
与 Unity 管理服务器通信的端口号。 默认值： |
|
配额管理的配置。它包含可选参数。 |
|
*default_soft_limit* 和 *default_hard_limit* 大小的单位。 默认单位为 选项
|
|
用户配额和树形配额的默认硬限制。 如果在创建文件系统时未设置 *default_hard_limit*，则默认情况下它将设置为 |
|
用户配额和树形配额的默认软限制。 如果在创建文件系统时未设置 *default_soft_limit*，则默认情况下它将设置为 |
|
达到软限制后在配额配置中设置的宽限期。 如果在创建文件系统期间未设置 *grace_period*，则默认情况下它将设置为 |
|
宽限期的单位。 默认单位为 选项
|
|
指示用户配额是否启用。 如果在创建文件系统时未设置 *is_user_quota_enabled*，则默认情况下它将设置为 参数 *is_user_quota_enabled* 和 *quota_policy* 互斥。 选项
|
|
在配额配置中设置的配额策略。 如果在创建文件系统时未设置 *quota_policy*，则默认情况下它将设置为 参数 *is_user_quota_enabled* 和 *quota_policy* 互斥。 选项
|
|
启用或修改复制所需的设置。 |
|
分配目标文件系统的池的 ID。 |
|
分配目标文件系统的池的名称。 |
|
将会话重命名为的复制名称。 |
|
正在配置复制到的远程系统的详细信息。 如果 *replication_type* 为 |
|
远程 Unity Unisphere 主机的 IP 或 FQDN。 |
|
远程 Unity Unisphere 主机的密码。 |
|
托管远程 Unity Unisphere 的端口。 默认值： |
|
远程Unity Unisphere主机的用户名。 |
|
布尔变量，用于指定是否验证远程Unity Unisphere主机的SSL证书。
选项
|
|
复制模式。 创建复制会话时，这是必填字段。 选项
|
|
复制会话的名称。 |
|
复制类型。 选项
|
|
系统同步源LUN和目标LUN之前的最大等待时间。 如果replication_mode为 对于 |
|
复制的状态。 选项
|
|
文件系统的容量。 |
|
SMB的高级设置。它包含可选的候选变量。 |
|
指示是否启用了目录文件结构更改通知。 选项
|
|
指示是否在文件系统上启用了文件写入通知。 选项
|
|
指示是否在文件系统上启用了机会性文件锁定。 选项
|
|
指示是否在文件系统上启用了同步写入选项。 选项
|
|
整型变量，确定启用的通知适用的最低目录级别。 最小值为 |
|
这是要与文件系统关联的现有快照计划的ID。 这与snapshot_schedule_name互斥。 |
|
这是要与文件系统关联的现有快照计划的名称。 这与snapshot_schedule_id互斥。 |
|
状态变量，用于确定文件系统是否存在。 选项
|
|
文件系统支持的协议。 如果NAS服务器为 选项
|
|
分层策略选择，用于确定存储资源数据如何在池中可用的层之间分配。 选项
|
|
Unity管理服务器的IP地址或FQDN。 |
|
Unity管理服务器的用户名。 |
|
布尔变量，用于指定是否验证SSL证书。
选项
|
备注
注意
在删除文件系统之前，需要删除与文件系统关联的SMB共享、NFS导出和快照。
可以使用quota_config参数更新默认硬限制和软限制值，以限制可以使用最大空间。默认情况下，在创建文件系统时，两者都设置为0，这意味着无限制。
不支持check_mode。
此集合中名为“dellemc.unity”的模块构建为支持Dell Unity存储平台。
示例
- name: Create FileSystem
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_name: "ansible_test_fs"
nas_server_name: "lglap761"
pool_name: "pool_1"
size: 5
state: "present"
- name: Create FileSystem with quota configuration
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_name: "ansible_test_fs"
nas_server_name: "lglap761"
pool_name: "pool_1"
size: 5
quota_config:
grace_period: 8
grace_period_unit: "days"
default_soft_limit: 10
is_user_quota_enabled: false
state: "present"
- name: Expand FileSystem size
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_name: "ansible_test_fs"
nas_server_name: "lglap761"
size: 10
state: "present"
- name: Expand FileSystem size
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_name: "ansible_test_fs"
nas_server_name: "lglap761"
size: 10
state: "present"
- name: Modify FileSystem smb_properties
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_name: "ansible_test_fs"
nas_server_name: "lglap761"
smb_properties:
is_smb_op_locks_enabled: true
smb_notify_on_change_dir_depth: 5
is_smb_notify_on_access_enabled: true
state: "present"
- name: Modify FileSystem Snap Schedule
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_id: "fs_141"
snap_schedule_id: "{{snap_schedule_id}}"
state: "{{state_present}}"
- name: Get details of FileSystem using id
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_id: "rs_405"
state: "present"
- name: Delete a FileSystem using id
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_id: "rs_405"
state: "absent"
- name: Enable replication on the fs
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_id: "rs_405"
replication_params:
replication_name: "test_repl"
replication_type: "remote"
replication_mode: "asynchronous"
rpo: 60
remote_system:
remote_system_host: '0.1.2.3'
remote_system_verifycert: false
remote_system_username: 'username'
remote_system_password: 'password'
destination_pool_name: "pool_test_1"
replication_state: "enable"
state: "present"
- name: Modify replication on the fs
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_id: "rs_405"
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 fs
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_id: "rs_405"
replication_state: "disable"
state: "present"
- name: Disable replication by specifying replication_name on the fs
dellemc.unity.filesystem:
unispherehost: "{{unispherehost}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
filesystem_id: "rs_405"
replication_params:
replication_name: "test_replication"
replication_state: "disable"
state: "present"
返回值
公共返回值已在此处记录，以下是此模块独有的字段
键 |
描述 |
|---|---|
资源是否已更改。 返回：始终 示例： |
|
文件系统的详细信息。 返回：文件系统存在时 示例： |
|
指示启用的通知适用的最低目录级别（如果有）。 返回：成功 |
|
关于文件系统的描述。 返回：成功 |
|
系统为文件系统生成的ID。 返回：成功 |
|
指示系统是否在用户访问文件系统时生成通知。 返回：成功 |
|
指示系统是否在写入文件系统时生成通知。 返回：成功 |
|
指示是否为文件系统启用了机会性文件锁。 返回：成功 |
|
指示是否为文件系统启用了CIFS同步写入选项。 返回：成功 |
|
此文件系统上是否启用了压缩。 返回：成功 |
|
指示是否为此文件系统启用了精简配置。 返回：成功 |
|
文件系统的名称。 返回：成功 |
|
托管此文件系统的NAS服务器详细信息。 返回：成功 |
|
分配给NAS服务器的系统ID。 返回：成功 |
|
NAS服务器的名称。 返回：成功 |
|
分配此文件系统的池。 返回：成功 |
|
分配给池的系统ID。 返回：成功 |
|
存储池的名称。 返回：成功 |
|
已创建文件系统的配额配置详细信息。 返回：成功 |
|
用户配额和树形配额的默认硬限制。 返回：成功 |
|
用户配额和树形配额的默认软限制。 返回：成功 |
|
达到软限制后在配额配置中设置的宽限期。 返回：成功 |
|
指示用户配额是否启用。 返回：成功 |
|
在配额配置中设置的配额策略。 返回：成功 |
|
如果启用了复制，则为复制会话列表。 返回：成功 |
|
复制会话的ID 返回：成功 |
|
复制会话的名称 返回：成功 |
|
远程系统 返回：成功 |
|
远程系统的ID 返回：成功 |
|
带有实际单位的文件系统大小。 返回：成功 |
|
指示与文件系统关联的快照计划的 ID。 返回：成功 |
|
指示与文件系统关联的快照计划的名称。 返回：成功 |
|
此文件系统的快照列表。 返回：成功 |
|
赋予文件系统快照的系统 ID。 返回：成功 |
|
文件系统快照的名称。 返回：成功 |
|
应用于此文件系统的分层策略。 返回：成功 |