модуль dellemc.unity.replication_session — управление сеансом репликации в системе хранения Unity

Примечание

Этот модуль входит в коллекцию dellemc.unity (версия 2.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install dellemc.unity. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: dellemc.unity.replication_session.

Добавлено в dellemc.unity 1.7.0

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление сеансом репликации в системе хранения Unity включает получение сведений, приостановку, возобновление, синхронизацию, переключение на резервную сторону, возврат на исходную сторону и удаление сеанса репликации.

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

Устройство хранения Dell Unity версии 5.3 или выше.
Ansible-core версии 2.17 или выше.
Python 3.11, 3.12 или 3.13.
Python SDK Storops 1.2.12.

Параметры

Параметр	Описание
failback boolean	Вернуть сеанс репликации на исходную сторону. Варианты: `false` `true`
failover_with_sync boolean	Если `true`, синхронизировать исходный и целевой ресурсы перед переключением асинхронного сеанса репликации на резервную сторону или поддерживать их синхронизацию после переключения синхронного сеанса репликации на резервную сторону. Если `false`, переключить сеанс репликации на резервную сторону. Варианты: `false` `true`
force boolean	Пропустить предварительные проверки сеансов репликации файловых систем NAS-сервера при выполнении переключения репликации на резервную сторону из исходного NAS-сервера. Варианты: `false` `true`
force_full_copy boolean	Указывает, нужно ли синхронизировать все данные с целевого SP на исходный SP во время сеанса возврата на исходную сторону. Требуется при возобновлении, если из-за сбоя сеанс репликации вышел из состояния синхронизации. Варианты: `false` `true`
password string / обязательный	Пароль сервера управления Unity.
pause boolean	Приостановить или возобновить сеанс репликации. Варианты: `false` `true`
port integer	Номер порта для связи с сервером управления Unity. По умолчанию: `443`
session_id string	Идентификатор сеанса репликации.
session_name string	Имя сеанса репликации.
state string	Переменная состояния, определяющая, должен ли существовать сеанс репликации. Варианты: `"absent"` `"present"` ← (по умолчанию)
sync boolean	Синхронизировать сеанс репликации. Варианты: `false` `true`
unispherehost string / обязательный	IP-адрес или FQDN сервера управления Unity.
username string / обязательный	Имя пользователя сервера управления Unity.
validate_certs псевдонимы: verifycert boolean	Логическая переменная, указывающая, нужно ли проверять SSL-сертификат. `true` — указывает, что SSL-сертификат необходимо проверить. `false` — указывает, что SSL-сертификат не нужно проверять. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Поддерживается режим check_mode.
Модули этой коллекции с именем «dellemc.unity» предназначены для поддержки платформы хранения Dell Unity.

Примеры

- name: Get replication session details
  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
  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
  replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    pause: true

- name: Resume a replication session
  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
  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
  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
  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
  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
  replication_session:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    session_name: "fs_replication"
    state: "absent"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
changed boolean	Изменился ли ресурс. Возвращается: всегда Пример: `true`
replication_session_details dictionary	Сведения о сеансе репликации. Возвращается: если сеанс репликации существует. Пример: {"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 integer	Оценка оставшегося времени до завершения синхронизации репликации. Возвращается: при успешном выполнении
dstResourceId string	Идентификатор целевого ресурса. Возвращается: при успешном выполнении
dstStatus string	Состояние целевой стороны сеанса репликации. Возвращается: при успешном выполнении
id string	Уникальный идентификатор экземпляра replicationSession. Возвращается: при успешном выполнении
lastSyncTime string	Дата и время последней синхронизации репликации. Возвращается: при успешном выполнении
maxTimeOutOfSync integer	Максимальное время ожидания до синхронизации системой исходного и целевого ресурсов. Возвращается: при успешном выполнении
name string	Имя сеанса репликации, заданное пользователем. Возвращается: при успешном выполнении
networkStatus string	Состояние сетевого соединения, используемого сеансом репликации. Возвращается: при успешном выполнении
remoteSystem dictionary	Указывает удаленную систему, используемую в качестве целевой для сеанса репликации. Возвращается: при успешном выполнении
UnityRemoteSystem dictionary	Сведения об удаленной системе хранения. Возвращается: при успешном выполнении
id string	Уникальный идентификатор экземпляра удаленной системы. Возвращается: при успешном выполнении
serialNumber string	Серийный номер удаленной системы. Возвращается: при успешном выполнении
replicationResourceType string	Тип ресурса репликации для конечных точек сеанса репликации. Возвращается: при успешном выполнении
srcStatus string	Состояние исходной стороны сеанса. Возвращается: при успешном выполнении
status string	Состояние репликации сеанса. Возвращается: при успешном выполнении
syncProgress integer	Процент завершения синхронизации исходного и целевого ресурсов сеанса репликации. Возвращается: при успешном выполнении
syncState string	Состояние синхронизации исходного и целевого ресурсов сеанса репликации. Возвращается: при успешном выполнении

Авторы

Jennifer John (@Jennifer-John)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/unity/replication_session_module.html