dellemc.unity.replication_session 模块 – 管理 Unity 存储系统上的复制会话

注意

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

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

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

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

dellemc.unity 1.7.0 中的新增功能

概要

  • 管理 Unity 存储系统上的复制会话包括获取详细信息、暂停、恢复、同步、故障转移、故障恢复和删除复制会话。

要求

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

  • Dell Unity 存储设备版本 5.1 或更高版本。

  • Ansible-core 2.14 或更高版本。

  • Python 3.9、3.10 或 3.11。

  • Storops Python SDK 1.2.11。

参数

参数

注释

failback

布尔值

故障恢复复制会话。

选择

  • false

  • true

failover_with_sync

布尔值

如果 true，则在故障转移异步复制会话之前同步源资源和目标资源，或在故障转移同步复制会话后使它们保持同步。

如果 false，则故障转移复制会话。

选择

  • false

  • true

force

布尔值

从源 NAS 服务器发出复制故障转移时，跳过 NAS 服务器文件系统复制会话的预检查。

选择

  • false

  • true

force_full_copy

布尔值

指示在故障恢复会话期间是否将所有数据从目标 SP 同步回源 SP。当复制会话因故障而失去同步时，在恢复操作期间需要。

选择

  • false

  • true

password

字符串 / 必需

Unity 管理服务器的密码。

pause

布尔值

暂停或恢复复制会话。

选择

  • false

  • true

port

整数

与 Unity 管理服务器通信的端口号。

默认值： 443

session_id

字符串

复制会话的 ID。

session_name

字符串

复制会话的名称。

state

字符串

用于确定复制会话是否存在的状态变量。

选择

  • "absent"

  • "present" ←（默认）

sync

布尔值

同步复制会话。

选择

  • false

  • true

unispherehost

字符串 / 必需

Unity 管理服务器的 IP 或 FQDN。

username

字符串 / 必需

Unity 管理服务器的用户名。

validate_certs

别名：verifycert

布尔值

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

true - 表示应验证 SSL 证书。

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

选择

  • false

  • true ←（默认）

说明

注意

  • 支持check_mode。

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

示例

- name: Get replication session details
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"

- name: Get replication session details based on session_id
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_id: "103079215114_APM00213404195_0000_103079215274_APM00213404194_0000"

- name: Pause a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    pause: true

- name: Resume a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    pause: false
    force_full_copy: true

- name: Sync a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    sync: true

- name: Failover with sync a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    failover_with_sync: true
    force: true

- name: Failover a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    failover_with_sync: false

- name: Failback a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    failback: true
    force_full_copy: true

- name: Delete a replication session
  dellemc.unity.replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    state: "absent"

返回值

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

键

描述

changed

布尔值

资源是否已更改。

返回： 始终

示例： true

replication_session_details

字典

复制会话的详细信息。

返回： 当复制会话存在时。

示例: {"current_transfer_est_remain_time": 0, "daily_snap_replication_policy": null, "dst_resource_id": "nas_8", "dst_spa_interface": {"UnityRemoteInterface": {"hash": 8771253398547, "id": "APM00213404195:if_181"}}, "dst_spb_interface": {"UnityRemoteInterface": {"hash": 8771253424144, "id": "APM00213404195:if_180"}}, "dst_status": "ReplicationSessionStatusEnum.OK", "existed": true, "hash": 8771259012271, "health": {"UnityHealth": {"hash": 8771253424168}}, "hourly_snap_replication_policy": null, "id": "103079215114_APM00213404195_0000_103079215274_APM00213404194_0000", "last_sync_time": "2023-04-18 10:35:25+00:00", "local_role": "ReplicationSessionReplicationRoleEnum.DESTINATION", "max_time_out_of_sync": 0, "members": null, "name": "rep_sess_nas", "network_status": "ReplicationSessionNetworkStatusEnum.OK", "remote_system": {"UnityRemoteSystem": {"hash": 8771253380142}}, "replication_resource_type": "ReplicationEndpointResourceTypeEnum.NASSERVER", "src_resource_id": "nas_213", "src_spa_interface": {"UnityRemoteInterface": {"hash": 8771253475010, "id": "APM00213404194:if_195"}}, "src_spb_interface": {"UnityRemoteInterface": {"hash": 8771253374169, "id": "APM00213404194:if_194"}}, "src_status": "ReplicationSessionStatusEnum.OK", "status": "ReplicationOpStatusEnum.ACTIVE", "sync_progress": 0, "sync_state": "ReplicationSessionSyncStateEnum.IN_SYNC"}

currentTransferEstRemainTime

整数

复制同步完成的预计剩余时间。

返回: 成功

dstResourceId

字符串

目标资源的标识符。

返回: 成功

dstStatus

字符串

复制会话目标端的当前状态。

返回: 成功

id

字符串

replicationSession 实例的唯一标识符。

返回: 成功

lastSyncTime

字符串

上次复制同步的日期和时间。

返回: 成功

maxTimeOutOfSync

整数

系统同步源和目标资源之前等待的最大时间。

返回: 成功

name

字符串

用户指定的复制会话名称。

返回: 成功

networkStatus

字符串

复制会话使用的网络连接的状态。

返回: 成功

remoteSystem

字典

指定要用作复制会话目标的远程系统。

返回: 成功

UnityRemoteSystem

字典

关于远程存储系统的信息。

返回: 成功

id

字符串

远程系统实例的唯一标识符。

返回: 成功

serialNumber

字符串

远程系统的序列号。

返回: 成功

replicationResourceType

字符串

复制会话端点的复制资源类型。

返回: 成功

srcStatus

字符串

会话源端的当前状态。

返回: 成功

status

字符串

复制会话的复制状态。

返回: 成功

syncProgress

整数

复制会话的源和目标资源之间的同步完成百分比。

返回: 成功

syncState

字符串

复制会话的源和目标资源之间的同步状态。

返回: 成功

作者

  • Jennifer John (@Jennifer-John)