purefa_volume – Управление томами на Pure Storage FlashArrays

Новое в версии 2.4.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

Создание, удаление или расширение емкости тома на Pure Storage FlashArray.

Требования

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

python >= 2.7
purestorage

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_token строка / обязательно		Токен API FlashArray для пользователя с привилегиями администратора.
eradicate логическое значение	Варианты: нет ← да	Определяет, следует ли удалить том при удалении или оставить его в корзине.
fa_url строка / обязательно		Управляющий IPv4-адрес или имя хоста FlashArray.
name строка / обязательно		Имя тома.
overwrite логическое значение	Варианты: нет ← да	Определяет, следует ли перезаписать целевой том, если он уже существует.
qos строка добавлено в 2.8		Предел пропускной способности тома в единицах М или Г. М задаёт Мбит/с, Г задаёт Гбит/с. Для сброса существующего значения QoS использовать 0 (ноль).
size строка		Размер тома в единицах М, Г, Т или П.
state строка	Варианты: отсутствует существует ←	Определяет, должен ли существовать том или нет.
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
    qos: 58M
    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
    qos: 0
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

Возвращаемые значения

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

Ключ		Возвращено	Описание
volume словарь		успех	Словарь, описывающий изменённый том. Будут возвращены только некоторые атрибуты ниже в зависимости от действий.
	created строка		Время создания тома Пример: 2019-03-13T22:49:24Z
	name строка		Имя тома
	serial строка		Серийный номер тома Пример: 361019ECACE43D83000120A4
	size целое число		Размер тома в байтах
	source строка		Имя тома-источника, использованного для копирования тома

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [предварительная версия]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Команда Pure Storage Ansible (@sdodsley) <pure-ansible-team@purestorage.com>

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете редактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/purefa_volume_module.html