Модуль ibm.storage_virtualize.ibm_svc_manage_volumegroup — управление группами томов в системах семейства 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_volumegroup.

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

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

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

Интерфейс Ansible для управления командами «mkvolumegroup», «chvolumegroup» и «rmvolumegroup».

Параметры

Параметр	Комментарии
clustername строка / обязательный	Имя хоста, IP-адрес управления или IP-адрес раздела системы Storage Virtualize.
domain строка	Домен системы Storage Virtualize. Допустимо, если для параметра clustername используется имя хоста.
draftpartition строка добавлено в ibm.storage_virtualize 2.5.0	Указывает имя чернового раздела, назначаемого группе томов. Применяется, если state=present. Поддерживается в системах семейства Storage Virtualize версии 8.6.3.0 или более поздней.
evictvolumes логическое значение добавлено в ibm.storage_virtualize 2.2.0	Если указано значение `True`, группа томов удаляется, но тома остаются. Применяется при state=absent, чтобы удалить группу томов, сохранив связанные с ней тома. Поддерживается в системах семейства Storage Virtualize версии 8.6.2.0 или более поздней. Допустимые значения: `false` `true`
fromsourcegroup строка добавлено в ibm.storage_virtualize 1.9.0	Указывает родительскую группу томов снимка. Используется для предварительного заполнения нового тома в новой группе томов. Допустимо при создании доступной для хоста группы томов на основе существующего снимка.
fromsourcevolumes строка добавлено в ibm.storage_virtualize 2.3.0	Указывает разделённый двоеточиями список имён/UID родительских томов. В сочетании с параметром type и снимком позволяет создать volumegroup с подмножеством томов, образы которых присутствуют в снимке. Применяется при state=present для создания клона или тонкого клона volumegroup из подмножества томов снимка. Поддерживается в системах семейства Storage Virtualize версии 8.6.2.0 или более поздней.
ignoreuserfcmaps строка добавлено в ibm.storage_virtualize 1.10.0	Позволяет пользователю создавать снимки с помощью планировщика или вручную с помощью `addsnapshot`. Этот параметр можно использовать только в том случае, если том из группы томов используется в качестве источника пользовательского сопоставления FlashCopy прежнего типа. Допустимо при создании и обновлении группы томов. Поддерживается в системах семейства Storage Virtualize версии 8.5.2.0 или более поздней. Допустимые значения: `"yes"` `"no"`
iogrp строка добавлено в ibm.storage_virtualize 1.9.0	Указывает группу ввода-вывода для новых томов. Допустимо при создании доступной для хоста группы томов на основе существующего снимка.
log_path строка	Путь к файлу журнала отладки.
name строка / обязательный	Указывает имя группы томов.
nodrreplication логическое значение добавлено в ibm.storage_virtualize 2.6.0	Если указано значение `True`, группа томов удаляется из политики асинхронной репликации для аварийного восстановления. nodrreplication нельзя использовать одновременно с параметрами replicationpolicy и noreplicationpolicy. Применяется при state=present для изменения существующей группы томов. Поддерживается в системах семейства Storage Virtualize версии 8.7.1.0 или более поздней. Допустимые значения: `false` `true`
noownershipgroup логическое значение	Если указано значение `True`, объект удаляется из группы владельцев, к которой он принадлежит. Параметры ownershipgroup и noownershipgroup являются взаимоисключающими. Применяется при state=present для изменения существующей группы томов. Допустимые значения: `false` `true`
noreplicationpolicy логическое значение добавлено в ibm.storage_virtualize 1.10.0	Если указано значение `True`, политика репликации, назначенная группе томов, удаляется. noreplicationpolicy нельзя использовать одновременно с параметрами replicationpolicy и nodrreplication. Применяется при state=present для изменения существующей группы томов. Поддерживается в системах семейства Storage Virtualize версии 8.5.2.1 или более поздней. Допустимые значения: `false` `true`
nosafeguardpolicy логическое значение	Если указано значение `True`, политика Safeguarded, назначенная группе томов, удаляется. Параметры safeguardpolicyname и nosafeguardpolicy являются взаимоисключающими. Применяется при state=present для изменения существующей группы томов. Допустимые значения: `false` `true`
nosnapshotpolicy логическое значение добавлено в ibm.storage_virtualize 1.9.0	Если указано значение `True`, политика снимков, назначенная группе томов, удаляется. Параметры snapshotpolicy и nosnapshotpolicy являются взаимоисключающими. Применяется при state=present для изменения существующей группы томов. Допустимые значения: `false` `true`
old_name строка добавлено в ibm.storage_virtualize 2.0.0	Указывает старое имя группы томов при переименовании. Допустимо при state=present для переименования существующей группы томов.
ownershipgroup строка	Указывает имя группы владельцев, в которую добавляется объект. ownershipgroup нельзя использовать одновременно с параметрами safeguardpolicyname и noownershipgroup. Применяется при state=present.
partition строка добавлено в ibm.storage_virtualize 2.1.0	Указывает имя раздела хранения, назначаемого группе томов. Применяется, если state=present. Поддерживается в системах семейства Storage Virtualize версии 8.6.1.0 или более поздней.
password строка	Пароль REST API для системы Storage Virtualize. Параметры username и password обязательны, если для аутентификации пользователя не используется token.
policystarttime строка	Указывает время создания первой резервной копии Safeguarded. Этот параметр также можно использовать с политикой снимков. При использовании policystarttime требуется параметр safeguardpolicyname. Допустимый формат: YYMMDDHHMM. Применяется при state=present.
pool строка добавлено в ibm.storage_virtualize 1.9.0	Указывает имя пула, в котором будут созданы целевые тома. Допустимо при создании доступной для хоста группы томов на основе существующего снимка.
replicationpolicy строка добавлено в ibm.storage_virtualize 1.10.0	Указывает имя политики репликации, назначаемой группе томов. Применяется при state=present. Поддерживается в системах семейства Storage Virtualize версии 8.5.2.1 или более поздней.
safeguarded логическое значение добавлено в ibm.storage_virtualize 1.10.0	Если указано, политика снимков создаёт снимки Safeguarded. Следует указывать вместе с snapshotpolicy. Допустимо при создании и обновлении группы томов. Поддерживается в системах семейства Storage Virtualize версии 8.5.2.0 или более поздней. Допустимые значения: `false` ← (по умолчанию) `true`
safeguardpolicyname строка	Имя политики Safeguarded, назначаемой группе томов. safeguardpolicyname нельзя использовать одновременно с параметрами nosafeguardpolicy и ownershipgroup. Применяется при state=present.
snapshot строка добавлено в ibm.storage_virtualize 1.9.0	Указывает имя снимка, используемого для предварительного заполнения новых томов в новой группе томов. Обязателен при создании доступной для хоста группы томов на основе существующего снимка.
snapshotpolicy строка добавлено в ibm.storage_virtualize 1.9.0	Имя политики снимков, назначаемой группе томов. snapshotpolicy нельзя использовать одновременно с параметрами nosnapshotpolicy и ownershipgroup. Применяется при state=present.
snapshotpolicysuspended строка добавлено в ibm.storage_virtualize 1.9.0	Указывает, нужно ли приостановить (`yes`) или возобновить (`no`) действие политики снимков для этой группы томов. Применяется при state=present для изменения существующей группы томов. Допустимые значения: `"yes"` `"no"`
state строка / обязательный	Создаёт или обновляет (`present`) либо удаляет (`absent`) группу томов. Допустимые значения: `"absent"` `"present"`
token строка	Токен аутентификации для проверки пользователя в системе Storage Virtualize. Чтобы создать токен, используйте модуль ibm.storage_virtualize.ibm_svc_auth.
type строка добавлено в ibm.storage_virtualize 1.9.0	Указывает тип группы томов, создаваемой на основе снимка. Допустимо при создании доступной для хоста группы томов на основе существующего снимка. Также используется для преобразования тонкого клона volumegroup в клон. Необходимо указать type = clone. Допустимые значения: `"clone"` `"thinclone"`
username строка	Имя пользователя REST API для системы Storage Virtualize. Параметры username и password обязательны, если для аутентификации пользователя не используется token.
validate_certs логическое значение	Проверяет сертификат. Допустимые значения: `false` ← (по умолчанию) `true`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Политику Safeguarded и политику снимков нельзя использовать одновременно. Поэтому параметры snapshotpolicy и safeguardpolicyname являются взаимоисключающими.
Этот модуль поддерживает вход с использованием IP-адреса раздела.

Примеры

- name: Create a new volume group
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: present
- name: Delete a volume group
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: absent
- name: Update existing volume group to remove ownershipgroup and attach a safeguardpolicy to it
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: present
    noownershipgroup: true
    safeguardpolicyname: sg1
- name: Update volumegroup with snapshot policy and remove safeguarded policy
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    nosafeguardpolicy: true
    snapshotpolicy: sp1
    state: present
- name: Update volumegroup with safeguarded snapshot policy and ignoreuserfcmaps
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    safeguarded: true
    snapshotpolicy: sp1
    ignoreuserfcmaps: 'yes'
    state: present
- name: Suspend snapshot policy in an existing volume group
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    snapshotpolicysuspended: true
    state: present
- name: Create host accessible volume group from an existing snapshot
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: host_accessible_vg
    type: clone
    snapshot: snapshot0
    fromsourcegroup: vg0
    pool: Pool0
    state: present
- name: Create a volumegroup thinclone from a list of volumes
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    type: thinclone
    fromsourcevolumes: vol1:vol2
    pool: Pool0
    state: present
- name: Create a volumegroup clone from a list of volumes
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    type: clone
    fromsourcevolumes: vol1:vol2
    pool: Pool0
    state: present
- name: Convert a thinclone volumegroup to clone
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    type: clone
    state: present
- name: Delete a volume group, keeping volumes which were associated with volumegroup
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: absent
    evictvolumes: true
- name: Add new or existing volumegroup to a draft partition
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: present
    draftpartition: partition_name
- name: Remove DR replication-policy from volume group
  ibm.storage_virtualize.ibm_svc_manage_volumegroup:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    log_path: /tmp/playbook.debug
    name: vg0
    state: absent
    nodrreplication: true

Авторы

Shilpi Jain(@Shilpi-J)
Sanjaikumaar M (@sanjaikumaar)
Sumit Kumar Gupta (@sumitguptaibm)
Sandip G. Rajbanshi (@Sandip-Rajbanshi)

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

© 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_volumegroup_module.html