dellemc.powerflex.protection_domain 模块 – 管理 Dell PowerFlex 上的保护域

注意

此模块是 dellemc.powerflex 集合（版本 2.5.0）的一部分。

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

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

要在 playbook 中使用它，请指定：dellemc.powerflex.protection_domain。

dellemc.powerflex 1.2.0 中的新增功能

概要

  • 在 PowerFlex 存储系统上管理保护域包括创建、修改属性、删除和获取保护域的详细信息。

要求

在执行此模块的主机上需要满足以下要求。

  • Dell PowerFlex 存储系统版本 3.6 或更高版本。

  • PyPowerFlex 1.12.0。

参数

参数

注释

hostname

别名：gateway_host

字符串 / 必需

PowerFlex 主机的 IP 或 FQDN。

is_active

布尔值

用于激活或停用保护域。

选项

  • false

  • true

network_limits

字典

保护域中所有 SDS 使用的网络带宽限制。

bandwidth_unit

字符串

网络带宽限制的单位。

选项

  • "KBps" ←（默认）

  • "MBps"

  • "GBps"

overall_limit

整数

限制整体网络带宽。

rebalance_limit

整数

限制重新平衡的网络带宽。

rebuild_limit

整数

限制重建的网络带宽。

vtree_migration_limit

整数

限制 vtree 迁移的网络带宽。

password

字符串 / 必需

PowerFlex 主机的密码。

port

整数

与 PowerFlex 主机通信的端口号。

默认值： 443

protection_domain_id

字符串

保护域的 ID。

除了创建操作外，所有其他操作都可以使用 protection_domain_id 执行。

与 protection_domain_name 互斥。

protection_domain_name

字符串

保护域的名称。

对于创建操作是必需的。

它在 PowerFlex 阵列中是唯一的。

与 protection_domain_id 互斥。

protection_domain_new_name

字符串

用于重命名保护域。

rf_cache_limits

字典

用于设置保护域的 RFcache 参数。

is_enabled

布尔值

用于启用或禁用保护域中的 RFcache。

选项

  • false

  • true

max_io_limit

整数

用于设置缓存的最大 I/O 限制，以 KB 为单位。

page_size

整数

用于设置缓存页面大小，以 KB 为单位。

pass_through_mode

字符串

用于设置缓存模式。

选项

  • "None"

  • "Read"

  • "Write"

  • "ReadAndWrite"

  • "WriteMiss"

state

字符串 / 必需

保护域的状态。

选项

  • "present"

  • "absent"

timeout

整数

连接终止后的时间。

以秒为单位提及。

默认值： 120

username

字符串 / 必需

PowerFlex 主机的用户名。

validate_certs

别名：verifycert

布尔值

布尔变量，用于指定是否验证 SSL 证书。

true - 表示应验证 SSL 证书。

false - 表示不应验证 SSL 证书。

选项

  • false

  • true ←（默认）

注释

注意

  • 仅当其所有相关对象都已与保护域解除关联时，才能删除该保护域。

  • 如果将保护域设置为非活动状态，则无法对保护域执行任何操作。

  • 不支持 check_mode。

  • 名为“dellemc.powerflex”的集合中存在的模块旨在支持 Dell PowerFlex 存储平台。

示例

- name: Create protection domain
  dellemc.powerflex.protection_domain:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    protection_domain_name: "domain1"
    state: "present"

- name: Create protection domain with all parameters
  dellemc.powerflex.protection_domain:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    protection_domain_name: "domain1"
    is_active: true
    network_limits:
      rebuild_limit: 10
      rebalance_limit: 17
      vtree_migration_limit: 14
      overall_limit: 20
      bandwidth_unit: "MBps"
    rf_cache_limits:
      is_enabled: true
      page_size: 16
      max_io_limit: 128
      pass_through_mode: "Read"
    state: "present"

- name: Get protection domain details using name
  dellemc.powerflex.protection_domain:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    protection_domain_name: "domain1"
    state: "present"

- name: Get protection domain details using ID
  dellemc.powerflex.protection_domain:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    protection_domain_id: "5718253c00000004"
    state: "present"

- name: Modify protection domain attributes
  dellemc.powerflex.protection_domain:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    protection_domain_name: "domain1"
    protection_domain_new_name: "domain1_new"
    network_limits:
      rebuild_limit: 14
      rebalance_limit: 20
      overall_limit: 25
      bandwidth_unit: "MBps"
    rf_cache_limits:
      page_size: 64
      pass_through_mode: "WriteMiss"
    state: "present"

- name: Delete protection domain using name
  dellemc.powerflex.protection_domain:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    protection_domain_name: "domain1_new"
    state: "absent"

返回值

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

键

描述

changed

布尔值

资源是否已更改。

返回值： 始终

示例： false

protection_domain_details

字典

保护域的详细信息。

返回值： 当保护域存在时

示例: {"fglDefaultMetadataCacheSize": 0, "fglDefaultNumConcurrentWrites": 1000, "fglMetadataCacheEnabled": false, "id": "7bd6457000000000", "links": [{"href": "/api/instances/ProtectionDomain::7bd6457000000000", "rel": "self"}, {"href": "/api/instances/ProtectionDomain::7bd6457000000000/ relationships/Statistics", "rel": "/api/ProtectionDomain/relationship/Statistics"}, {"href": "/api/instances/ProtectionDomain::7bd6457000000000/ relationships/Sdr", "rel": "/api/ProtectionDomain/relationship/Sdr"}, {"href": "/api/instances/ProtectionDomain::7bd6457000000000/ relationships/AccelerationPool", "rel": "/api/ProtectionDomain/relationship/AccelerationPool"}, {"href": "/api/instances/ProtectionDomain::7bd6457000000000/ relationships/StoragePool", "rel": "/api/ProtectionDomain/relationship/StoragePool"}, {"href": "/api/instances/ProtectionDomain::7bd6457000000000/ relationships/Sds", "rel": "/api/ProtectionDomain/relationship/Sds"}, {"href": "/api/instances/ProtectionDomain::7bd6457000000000/ relationships/ReplicationConsistencyGroup", "rel": "/api/ProtectionDomain/relationship/ ReplicationConsistencyGroup"}, {"href": "/api/instances/ProtectionDomain::7bd6457000000000/ relationships/FaultSet", "rel": "/api/ProtectionDomain/relationship/FaultSet"}, {"href": "/api/instances/System::0989ce79058f150f", "rel": "/api/parent/relationship/systemId"}], "mdmSdsNetworkDisconnectionsCounterParameters": {"longWindow": {"threshold": 700, "windowSizeInSec": 86400}, "mediumWindow": {"threshold": 500, "windowSizeInSec": 3600}, "shortWindow": {"threshold": 300, "windowSizeInSec": 60}}, "name": "domain1", "overallIoNetworkThrottlingEnabled": false, "overallIoNetworkThrottlingInKbps": null, "protectedMaintenanceModeNetworkThrottlingEnabled": false, "protectedMaintenanceModeNetworkThrottlingInKbps": null, "protectionDomainState": "Active", "rebalanceNetworkThrottlingEnabled": false, "rebalanceNetworkThrottlingInKbps": null, "rebuildNetworkThrottlingEnabled": false, "rebuildNetworkThrottlingInKbps": null, "rfcacheAccpId": null, "rfcacheEnabled": true, "rfcacheMaxIoSizeKb": 128, "rfcacheOpertionalMode": "WriteMiss", "rfcachePageSizeKb": 64, "sdrSdsConnectivityInfo": {"clientServerConnStatus": "CLIENT_SERVER_CONN_STATUS_ALL _CONNECTED", "disconnectedClientId": null, "disconnectedClientName": null, "disconnectedServerId": null, "disconnectedServerIp": null, "disconnectedServerName": null}, "sdsConfigurationFailureCounterParameters": {"longWindow": {"threshold": 700, "windowSizeInSec": 86400}, "mediumWindow": {"threshold": 500, "windowSizeInSec": 3600}, "shortWindow": {"threshold": 300, "windowSizeInSec": 60}}, "sdsDecoupledCounterParameters": {"longWindow": {"threshold": 700, "windowSizeInSec": 86400}, "mediumWindow": {"threshold": 500, "windowSizeInSec": 3600}, "shortWindow": {"threshold": 300, "windowSizeInSec": 60}}, "sdsReceiveBufferAllocationFailuresCounterParameters": {"longWindow": {"threshold": 2000000, "windowSizeInSec": 86400}, "mediumWindow": {"threshold": 200000, "windowSizeInSec": 3600}, "shortWindow": {"threshold": 20000, "windowSizeInSec": 60}}, "sdsSdsNetworkDisconnectionsCounterParameters": {"longWindow": {"threshold": 700, "windowSizeInSec": 86400}, "mediumWindow": {"threshold": 500, "windowSizeInSec": 3600}, "shortWindow": {"threshold": 300, "windowSizeInSec": 60}}, "storagePool": [{"id": "8d1cba1700000000", "name": "pool1"}], "systemId": "0989ce79058f150f", "vtreeMigrationNetworkThrottlingEnabled": false, "vtreeMigrationNetworkThrottlingInKbps": null}

fglDefaultMetadataCacheSize

整数

FGL 元数据缓存大小。

返回: 成功

fglDefaultNumConcurrentWrites

字符串

FGL 并发写入。

返回: 成功

fglMetadataCacheEnabled

布尔值

是否启用 FGL 缓存。

返回: 成功

id

字符串

保护域 ID。

返回: 成功

列表 / 元素=字符串

保护域链接。

返回: 成功

字符串

保护域实例 URL。

返回: 成功

字符串

保护域与不同实体之间的关系。

返回: 成功

mdmSdsNetworkDisconnectionsCounterParameters

字典

MDM 的 SDS 计数器参数。

返回: 成功

longWindow

整数

计数器参数的长窗口。

返回: 成功

mediumWindow

整数

计数器参数的中窗口。

返回: 成功

shortWindow

整数

计数器参数的短窗口。

返回: 成功

name

字符串

保护域的名称。

返回: 成功

overallIoNetworkThrottlingEnabled

布尔值

是否启用整体网络限制。

返回: 成功

overallIoNetworkThrottlingInKbps

整数

整体网络限制，单位为 KBps。

返回: 成功

protectedMaintenanceModeNetworkThrottlingEnabled

布尔值

是否启用受保护的维护模式网络限制。

返回: 成功

protectedMaintenanceModeNetworkThrottlingInKbps

整数

受保护的维护模式网络限制，单位为 KBps。

返回: 成功

protectionDomainState

整数

保护域的状态。

返回: 成功

rebalanceNetworkThrottlingEnabled

整数

是否启用重新平衡网络限制。

返回: 成功

rebalanceNetworkThrottlingInKbps

整数

重新平衡网络限制，单位为 KBps。

返回: 成功

rebuildNetworkThrottlingEnabled

整数

是否启用重建网络限制。

返回: 成功

rebuildNetworkThrottlingInKbps

整数

重建网络限制，单位为 KBps。

返回: 成功

rfcacheAccpId

字符串

RF 缓存加速池的 ID。

返回: 成功

rfcacheEnabled

布尔值

是否启用 RF 缓存。

返回: 成功

rfcacheMaxIoSizeKb

整数

RF 缓存最大 I/O 大小，单位为 KB。

返回: 成功

rfcacheOpertionalMode

字符串

RF 缓存操作模式。

返回: 成功

rfcachePageSizeKb

布尔值

RF 缓存页大小，单位为 KB。

返回: 成功

sdrSdsConnectivityInfo

字典

SDR 和 SDS 的连接信息。

返回: 成功

clientServerConnStatus

字符串

客户端和服务器的连接状态。

返回: 成功

disconnectedClientId

字符串

断开连接的客户端 ID。

返回: 成功

disconnectedClientName

字符串

断开连接的客户端名称。

返回: 成功

disconnectedServerId

字符串

断开连接的服务器 ID。

返回: 成功

disconnectedServerIp

字符串

断开连接的服务器 IP。

返回: 成功

disconnectedServerName

字符串

断开连接的服务器名称。

返回: 成功

sdsSdsNetworkDisconnectionsCounterParameters

字典

SDS-SDS 网络的计数器参数。

返回: 成功

longWindow

整数

计数器参数的长窗口。

返回: 成功

mediumWindow

整数

计数器参数的中窗口。

返回: 成功

shortWindow

整数

计数器参数的短窗口。

返回: 成功

storagePool

列表 / 元素=字符串

存储池列表。

返回: 成功

systemId

字符串

系统的 ID。

返回: 成功

vtreeMigrationNetworkThrottlingEnabled

布尔值

是否启用 V-Tree 迁移网络限制。

返回: 成功

vtreeMigrationNetworkThrottlingInKbps

整数

V-Tree 迁移网络限制，单位为 KBps。

返回: 成功

作者

  • Bhavneet Sharma (@sharmb5)