Модуль purestorage.flasharray.purefa_dirsnap — управление снимками каталогов файловой системы FlashArray

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: purestorage.flasharray.purefa_dirsnap.

Добавлено в purestorage.flasharray 1.9.0

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

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

Создание и удаление снимков каталогов файловой системы FlashArray
Полное имя снимка формируется в виде DIR.CLIENT_NAME.SUFFIX, где DIR — имя управляемого каталога, CLIENT_NAME — имя клиента, а SUFFIX — суффикс.
Имя снимка, видимое клиенту, — CLIENT_NAME.SUFFIX.

Требования

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

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

Параметры

Параметр	Комментарии
api_token string	Токен API FlashArray для пользователя с правами администратора.
client string / обязательный	Часть имени снимка, видимого клиенту, содержащая имя клиента
context string добавлено в purestorage.flasharray 1.39.0	Имя участника флота, для которого выполняется операция. Массив, получающий запрос, должен быть участником флота, а имя контекста должно соответствовать участнику того же флота. По умолчанию: `""`
disable_warnings boolean добавлено в purestorage.flasharray 1.29.0	Отключить предупреждения о небезопасных сертификатах в журналах отладки Варианты: `false` ← (по умолчанию) `true`
eradicate boolean	Определяет, следует ли безвозвратно удалить снимок или оставить его в корзине при удалении Варианты: `false` ← (по умолчанию) `true`
fa_url string	IPv4-адрес или имя узла для управления FlashArray.
filesystem string / обязательный	Имя файловой системы, с которой связан каталог.
keep_for integer	Срок хранения, по истечении которого снимки будут безвозвратно удалены Укажите значение в секундах. Диапазон: 300–31536000 (от 5 минут до 1 года) Значение 0 означает отсутствие срока хранения. Если параметр не указан при создании, по умолчанию используется значение 0 (срок хранения не задан)
name string / обязательный	Имя каталога, для которого создаётся снимок
new_client string добавлено в purestorage.flasharray 1.12.0	Новое имя клиента при переименовании
new_suffix string добавлено в purestorage.flasharray 1.12.0	Новый суффикс при переименовании
rename boolean добавлено в purestorage.flasharray 1.12.0	Определяет, следует ли переименовать снимок каталога Имя клиента и суффикс снимка можно изменить Требуется указать вместе с new_client и new_suffix Варианты: `false` ← (по умолчанию) `true`
state string	Определяет, должен ли снимок каталога существовать. Варианты: `"absent"` `"present"` ← (по умолчанию)
suffix string	Используемый суффикс снимка

Примечания

Примечание

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

Примеры

- name: Create a snapshot directory foo in filesysten bar for client test with suffix test
  purestorage.flasharray.purefa_dirsnap:
    name: foo
    filesystem: bar
    client: test
    suffix: test
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Update retention time for a snapshot foo:bar.client.test
  purestorage.flasharray.purefa_dirsnap:
    name: foo
    filesystem: bar
    client: client
    suffix: test
    keep_for: 300  # 5 minutes
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete snapshot foo:bar.client.test
  purestorage.flasharray.purefa_dirsnap:
    name: foo
    filesystem: bar
    client: client
    suffix: test
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Recover deleted snapshot foo:bar.client.test
  purestorage.flasharray.purefa_dirsnap:
    name: foo
    filesystem: bar
    client: client
    suffix: test
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete and eradicate snapshot foo:bar.client.test
  purestorage.flasharray.purefa_dirsnap:
    name: foo
    filesystem: bar
    client: client
    suffix: test
    state: absent
    eradicate: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Eradicate deleted snapshot foo:bar.client.test
  purestorage.flasharray.purefa_dirsnap:
    name: foo
    filesystem: bar
    client: client
    suffix: test
    eradicate: true
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Rename snapshot
  purestorage.flasharray.purefa_dirsnap:
    name: foo
    filesystem: bar
    client: client
    suffix: test
    rename: true
    new_client: client2
    new_suffix: test2
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Авторы

Команда Pure Storage Ansible (@sdodsley)

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

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