purestorage.flasharray.purefa_volume – Управление томами на FlashArray Pure Storage
Примечание
Этот плагин является частью коллекции purestorage.flasharray (версия 1.5.1).
Для его установки используйте: ansible-galaxy collection install purestorage.flasharray.
Для использования в книге задач укажите: purestorage.flasharray.purefa_volume.
Новое в версии 1.0.0: из purestorage.flasharray
Обзор
- Создание, удаление или расширение емкости тома на Pure Storage FlashArray.
Требования
Ниже перечислены требования, необходимые на хосте, который выполняет этот модуль.
- python >= 2.7
- purestorage >= 1.19
- py-pure-client >= 1.6.0
- netaddr
- requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_token строка | Токен API FlashArray для пользователя с привилегиями администратора. | |
| bw_qos строка | Предел пропускной способности для тома в единицах М или Г. М установит значение в Мбит/с, Г установит значение в Гбит/с. Чтобы очистить существующее ограничение QoS, используйте 0 (ноль). Псевдонимы: qos | |
| count целое число | Количество томов, подлежащих созданию при создании нескольких томов. Поддерживается только с Purity//FA v6.0.0 и выше | |
| digits целое число | По умолчанию: 1 | Количество цифр для использования в счетчике нескольких томов. Это позволит дополнять индекс номера нулями, где это необходимо Поддерживается только с Purity//FA v6.0.0 и выше Диапазон от 1 до 10 |
| eradicate булево |
| Определите, следует ли уничтожить том при удалении или оставить в корзине. |
| fa_url строка | Управление FlashArray IPv4-адрес или имя хоста. | |
| iops_qos строка | Предел IOPs для тома — используйте значение или K или М. K будет означать 1000, M будет означать 1000000. Чтобы очистить существующее ограничение IOPs, используйте 0 (ноль). | |
| move строка | Перемещение тома в подсистему и из неё или из группы виртуальных томов. Укажите имя подсистемы или группы виртуальных томов, куда необходимо переместить том. Имена подсистем и групп виртуальных томов должны быть уникальными в массиве. Для перемещения в локальный массив укажите local
Это не идемпотентно — используйте ignore_errors в книге задач. | |
| name строка / обязательно | Имя тома. Том можно создать в POD с помощью этого синтаксиса POD_NAME::VOLUME_NAME. Том можно создать в группе томов с помощью этого синтаксиса VG_NAME/VOLUME_NAME. Поддержка нескольких томов доступна с Purity//FA 6.0.0 ***ПРИМЕЧАНИЕ*** Ручное удаление или уничтожение отдельных томов, созданных с помощью нескольких томов, приведет к сбою идемпотентности Поддержка нескольких томов существует только для создания томов. | |
| overwrite булево |
| Определите, следует ли перезаписать целевой том, если он уже существует. |
| rename строка | Значение для переименования указанного тома. Переименование применяется только к контейнеру, в котором находится текущий том. Нет необходимости указывать имя подсистемы или группы виртуальных томов, так как это подразумевается. | |
| size строка | Размер тома в единицах М, Г, Т или П. | |
| start целое число | По умолчанию: 0 | Номер, с которого следует начать индекс создания нескольких томов. Поддерживается только с Purity//FA v6.0.0 и выше |
| state строка |
| Определите, должен ли существовать том или нет. |
| suffix строка | Строка-суффикс, если требуется, для создания нескольких томов. Имена томов будут сформированы как <name>#I<suffix>, где # — заполнитель для индекса тома. См. связанные описания. Поддерживается только с Purity//FA v6.0.0 и выше | |
| target строка | Имя целевого тома при копировании. |
Примечания
Примечание
- Для этого модуля требуется библиотека Python
purestorage - Вы должны установить переменные среды
PUREFA_URLиPUREFA_API, если аргументы fa_url и api_token не передаются в модуль непосредственно.
Примеры
- name: Create new volume named foo with a QoS limit
purefa_volume:
name: foo
size: 1T
bw_qos: 58M
iops_qos: 23K
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: present
- name: Create new volume named foo in pod bar
purefa_volume:
name: bar::foo
size: 1T
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: present
- name: Create 10 volumes with index starting at 10 but padded with 3 digits
purefa_volume:
name: foo
size: 1T
suffix: bar
count: 10
start: 10
digits: 3
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: present
- name: Extend the size of an existing volume named foo
purefa_volume:
name: foo
size: 2T
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: present
- name: Delete and eradicate volume named foo
purefa_volume:
name: foo
eradicate: yes
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: absent
- name: Create clone of volume bar named foo
purefa_volume:
name: foo
target: bar
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: present
- name: Overwrite volume bar with volume foo
purefa_volume:
name: foo
target: bar
overwrite: yes
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: present
- name: Clear volume QoS from volume foo
purefa_volume:
name: foo
bw_qos: 0
iops_qos: 0
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: present
- name: Move local volume foo from local array to pod bar
purefa_volume:
name: foo
move: bar
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Move volume foo in pod bar to local array
purefa_volume:
name: bar::foo
move: local
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Move volume foo in pod bar to vgroup fin
purefa_volume:
name: bar::foo
move: fin
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
Возвращаемые значения
Общие значения, возвращаемые модулями, описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| volume словарь | успех | Словарь, описывающий измененный том. Только некоторые атрибуты ниже будут возвращены с различными действиями. | |
| bandwidth_limit целое число | успех | Предел пропускной способности тома в байтах/сек | |
| created строка | успех | Время создания тома Пример: 2019-03-13T22:49:24Z | |
| iops_limit целое число | успех | Предел IOPs тома | |
| name строка | успех | Имя тома | |
| serial строка | успех | Серийный номер тома Пример: 361019ECACE43D83000120A4 | |
| size целое число | успех | Размер тома в байтах | |
| source строка | успех | Имя тома исходного тома, используемого для копирования тома | |
Авторы
- Команда Ansible Pure Storage (@sdodsley) <pure-ansible-team@purestorage.com>
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/purestorage/flasharray/purefa_volume_module.html