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

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

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

Обзор

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

Требования

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

python >= 2.7
purestorage

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_token строка / обязательно		Токен API FlashArray для пользователя с правами администратора.
eradicate логическое значение	Варианты: нет ← да	Определяет, следует ли уничтожить том при удалении или оставить в корзине.
fa_url строка / обязательно		IP-адрес управления FlashArray или имя хоста (IPv4).
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.9/modules/purefa_volume_module.html