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

Примечание

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

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

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

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

Новая функция в purestorage.flasharray 1.0.0

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

Описание

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

Требования

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

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

Параметры

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

Примечания

Примечание

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

Примеры

- name: Create new volune 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 volune 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 volune 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 volune 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 volune 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

Авторы

Команда Ansible Pure Storage (@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_vg_module.html