Модуль infinidat.infinibox.infini_vol – создание, удаление и изменение томов в Infinibox

Примечание

Этот модуль входит в коллекцию infinidat.infinibox (версия 1.6.3).

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

Для установки используйте: ansible-galaxy collection install infinidat.infinibox. Для работы с этим модулем требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: infinidat.infinibox.infini_vol.

Добавлено в infinidat.infinibox 2.3.0

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

Краткое описание

Этот модуль создает, удаляет или изменяет том в Infinibox.

Требования

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

capacity
infinisdk (https://infinisdk.readthedocs.io/en/latest/)
python2 >= 2.7 или python3 >= 3.6

Параметры

Параметр	Комментарии
name string	Имя тома.
parent_volume_name string	Укажите имя тома. Это родительский том для создания снимка. Обязательный параметр, если volume_type имеет значение snapshot.
password string / обязательный	Пароль пользователя Infinibox.
pool string	Пул, в котором будет находиться основной том. Обязательный параметр для создания основного тома, но не снимка.
restore_volume_from_snapshot boolean	Укажите true, чтобы восстановить том (parent_volume_name) из существующего снимка, имя которого указано в поле name. Параметр state должен иметь значение present, а volume_type — значение ‘snapshot’. Варианты: `false` ← (по умолчанию) `true`
serial string	Серийный номер тома.
size string	Размер тома в МБ, ГБ или ТБ. Обязательный параметр для создания основного тома, но не снимка.
snapshot_lock_expires_at string	Блокирует снимок до указанной даты и времени. Используется формат даты и времени Python YYYY-mm-dd HH:MM:SS.ffffff, например 2020-02-13 16:21:59.699700
snapshot_lock_only boolean	Блокирует существующий снимок, не обновляя его. Варианты: `false` ← (по умолчанию) `true`
state string	Создает или изменяет основной том либо снимок, если задано значение present, и удаляет, если задано значение absent. Варианты: `"stat"` `"present"` ← (по умолчанию) `"absent"`
stay_logged_in boolean	Если задано значение True, сохраняет сеанс API на диске. Загружает сеанс при последующих вызовах модуля. Сохраненные сеансы можно использовать только в течение периода stay_logged_in_minutes. Варианты: `false` ← (по умолчанию) `true`
stay_logged_in_minutes integer	Количество минут, в течение которых можно повторно использовать сохраненный сеанс. По истечении этого времени данные сеанса будут удалены. Это значение должно быть меньше времени ожидания сеанса IBOX. По умолчанию: `5`
system string / обязательный	Имя хоста Infinibox или адрес IPv4.
thin_provision boolean	Определяет, будет ли основной том создан с тонким или полным выделением ресурсов. Варианты: `false` `true` ← (по умолчанию)
user string / обязательный	Имя пользователя Infinibox с достаточными привилегиями (см. примечания).
volume_type string	Задает тип тома: обычный том или снимок. Варианты: `"master"` ← (по умолчанию) `"snapshot"`
write_protected string	Определяет, будет ли том защищен от записи. По умолчанию для снимков используется значение True, а для обычных томов — False. Варианты: `"Default"` ← (по умолчанию) `"True"` `"False"`

Примечания

Примечание

Для работы этого модуля требуется библиотека Python infinisdk
Если аргументы user и password не переданы модулю напрямую, необходимо задать переменные среды INFINIBOX_USER и INFINIBOX_PASSWORD
Если учетные данные не указаны, Ansible использует файл конфигурации infinisdk ~/.infinidat/infinisdk.ini. См. http://infinisdk.readthedocs.io/en/latest/getting_started.html
Все модули Infinidat поддерживают режим проверки (--check). Однако пробный запуск, создающий ресурсы, может завершиться ошибкой, если для задачи не выполнены зависимости ресурсов. Например, рассмотрим задачу создания тома в пуле. Если пул не существует, задача создания тома завершится ошибкой. Ошибка возникнет даже в том случае, если в плейбуке есть предыдущая задача создания пула, но она не выполнилась, поскольку создание пула также было частью пробного запуска.

Примеры

- name: Create new volume named foo under pool named bar
  infini_vol:
    name: foo
    # volume_type: master  # Default
    size: 1TB
    thin_provision: true
    pool: bar
    state: present
    user: admin
    password: secret
    system: ibox001
- name: Create snapshot named foo_snap from volume named foo
  infini_vol:
    name: foo_snap
    volume_type: snapshot
    parent_volume_name: foo
    state: present
    user: admin
    password: secret
    system: ibox001
- name: Stat snapshot, also a volume, named foo_snap
  infini_vol:
    name: foo_snap
    state: present
    user: admin
    password: secret
    system: ibox001
- name: Remove snapshot, also a volume, named foo_snap
  infini_vol:
    name: foo_snap
    state: absent
    user: admin
    password: secret
    system: ibox001

Авторы

David Ohlemacher (@ohlemacher)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/infinidat/infinibox/infini_vol_module.html