модуль purestorage.flasharray.purefa_vg — Управление группами томов на массивах Pure Storage FlashArray

Примечание

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

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

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

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

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

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

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

Создание, удаление и изменение групп томов на массивах Pure Storage FlashArray.

Требования

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

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

Параметры

Параметр	Комментарии
api_token string	Токен API FlashArray для пользователя с правами администратора.
bw_qos string	Ограничение пропускной способности для группы томов в единицах M или G. M задаёт MB/s, G задаёт GB/s. Чтобы сбросить существующее значение QoS, укажите 0 (ноль).
context string добавлено в purestorage.flasharray 1.33.0	Имя участника флота, для которого выполняется операция. Для этого массив, получающий запрос, должен быть участником флота, а имя контекста должно соответствовать участнику того же флота. По умолчанию: `""`
count integer	Количество групп томов, создаваемых при массовом создании групп томов. Поддерживается только в Purity//FA v6.0.0 и более поздних версиях.
digits integer	Количество цифр, используемых для счётчика групп томов при массовом создании. При необходимости индекс дополняется нулями. Поддерживается только в Purity//FA v6.0.0 и более поздних версиях. Диапазон значений: от 1 до 10. По умолчанию: `1`
disable_warnings boolean добавлено в purestorage.flasharray 1.29.0	Отключить предупреждения о небезопасных сертификатах в журналах отладки. Варианты: `false` ← (по умолчанию) `true`
eradicate boolean	Определяет, следует ли безвозвратно удалить группу томов при удалении или оставить её в корзине. Варианты: `false` ← (по умолчанию) `true`
fa_url string	IPv4-адрес или имя хоста для управления FlashArray.
iops_qos string	Ограничение IOPS для группы томов — укажите значение, K или M. K означает 1000, M означает 1000000. Чтобы сбросить существующее значение IOPS, укажите 0 (ноль).
name string / обязательный	Имя группы томов. Поддержка нескольких групп томов доступна начиная с Purity//FA 6.0.0. *ПРИМЕЧАНИЕ* Ручное удаление или безвозвратное удаление отдельных групп томов, созданных с помощью функции создания нескольких групп томов, приведёт к нарушению идемпотентности. Создание нескольких групп томов поддерживается только при создании групп томов.
priority_operator string добавлено в purestorage.flasharray 1.13.0	Оператор корректировки приоритета DMM. Варианты: `"+"` ← (по умолчанию) `"-"`
priority_value integer добавлено в purestorage.flasharray 1.13.0	Значение корректировки приоритета DMM. Варианты: `0` ← (по умолчанию) `10`
rename string добавлено в purestorage.flasharray 1.22.0	Имя, которое будет присвоено указанной группе томов.
start integer	Номер, с которого начинается индекс при массовом создании групп томов. Поддерживается только в Purity//FA v6.0.0 и более поздних версиях. По умолчанию: `0`
state string	Определяет, должна ли группа томов существовать. Варианты: `"absent"` `"present"` ← (по умолчанию)
suffix string	Строка суффикса, используемая при необходимости для массового создания групп томов. Имена групп томов будут сформированы в виде <name>#I<suffix>, где # — это заполнитель для индекса тома. См. связанные описания. Поддерживается только в Purity//FA v6.0.0 и более поздних версиях.

Примечания

Примечание

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

Примеры

- name: Create new volume group
  purestorage.flasharray.purefa_vg:
    name: foo
    bw_qos: 50M
    iops_qos: 100
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create 10 volume groups of pattern foo#bar with QoS
  purestorage.flasharray.purefa_vg:
    name: foo
    suffix: bar
    count: 10
    start: 10
    digits: 3
    bw_qos: 50M
    iops_qos: 100
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Update volume group QoS limits
  purestorage.flasharray.purefa_vg:
    name: foo
    bw_qos: 0
    iops_qos: 5555
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Update volume group DMM Priority Adjustment (Purity//FA 6.1.2+)
  purestorage.flasharray.purefa_vg:
    name: foo
    priority_operator: '-'
    priority_value: 10
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Destroy volume group
  purestorage.flasharray.purefa_vg:
    name: foo
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Recover deleted volume group - no changes are made to the volume group on recovery
  purestorage.flasharray.purefa_vg:
    name: foo
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Destroy and Eradicate volume group
  purestorage.flasharray.purefa_vg:
    name: foo
    eradicate: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Rename volume group foo to bar
  purestorage.flasharray.purefa_vg:
    name: foo
    rename: bar
    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_vg_module.html