Spec-Zone.ru › Ansible 2.11

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API