Модуль ibm.storage_virtualize.ibm_svc_manage_volume — управление стандартными томами в системах семейства IBM Storage Virtualize

Примечание

Этот модуль входит в коллекцию ibm.storage_virtualize (версия 3.3.0).

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

Для установки используйте: ansible-galaxy collection install ibm.storage_virtualize.

Чтобы использовать модуль в плейбуке, укажите: ibm.storage_virtualize.ibm_svc_manage_volume.

Добавлено в ibm.storage_virtualize 1.6.0

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

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

Интерфейс Ansible для управления командами работы с томами ‘mkvolume’, ‘rmvolume’ и ‘chvdisk’.

Параметры

Параметр	Комментарии
allow_hs логическое значение добавлено в ibm.storage_virtualize 2.0.0	Если указано значение `True`, управляет томом hyperswap, игнорируя проверку типа тома. Допустимо при state=present для изменения существующего тома. Варианты: `false` ← (по умолчанию) `true`
autoexpand строка добавлено в ibm.storage_virtualize 3.2.0	Указывает, следует ли автоматически увеличивать фактическую емкость тонко выделенных копий тома. Если указано значение off, действует как `noautoexpand`. Варианты: `"on"` `"off"`
buffersize строка	Указывает емкость пула, резервируемую томом в качестве буфера для тонко выделенных и сжатых томов. Чтобы использовать этот параметр, необходимо указать параметр ‘thin’ или ‘compressed’. Размер буфера по умолчанию составляет 2%. При использовании buffersize требуется указать thin или compressed. Допустимо при state=present для создания тома.
cache строка добавлено в ibm.storage_virtualize 3.2.0	Указывает параметры кэширования тома. Если значение не указано, по умолчанию используется ‘readwrite’. Варианты: `"readwrite"` `"readonly"` `"none"`
cloud_account_name строка добавлено в ibm.storage_virtualize 1.11.0	Указывает имя учетной записи облака. Допустимо при enable_cloud_snapshot=true.
clustername строка / обязательный	Имя хоста, IP-адрес управления или IP-адрес раздела системы Storage Virtualize.
compressed логическое значение	Указывает, что необходимо создать сжатый том. Параметры ‘compressed’ и ‘thin’ являются взаимоисключающими. Допустимо при state=present для создания сжатого тома. Варианты: `false` `true`
deduplicated логическое значение	Указывает, что необходимо создать дедуплицированный том. Обязателен при state=present для создания дедуплицированного тома. Варианты: `false` `true`
domain строка	Домен системы Storage Virtualize. Допустимо, если для параметра clustername используется имя хоста.
enable_cloud_snapshot логическое значение добавлено в ibm.storage_virtualize 1.11.0	Указывает, следует ли включить или отключить снимки облака. Допустимо при state=present для изменения существующего тома. Варианты: `false` `true`
fromsourcevolume строка	Указывает имя/UID тома в снимке, используемого для предварительного заполнения клона или тонкого клона. Допустимо при state=present для создания тонкого клона или клона. Поддерживается в системах семейства Storage Virtualize версии 8.6.2.0 и более поздних.
grainsize целое число добавлено в ibm.storage_virtualize 3.0.0	Задает размер блока для тонко выделенного тома. Варианты: `32` `64` `128` `256`
iogrp строка	Указывает список имен групп ввода-вывода. Имена групп в списке необходимо разделять запятыми. При создании нового тома первая группа ввода-вывода в списке добавляется как кэшированная и группа доступа, а остальные группы ввода-вывода добавляются как группы доступа. Этот параметр поддерживает обновление. Допустимо при state=present для создания или изменения тома.
log_path строка	Путь к файлу журнала отладки.
name строка / обязательный	Указывает имя, которое будет присвоено новому тому, либо имя/UID для управления существующим томом.
novolumegroup логическое значение	Если указано значение `True`, том удаляется из связанной с ним группы томов. Параметры ‘novolumegroup’ и ‘volumegroup’ являются взаимоисключающими. Допустимо при state=present для изменения тома. Варианты: `false` `true`
old_name строка добавлено в ibm.storage_virtualize 1.9.0	Указывает старое имя/UID тома при переименовании. Допустимо при state=present для переименования существующего тома.
password строка	Пароль REST API для системы Storage Virtualize. Если для аутентификации пользователя не используется token, необходимо указать параметры username и password.
pool строка	Указывает имя пула хранения, который будет использоваться при создании тома. Этот параметр обязателен при state=present для создания тома.
preferrednode строка добавлено в ibm.storage_virtualize 3.2.0	Указывает имя предпочтительного узла, используемого для доступа к тому. Если значение не указано, система автоматически выбирает предпочтительный узел.
size строка	Задает размер тома. Этот параметр также можно использовать для изменения размера существующего тома. Обязателен при state=present для создания или изменения тома.
state строка / обязательный	Создает или обновляет (`present`) либо удаляет (`absent`) том. Варианты: `"absent"` `"present"`
thin логическое значение	Указывает, что необходимо создать тонко выделенный том. Параметры ‘thin’ и ‘compressed’ являются взаимоисключающими. Допустимо при state=present для создания тонко выделенного тома. Варианты: `false` `true`
token строка	Токен аутентификации для проверки пользователя в системе Storage Virtualize. Для создания токена используйте модуль ibm_svc_auth.
type строка	Указывает тип создаваемого тома. Том может быть тонким клоном или клоном. Допустимо при state=present для создания тонкого клона или клона. Поддерживается в системах семейства Storage Virtualize версии 8.6.2.0 и более поздних. Также используется для преобразования тонкого клона в клон. Необходимо указать type = clone. Варианты: `"thinclone"` `"clone"`
unit строка	Указывает единицы измерения данных для емкости, заданной параметром ‘size’. При использовании unit требуется указать size. Варианты: `"b"` `"kb"` `"mb"` `"gb"` `"tb"` `"pb"`
unmap список / элементы=строка добавлено в ibm.storage_virtualize 2.7.0	Удаляет указанные объекты, связанные с удаляемым томом. Допустимо при state=absent для удаления тома. Варианты: `"host_mappings"` `"remotecopy_relationships"` `"flashcopy_mappings"`
username строка	Имя пользователя REST API для системы Storage Virtualize. Если для аутентификации пользователя не используется token, необходимо указать параметры username и password.
validate_certs логическое значение	Проверяет сертификаты. Варианты: `false` ← (по умолчанию) `true`
volumegroup строка	Указывает имя группы томов, в которую необходимо добавить том. Параметры ‘volumegroup’ и ‘novolumegroup’ являются взаимоисключающими. Допустимо при state=present для создания или изменения тома.
warning целое число добавлено в ibm.storage_virtualize 2.7.0	Выдает предупреждение, когда используемая емкость тонко выделенной копии впервые превышает указанный порог. Значение задается в процентах от общей емкости тонко выделенного тома, поэтому должно находиться в диапазоне от 0 до 100. Если значение не указано, по умолчанию используется 80%. Допустимо при state=present для создания или изменения тонко выделенного или сжатого тома.

Примечания

Примечание

Этот модуль поддерживает check_mode.
Для параметра unmap параметр remotecopy_relationships считается устаревшим начиная с версии 8.7.1.0.
CMMVC9855E Команда завершилась с ошибкой, поскольку один или несколько указанных томов не существуют. Эта ошибка возникает, если томы, указанные пользователем, не существуют.
Этот модуль поддерживает вход в систему с использованием IP-адреса раздела.
Инструкции по созданию клона или тонкого клона тома см. в модуле ibm_sv_manage_clone.

Примеры

- name: Create a volume
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0, io_grp1"
    volumegroup: "test_volumegroup"
- name: Create a thin-provisioned volume
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0, io_grp1"
    thin: true
    buffersize: 10%
- name: Create a compressed volume
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0, io_grp1"
    compressed: true
    buffersize: 10%
- name: Creating a volume with iogrp- io_grp0
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0"
- name: Create thinclone volume from volume vol1
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "vol1_thinclone"
    fromsourcevolume: "vol1"
    state: "present"
    pool: "pool0"
    type: "thinclone"
- name: Create clone volume from volume vol1
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "vol1_clone"
    fromsourcevolume: "vol1"
    state: "present"
    pool: "pool0"
    type: "clone"
- name: Adding a new iogrp- io_grp1
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    iogrp: "io_grp0, io_grp1"
- name: Rename an existing volume
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    old_name: "volume_name"
    name: "new_volume_name"
    state: "present"
- name: Convert a thinclone volume to clone
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "vol0-0"
    type: "clone"
    log_path: "{{ log_path }}"
    state: "present"
- name: Convert list of thinclone volumes to clone
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "vol0:vol1:vol2"
    type: "clone"
    log_path: "{{ log_path }}"
    state: "present"
- name: Update size of volume
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "volume_name"
    size: "2"
    unit: "gb"
    state: "present"
- name: Update volumegroup of volume
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "volume_name"
    volumegroup: "vg1"
    state: "present"
- name: Enable cloud backup in an existing volume
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "volume_name"
    enable_cloud_snapshot: true
    cloud_account_name: "aws_acc"
    state: "present"
- name: Delete a volume
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "new_volume_name"
    state: "absent"
- name: Delete a volume and remove associated host mappings, remote copy relationships, and flashcopy mappings
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "new_volume_name"
    state: "absent"
    unmap: ['host_mappings', 'remotecopy_relationships', 'flashcopy_mappings']
- name: Create a thin volume with grainsize
  ibm.storage_virtualize.ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: "{{ log_path }}"
    name: "volume_name"
    state: "present"
    pool: "pool_name"
    size: "1"
    unit: "gb"
    thin: true
    grainsize: 32

Авторы

Sreshtant Bohidar(@Sreshtant-Bohidar)
Rahul Pawar(@rahul-p)
Sumit Kumar Gupta(@sumitguptaibm)

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

© 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/ibm/storage_virtualize/ibm_svc_manage_volume_module.html