Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию dellemc.powerflex (версия 3.0.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 2.0.0.

Параметры

Параметр

Комментарии

hostname

aliases: gateway_host

string / обязательный

IP-адрес или FQDN узла PowerFlex.

pair_id

string

Идентификатор пары репликации.

Взаимоисключающий параметр с pair_name.

pair_name

string

Имя пары репликации.

Взаимоисключающий параметр с pair_id.

pairs

list / elements=dictionary

Список пар репликации для добавления в rcg.

copy_type

string / обязательный

Тип копирования.

Варианты:

  • "Identical"
  • "OnlineCopy"
  • "OnlineHashCopy"
  • "OfflineCopy"

name

string

Имя пары репликации.

source_volume_id

string

Идентификатор исходного тома.

Взаимоисключающий параметр с source_volume_name.

source_volume_name

string

Имя исходного тома.

Взаимоисключающий параметр с source_volume_id.

target_volume_id

string

Идентификатор целевого тома.

Взаимоисключающий параметр с target_volume_name.

target_volume_name

string

Имя целевого тома.

Если этот параметр указан, также необходимо указать сведения о remote_peer.

Взаимоисключающий параметр с target_volume_id.

password

string / обязательный

Пароль узла PowerFlex.

pause

boolean

Приостановить или возобновить первоначальное копирование пары репликации.

Варианты:

  • false
  • true

port

integer

Номер порта для связи с узлом PowerFlex.

По умолчанию: 443

rcg_id

string

Идентификатор группы согласованности репликации.

Взаимоисключающий параметр с rcg_name.

rcg_name

string

Имя группы согласованности репликации.

Взаимоисключающий параметр с rcg_id.

remote_peer

dictionary

Удалённая система-партнёр.

hostname

aliases: gateway_host

string / обязательный

IP-адрес или FQDN узла шлюза удалённой системы-партнёра.

password

string / обязательный

Пароль узла шлюза удалённой системы-партнёра.

port

integer

Номер порта для связи с узлом шлюза удалённой системы-партнёра.

По умолчанию: 443

timeout

integer

Время, по истечении которого соединение будет разорвано.

Значение указывается в секундах.

По умолчанию: 120

username

string / обязательный

Имя пользователя узла шлюза удалённой системы-партнёра.

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

Идентификатор пары репликации.

Возвращается: при успешном выполнении

initialCopyPriority

integer

Приоритет начального копирования.

Возвращается: при успешном выполнении

initialCopyState

string

Состояние начального копирования пары репликации.

Возвращается: при успешном выполнении

lifetimeState

integer

Состояние жизненного цикла пары репликации.

Возвращается: при успешном выполнении

localActivityState

string

Состояние активности локальной пары репликации.

Возвращается: при успешном выполнении

localVolumeId

string

Идентификатор локального тома.

Возвращается: при успешном выполнении

localVolumeName

string

Имя локального тома.

Возвращается: при успешном выполнении

name

string

Имя пары репликации.

Возвращается: при успешном выполнении

peerSystemName

integer

Имя системы-партнера.

Возвращается: при успешном выполнении

remoteActivityState

string

Состояние активности удаленной пары репликации.

Возвращается: при успешном выполнении

remoteCapacityInMB

integer

Емкость удаленного тома в МБ.

Возвращается: при успешном выполнении

remoteId

string

Идентификатор удаленной пары репликации.

Возвращается: при успешном выполнении

remoteVolumeId

integer

Идентификатор удаленного тома.

Возвращается: при успешном выполнении

remoteVolumeName

integer

Имя удаленного тома.

Возвращается: при успешном выполнении

replicationConsistencyGroupId

string

Идентификатор группы согласованности репликации.

Возвращается: при успешном выполнении

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

Тип копирования пары репликации.

Возвращается: при успешном выполнении

id

string

Идентификатор пары репликации.

Возвращается: при успешном выполнении

initialCopyPriority

integer

Приоритет начального копирования.

Возвращается: при успешном выполнении

initialCopyState

string

Состояние начального копирования пары репликации.

Возвращается: при успешном выполнении

lifetimeState

integer

Состояние жизненного цикла пары репликации.

Возвращается: при успешном выполнении

localActivityState

string

Состояние активности локальной пары репликации.

Возвращается: при успешном выполнении

localVolumeId

string

Идентификатор локального тома.

Возвращается: при успешном выполнении

localVolumeName

string

Имя локального тома.

Возвращается: при успешном выполнении

name

string

Имя пары репликации.

Возвращается: при успешном выполнении

peerSystemName

integer

Имя системы-партнера.

Возвращается: при успешном выполнении

remoteActivityState

string

Состояние активности удаленной пары репликации.

Возвращается: при успешном выполнении

remoteCapacityInMB

integer

Емкость удаленного тома в МБ.

Возвращается: при успешном выполнении

remoteId

string

Идентификатор удаленной пары репликации.

Возвращается: при успешном выполнении

remoteVolumeId

integer

Идентификатор удаленного тома.

Возвращается: при успешном выполнении

remoteVolumeName

integer

Имя удаленного тома.

Возвращается: при успешном выполнении

replicationConsistencyGroupId

string

Идентификатор группы согласованности репликации.

Возвращается: при успешном выполнении

userRequestedPauseTransmitInitCopy

integer

Значение параметра приостановки передачи начальной копии, заданного пользователем.

Возвращается: при успешном выполнении

Авторы

  • 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/powerflex/replication_pair_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API