dellemc.powerflex.sds 模块 – 管理 Dell PowerFlex 上的 SDS
注意
此模块是 dellemc.powerflex 集合（版本 2.5.0）的一部分。
如果您正在使用 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install dellemc.powerflex。您需要进一步的要求才能使用此模块，请参阅 要求 获取详细信息。
要在剧本中使用它，请指定：dellemc.powerflex.sds。
dellemc.powerflex 1.1.0 中的新增功能
概要
在 PowerFlex 存储系统上管理 SDS 包括创建新的 SDS、获取 SDS 的详细信息、添加/删除 SDS 的 IP、修改 SDS 的属性以及删除 SDS。
要求
执行此模块的主机需要满足以下要求。
Dell PowerFlex 存储系统版本 3.6 或更高版本。
PyPowerFlex 1.12.0。
参数
参数 |
注释 |
|---|---|
故障集的唯一标识符。 与 *fault_set_name* 互斥。 |
|
故障集的名称。 与 *fault_set_id* 互斥。 |
|
PowerFlex 主机的 IP 或 FQDN。 |
|
PowerFlex 主机的密码。 |
|
要应用于 SDS 的性能配置文件。 HighPerformance 配置文件为非常高性能的用例配置一组预定义的参数。 API 的默认值为 选择
|
|
与 PowerFlex 主机通信的端口号。 默认值： |
|
保护域的 ID。 与 *protection_domain_name* 互斥。 |
|
保护域的名称。 与 *protection_domain_id* 互斥。 |
|
是否启用读取闪存缓存。 选择
|
|
是否启用读取 RAM 缓存。 选择
|
|
读取 RAM 缓存大小（以 MB 为单位）。 最小大小为 128 MB。 最大大小为 3911 MB。 |
|
SDS 的 ID。 除了创建操作外，所有其他操作都可以使用 *sds_id* 执行。 与 *sds_name* 互斥。 |
|
SDS 的 IP 及其角色的字典。 创建 SDS 时，至少需要一个 IP 角色。 IP 角色也可以更新。 |
|
SDS 的 IP 地址。 |
|
分配给 SDS IP 地址的角色。 选择
|
|
IP 相对于 SDS 的状态。 选择
|
|
SDS 的名称。 对于创建操作是必需的。 它在 PowerFlex 阵列中是唯一的。 与 *sds_id* 互斥。 |
|
SDS 新名称。 |
|
SDS 的状态。 选择
|
|
连接终止的时间。 以秒为单位提及。 默认值： |
|
PowerFlex 主机的用户名。 |
|
布尔变量，用于指定是否验证 SSL 证书。
选择
|
备注
注意
可以与 SDS 关联的 IP 的最大限制为 8 个。
需要至少 1 个 IP 用于 SDS 通信和 1 个用于 SDC 通信。
如果只有 1 个 IP 存在，则其角色必须为“all”；否则 1 个 IP 的角色可以为“all”，而其他 IP 的角色为“sdcOnly”；或者 1 个 IP 的角色必须为“sdsOnly”，而其他 IP 的角色为“sdcOnly”。
可以有一个或多个具有 'sdcOnly' 角色的 IP 地址。
必须只有一个具有 SDS 角色的 IP 地址（角色为 'all' 或 'sdsOnly' ）。
可以创建禁用 RF 缓存的 SDS，但请注意，RF 缓存并非总是更新。在这种情况下，用户应重试该操作。
支持 check_mode 模式。
名为“dellemc.powerflex”的集合中的模块旨在支持 Dell PowerFlex 存储平台。
示例
- name: Create SDS
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
protection_domain_name: "domain1"
sds_ip_list:
- ip: "198.10.xxx.xxx"
role: "all"
sds_ip_state: "present-in-sds"
state: "present"
- name: Create SDS with all parameters
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node1"
protection_domain_name: "domain1"
fault_set_name: "faultset1"
sds_ip_list:
- ip: "198.10.xxx.xxx"
role: "sdcOnly"
sds_ip_state: "present-in-sds"
rmcache_enabled: true
rmcache_size: 128
performance_profile: "HighPerformance"
state: "present"
- name: Get SDS details using name
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
state: "present"
- name: Get SDS details using ID
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_id: "5718253c00000004"
state: "present"
- name: Modify SDS attributes using name
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
sds_new_name: "node0_new"
rfcache_enabled: true
rmcache_enabled: true
rmcache_size: 256
performance_profile: "HighPerformance"
state: "present"
- name: Modify SDS attributes using ID
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_id: "5718253c00000004"
sds_new_name: "node0_new"
rfcache_enabled: true
rmcache_enabled: true
rmcache_size: 256
performance_profile: "HighPerformance"
state: "present"
- name: Add IP and role to an SDS
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
sds_ip_list:
- ip: "198.10.xxx.xxx"
role: "sdcOnly"
sds_ip_state: "present-in-sds"
state: "present"
- name: Remove IP and role from an SDS
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
sds_ip_list:
- ip: "198.10.xxx.xxx"
role: "sdcOnly"
sds_ip_state: "absent-in-sds"
state: "present"
- name: Delete SDS using name
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_name: "node0"
state: "absent"
- name: Delete SDS using ID
dellemc.powerflex.sds:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
sds_id: "5718253c00000004"
state: "absent"
返回值
通用返回值在此处记录 此处，以下是此模块特有的字段
键 |
描述 |
|---|---|
指示资源是否已更改。 返回: 总是 示例: |
|
SDS 的详细信息。 返回: 当 SDS 存在时 示例: |
|
指示身份验证错误。 返回: 成功 |
|
有关证书的信息。 返回: 成功 |
|
配置的 DRL 模式。 返回: 成功 |
|
DRL 模式。 返回: 成功 |
|
故障集 ID。 返回: 成功 |
|
FGL 元数据缓存大小。 返回: 成功 |
|
FGL 元数据缓存状态。 返回: 成功 |
|
FGL 并发写入。 返回: 成功 |
|
SDS ID。 返回: 成功 |
|
SDS IP 列表。 返回: 成功 |
|
SDS 中存在的 IP 地址。 返回: 成功 |
|
SDS IP 的角色。 返回: 成功 |
|
上次升级 SDS 的时间。 返回: 成功 |
|
SDS 链接。 返回: 成功 |
|
SDS 实例 URL。 返回: 成功 |
|
SDS 与不同实体之间的关系。 返回: 成功 |
|
维护状态。 返回: 成功 |
|
维护类型。 返回: 成功 |
|
MDM 连接状态。 返回: 成功 |
|
成员状态。 返回: 成功 |
|
SDS 的名称。 返回: 成功 |
|
IO 缓冲区数。 返回: 成功 |
|
重启次数。 返回: 成功 |
|
在 VMware 上的存在情况。 返回: 成功 |
|
性能配置文件。 返回: 成功 |
|
SDS 端口。 返回: 成功 |
|
保护域 ID。 返回: 成功 |
|
保护域名。 返回: 成功 |
|
RAID 控制器的数量。 返回: 成功 |
|
是否启用 RF 缓存。 返回: 成功 |
|
RF 缓存 API 版本不匹配错误。 返回: 成功 |
|
RF 缓存设备不存在错误。 返回: 成功 |
|
RF 缓存缓存配置不一致错误。 返回: 成功 |
|
RF 缓存源配置不一致错误。 返回: 成功 |
|
RF 缓存驱动程序路径无效错误。 返回: 成功 |
|
RF 缓存资源不足错误。 返回: 成功 |
|
是否启用读取 RAM 缓存。 返回: 成功 |
|
RM 缓存已冻结。 返回: 成功 |
|
RM 缓存内存分配状态。 返回: 成功 |
|
RM 缓存大小（KB）。 返回: 成功 |
|
RM 缓存大小（MB）。 返回: 成功 |
|
SDS 配置失败。 返回: 成功 |
|
SDS 已解耦。 返回: 成功 |
|
SDS 接收缓冲区分配失败。 返回: 成功 |
|
SDS 状态。 返回: 成功 |
|
SDS 软件版本信息。 返回: 成功 |