dellemc.powerflex.replication_pair модуль — Управление парами репликации на Dell PowerFlex

Примечание

Этот модуль является частью коллекции dellemc.powerflex (версия 2.5.0).

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

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

Чтобы использовать его в плейбуке, укажите: dellemc.powerflex.replication_pair.

Впервые появился в dellemc.powerflex 1.6.0

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

Описание

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

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

Система хранения Dell PowerFlex версии 3.6 или более поздней.
PyPowerFlex 1.12.0.

Параметры

Параметр	Комментарии
hostname псевдонимы: gateway_host строка / обязательно	IP-адрес или FQDN хоста PowerFlex.
pair_id строка	Идентификатор пары репликации. Взаимоисключающее с pair_name.
pair_name строка	Имя пары репликации. Взаимоисключающее с pair_id.
pairs список / элементы=словарь	Список пар репликации для добавления в rcg.
copy_type строка / обязательно	Тип копии. Выбори: `"Identical"` `"OnlineCopy"` `"OnlineHashCopy"` `"OfflineCopy"`
name строка	Имя пары репликации.
source_volume_id строка	Идентификатор источника тома. Взаимоисключающее с source_volume_name.
source_volume_name строка	Имя источника тома. Взаимоисключающее с source_volume_id.
target_volume_id строка	Идентификатор целевого тома. Взаимоисключающее с target_volume_name.
target_volume_name строка	Имя целевого тома. Если указано, также должны быть указаны данные remote_peer. Взаимоисключающее с target_volume_id.
password строка / обязательно	Пароль хоста PowerFlex.
pause логическое	Приостановить или возобновить начальную копию пары репликации. Выбори: `false` `true`
port целое число	Номер порта, через который происходит общение с хостом PowerFlex. По умолчанию: `443`
rcg_id строка	Идентификатор группы согласованности репликации. Взаимоисключающее с rcg_name.
rcg_name строка	Имя группы согласованности репликации. Взаимоисключающее с rcg_id.
remote_peer словарь	Удаленный узел.
hostname псевдонимы: gateway_host строка / обязательно	IP-адрес или FQDN удаленного узла шлюза.
password строка / обязательно	Пароль удаленного узла шлюза.
port целое число	Номер порта, через который происходит общение с удалённым узлом шлюза. По умолчанию: `443`
timeout целое число	Время, по истечении которого соединение будет разорвано. Указывается в секундах. По умолчанию: `120`
username строка / обязательно	Имя пользователя удаленного узла шлюза.

validate_certs aliases: verifycert boolean	Логическая переменная для указания, нужно ли проверять сертификат SSL. `true` - Указывает, что сертификат SSL должен быть проверен. `false` - Указывает, что сертификат SSL проверять не нужно. Варианты: `false` `true` ← (по умолчанию)
state string	Состояние пары репликации. Варианты: `"present"` ← (по умолчанию) `"absent"`
timeout integer	Время, после которого соединение будет прервано. Указывается в секундах. По умолчанию: `120`
username string / обязательно	Имя пользователя хоста PowerFlex.
validate_certs aliases: verifycert boolean	Логическая переменная для указания, нужно ли проверять сертификат SSL. `true` - Указывает, что сертификат SSL должен быть проверен. `false` - Указывает, что сертификат SSL проверять не нужно. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Поддерживается check_mode.
В версии 4.0 создание пары репликации завершается ошибкой, когда copy_type задан как OfflineCopy.
Модули, присутствующие в коллекции с именем ‘dellemc.powerflex’, разработаны для поддержки платформы хранения Dell PowerFlex.

Примеры

- name: Get replication pair details
  dellemc.powerflex.replication_pair:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    pair_id: "123"

- name: Create a replication pair
  dellemc.powerflex.replication_pair:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "test_rcg"
    pairs:
      - source_volume_id: "002"
        target_volume_id: "001"
        copy_type: "OnlineCopy"
        name: "pair1"

- name: Create a replication pair with target volume name
  dellemc.powerflex.replication_pair:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    rcg_name: "test_rcg"
    pairs:
      - source_volume_name: "src_vol"
        target_volume_name: "dest_vol"
        copy_type: "OnlineCopy"
        name: "pair1"
    remote_peer:
      hostname: "{{hostname}}"
      username: "{{username}}"
      password: "{{password}}"
      validate_certs: "{{validate_certs}}"
      port: "{{port}}"

- name: Pause replication pair
  dellemc.powerflex.replication_pair:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    pair_name: "pair1"
    pause: true

- name: Resume replication pair
  dellemc.powerflex.replication_pair:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    pair_name: "pair1"
    pause: false

- name: Delete replication pair
  dellemc.powerflex.replication_pair:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    pair_name: "pair1"
    state: "absent"

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

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

Ключ	Описание
changed boolean	Изменился ли ресурс. Возвращается: всегда Пример: `false`
rcg_replication_pairs list / elements=string	Подробная информация о парах репликации rcg. Возвращается: Когда rcg существует Пример: [{"copyType": "OnlineCopy", "id": "23aa0bc900000001", "initialCopyPriority": -1, "initialCopyState": "Done", "lifetimeState": "Normal", "localActivityState": "RplEnabled", "localVolumeId": "e2bc1fab00000008", "localVolumeName": "vol1", "name": null, "peerSystemName": null, "remoteActivityState": "RplEnabled", "remoteCapacityInMB": 8192, "remoteId": "a058446700000001", "remoteVolumeId": "1cda7af20000000d", "remoteVolumeName": "vol", "replicationConsistencyGroupId": "e2ce036b00000002", "userRequestedPauseTransmitInitCopy": false}]
copyType string	Тип копии пары репликации. Возвращается: успешно
id string	ID пары репликации. Возвращается: успешно
initialCopyPriority integer	Приоритет начальной копии. Возвращается: успешно
initialCopyState string	Начальное состояние копии пары репликации. Возвращается: успешно
lifetimeState integer	Состояние времени существования пары репликации. Возвращается: успешно
localActivityState string	Состояние активности локальной пары репликации. Возвращается: успешно
localVolumeId string	ID локального тома. Возвращается: успешно
localVolumeName string	Имя локального тома. Возвращается: успешно
name string	Имя пары репликации. Возвращается: успешно
peerSystemName integer	Имя системы-партнёра. Возвращается: успешно
remoteActivityState string	Состояние активности удалённой пары репликации. Возвращается: успешно
remoteCapacityInMB integer	Удалённый объём в MB. Возвращается: успешно
remoteId string	ID удалённой пары репликации. Возвращается: успешно
remoteVolumeId integer	ID удалённого тома. Возвращается: успешно
remoteVolumeName integer	Имя удалённого тома. Возвращается: успешно
replicationConsistencyGroupId string	ID группы согласованности репликации. Возвращается: успешно
userRequestedPauseTransmitInitCopy integer	Значение пользовательского запроса на приостановку передачи начальной копии. Возвращается: успешно
replication_pair_details dictionary	Подробная информация о паре репликации. Возвращается: Когда пара репликации существует Пример: {"copyType": "OnlineCopy", "id": "23aa0bc900000001", "initialCopyPriority": -1, "initialCopyState": "Done", "lifetimeState": "Normal", "localActivityState": "RplEnabled", "localVolumeId": "e2bc1fab00000008", "localVolumeName": "vol1", "name": null, "peerSystemName": null, "remoteActivityState": "RplEnabled", "remoteCapacityInMB": 8192, "remoteId": "a058446700000001", "remoteVolumeId": "1cda7af20000000d", "remoteVolumeName": "vol", "replicationConsistencyGroupId": "e2ce036b00000002", "userRequestedPauseTransmitInitCopy": false}

copyType string	Тип копии пары репликации. Возвращено: success
id string	Идентификатор пары репликации. Возвращено: success
initialCopyPriority integer	Приоритет начальной копии. Возвращено: success
initialCopyState string	Состояние начальной копии пары репликации. Возвращено: success
lifetimeState integer	Состояние жизненного цикла пары репликации. Возвращено: success
localActivityState string	Состояние активности локальной пары репликации. Возвращено: success
localVolumeId string	Идентификатор локального тома. Возвращено: success
localVolumeName string	Имя локального тома. Возвращено: success
name string	Имя пары репликации. Возвращено: success
peerSystemName integer	Имя системы-партнёра. Возвращено: success
remoteActivityState string	Состояние активности удалённой пары репликации. Возвращено: success
remoteCapacityInMB integer	Удаленный объём в MB. Возвращено: success
remoteId string	Идентификатор удалённой пары репликации. Возвращено: success
remoteVolumeId integer	Идентификатор удалённого тома. Возвращено: success
remoteVolumeName integer	Имя удалённого тома. Возвращено: success
replicationConsistencyGroupId string	Идентификатор группы согласованности репликации. Возвращено: success
userRequestedPauseTransmitInitCopy integer	Значение запрошенной пользователем паузы передачи начальной копии. Возвращено: success

Авторы

Jennifer John (@Jennifer-John)

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

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