Модуль purestorage.flasharray.purefa_pgsnap – Управление снимками групп защиты на массивах Pure Storage FlashArray

Примечание

Этот модуль является частью коллекции purestorage.flasharray (версия 1.31.1).

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

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

Для использования в playbook укажите: purestorage.flasharray.purefa_pgsnap.

Новое в purestorage.flasharray 1.0.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Создание или удаление снимков групп защиты на массиве Pure Storage FlashArray.
Включено восстановление реплицированных снимков на целевом массиве репликации.
Поддерживаются группы защиты ActiveCluster и Volume Group.

Требования

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

python >= 3.3
purestorage >= 1.19
py-pure-client >= 1.26.0
netaddr
requests
pycountry
urllib3

Параметры

Параметр	Комментарии
add_to_pgs list / elements=string added in purestorage.flasharray 1.27.0	Том, созданный из снимка, будет добавлен в указанные группы защиты
api_token string	Токен API FlashArray для пользователя с правами администратора.
apply_retention boolean	Применить параметры расписания хранения к снимку Варианты: `false` ← (default) `true`
disable_warnings boolean added in purestorage.flasharray 1.29.0	Отключить предупреждения о небезопасных сертификатах в журналах отладки Варианты: `false` ← (default) `true`
eradicate boolean	Определить, следует ли уничтожать снимок при удалении или оставлять в корзине. Варианты: `false` ← (default) `true`
fa_url string	IP-адрес управления FlashArray IPv4 или имя хоста.
name string / required	Имя исходной группы защиты.
now boolean	Следует ли немедленно инициировать снимок группы защиты Варианты: `false` ← (default) `true`
offload string	Имя целевого объекта offload, на котором существует снимок. Это применимо только для удаления и стирания снимков
overwrite boolean	Определить, следует ли перезаписывать целевой том, если он уже существует. Варианты: `false` ← (default) `true`
remote boolean	Принудительно создать немедленный снимок для удаленных целей Варианты: `false` ← (default) `true`
restore string	Восстановить определенный том из снимка группы защиты. Имя группы защиты не требуется. Укажите только имя тома для восстановления.
state string	Определить, должен ли существовать снимок группы защиты или нет. Копирование (добавлено в 2.7) создаст полную доступную для чтения/записи копию снимка. Варианты: `"absent"` `"present"` ← (default) `"copy"` `"rename"`
suffix string	Суффикс имени снимка. Особый случай. Если latest, модуль выберет последний созданный снимок в группе
target string	Том, в который будет восстановлен указанный том. Если не указано, по умолчанию будет использоваться том, указанный в restore Имя нового суффикса снимка, если переименовывается снимок
throttle boolean added in purestorage.flasharray 1.21.0	Если установлено значение true, позволяет снимку завершиться неудачей, если состояние системы не оптимально. Варианты: `false` ← (default) `true`
with_default_protection boolean added in purestorage.flasharray 1.27.0	Добавлять ли группы защиты контейнеров по умолчанию к тем, которые указаны в add_to_pgs, в качестве начальной защиты тома, созданного из снимка. Варианты: `false` `true` ← (default)

Примечания

Примечание

Этот модуль требует библиотек Python purestorage и py-pure-client
Дополнительные библиотеки Python могут потребоваться для определенных модулей.
Вы должны установить переменные среды PUREFA_URL и PUREFA_API, если аргументы fa_url и api_token не передаются в модуль напрямую

Примеры

- name: Create protection group snapshot foo.ansible
  purestorage.flasharray.purefa_pgsnap:
    name: foo
    suffix: ansible
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

- name: Delete and eradicate protection group snapshot named foo.snap
  purestorage.flasharray.purefa_pgsnap:
    name: foo
    suffix: snap
    eradicate: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Restore volume data from local protection group snapshot named foo.snap to volume data2
  purestorage.flasharray.purefa_pgsnap:
    name: foo
    suffix: snap
    restore: data
    target: data2
    overwrite: true
    with_default_protection: false
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: copy

- name: Restore remote protection group snapshot arrayA:pgname.snap.data to local copy
  purestorage.flasharray.purefa_pgsnap:
    name: arrayA:pgname
    suffix: snap
    restore: data
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: copy

- name: Restore AC pod  protection group snapshot pod1::pgname.snap.data to pod1::data2
  purestorage.flasharray.purefa_pgsnap:
    name: pod1::pgname
    suffix: snap
    restore: data
    target: pod1::data2
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: copy

- name: Create snapshot of existing pgroup foo with suffix and force immeadiate copy to remote targets
  purestorage.flasharray.purefa_pgsnap:
    name: pgname
    suffix: force
    now: true
    apply_retention: true
    remote: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete and eradicate snapshot named foo.snap on offload target bar from arrayA
  purestorage.flasharray.purefa_pgsnap:
    name: "arrayA:foo"
    suffix: snap
    offload: bar
    eradicate: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Rename protection group snapshot foo.fred to foo.dave
  purestorage.flasharray.purefa_pgsnap:
    name: foo
    suffix: fred
    target: dave
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: rename

Авторы

Pure Storage Ansible Team (@sdodsley)

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

© 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/purestorage/flasharray/purefa_pgsnap_module.html