Модуль ibm.storage_virtualize.ibm_svc_manage_volumegroup – Этот модуль управляет группами томов на системах семейства IBM Storage Virtualize

Примечание

Этот модуль входит в коллекцию ibm.storage_virtualize (версия 2.5.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 string / required	Имя хоста или IP-адрес управления системы Storage Virtualize.
domain string	Домен для системы Storage Virtualize. Действительно, когда для параметра clustername используется имя хоста.
draftpartition string added in ibm.storage_virtualize 2.5.0	Указывает имя раздела черновика, который будет назначен группе томов. Применяется, когда state=present. Поддерживается системами семейства Storage Virtualize 8.6.3.0 и выше.
evictvolumes boolean added in ibm.storage_virtualize 2.2.0	Если указано `True`, удаляет группу томов, но не удаляет тома. Применяется, когда state=absent для удаления группы томов с сохранением связанных томов. Поддерживается системами семейства Storage Virtualize начиная с версии 8.6.2.0 и выше. Choices: `false` `true`
fromsourcegroup string added in ibm.storage_virtualize 1.9.0	Указывает родительскую группу томов снимка. Используется для предварительного заполнения нового тома в новой группе томов. Действительно при создании доступной хосту группы томов из существующего снимка.
fromsourcevolumes string added in ibm.storage_virtualize 2.3.0	Указывает разделенный двоеточием список родительских томов. В сочетании с параметром type и снимком это позволяет пользователю создавать группу томов с подмножеством томов, образ которых присутствует в снимке. Применяется, когда state=present для создания клона группы томов или тонкого клона из подмножества томов снимка. Поддерживается системами семейства Storage Virtualize начиная с версии 8.6.2.0 и выше.
ignoreuserfcmaps string added in ibm.storage_virtualize 1.10.0	Позволяет пользователю создавать снимки через планировщик или вручную с помощью `addsnapshot`. Это можно использовать только в том случае, если том в группе томов используется в качестве источника сопоставления FlashCopy устаревшего пользователя. Действительно при создании и обновлении группы томов. Поддерживается системами семейства Storage Virtualize 8.5.2.0 и выше. Choices: `"yes"` `"no"`
iogrp string added in ibm.storage_virtualize 1.9.0	Указывает группу ввода-вывода для новых томов. Действительно при создании доступной хосту группы томов из существующего снимка.
log_path string	Путь к файлу журнала отладки.
name string / required	Указывает имя для группы томов.
noownershipgroup boolean	Если указано `True`, объект удаляется из группы владельцев, к которой он принадлежит. Параметры ownershipgroup и noownershipgroup являются взаимоисключающими. Применяется, когда state=present для изменения существующей группы томов. Choices: `false` `true`
nopartition boolean added in ibm.storage_virtualize 2.1.0	Если указано `True`, удаляет группу томов из раздела хранилища. Параметры partition и nopartition являются взаимоисключающими. Применяется, когда state=present для изменения существующей группы томов. Поддерживается системами семейства Storage Virtualize 8.6.1.0 и выше. Choices: `false` `true`
noreplicationpolicy boolean added in ibm.storage_virtualize 1.10.0	Если указано `True`, удаляет политику репликации, назначенную группе томов. Параметры replicationpolicy и noreplicationpolicy являются взаимоисключающими. Применяется, когда state=present для изменения существующей группы томов. Поддерживается системами семейства Storage Virtualize 8.5.2.1 и выше. Choices: `false` `true`
nosafeguardpolicy boolean	Если указано `True`, удаляет политику защиты, назначенную группе томов. Параметры safeguardpolicyname и nosafeguardpolicy являются взаимоисключающими. Применяется, когда state=present для изменения существующей группы томов. Choices: `false` `true`
nosnapshotpolicy boolean added in ibm.storage_virtualize 1.9.0	Если указано `True`, удаляет политику снимков, назначенную группе томов. Параметры snapshotpolicy и nosnapshotpolicy являются взаимоисключающими. Применяется, когда state=present для изменения существующей группы томов. Choices: `false` `true`

old_name string added in ibm.storage_virtualize 2.0.0	Указывает старое имя группы томов при переименовании. Действительно, когда state=present, для переименования существующей группы томов.
ownershipgroup string	Указывает имя группы владельцев, к которой добавляется объект. ownershipgroup взаимоисключает параметры safeguardpolicyname и noownershipgroup. Применяется, когда state=present.
partition string added in ibm.storage_virtualize 2.1.0	Указывает имя раздела хранилища, который будет назначен группе томов. Применяется, когда state=present. Поддерживается системами семейства Storage Virtualize версии 8.6.1.0 и выше.
password string	Пароль REST API для системы Storage Virtualize. Параметры username и password обязательны, если для аутентификации пользователя не используется token.
policystarttime string	Указывает время, когда должна быть сделана первая защищенная резервная копия. Этот параметр также может быть связан с политикой снимков. safeguardpolicyname обязателен при использовании policystarttime. Принимаемый формат - YYMMDDHHMM. Применяется, когда state=present.
pool string added in ibm.storage_virtualize 1.9.0	Указывает имя пула, в котором должны быть созданы целевые тома. Действительно при создании группы томов, доступных хосту, из существующего снимка.
replicationpolicy string added in ibm.storage_virtualize 1.10.0	Указывает имя политики репликации, которая будет назначена группе томов. Применяется, когда state=present. Поддерживается системами семейства Storage Virtualize версии 8.5.2.1 и выше.
safeguarded boolean added in ibm.storage_virtualize 1.10.0	Если указано, политика снимков создает защищенные снимки. Должно быть указано вместе с snapshotpolicy. Действительно при создании и обновлении группы томов. Поддерживается системами семейства Storage Virtualize версии 8.5.2.0 и выше. Choices: `false` ← (default) `true`
safeguardpolicyname string	Имя политики защиты, которая будет назначена группе томов. safeguardpolicyname взаимоисключает параметры nosafeguardpolicy и ownershipgroup. Применяется, когда state=present.
snapshot string added in ibm.storage_virtualize 1.9.0	Указывает имя снимка, используемого для предварительного заполнения новых томов в новой группе томов. Обязательно при создании группы томов, доступных хосту, из существующего снимка.
snapshotpolicy string added in ibm.storage_virtualize 1.9.0	Имя политики снимков, которая будет назначена группе томов. snapshotpolicy взаимоисключает параметры nosnapshotpolicy и ownershipgroup. Применяется, когда state=present.
snapshotpolicysuspended string added in ibm.storage_virtualize 1.9.0	Указывает, следует ли приостановить (`yes`) или возобновить (`no`) политику снимков для этой группы томов. Применяется, когда state=present для изменения существующей группы томов. Choices: `"yes"` `"no"`
state string / required	Создает или обновляет (`present`) или удаляет (`absent`) группу томов. Choices: `"absent"` `"present"`
token string	Маркер аутентификации для проверки пользователя в системе Storage Virtualize. Для генерации маркера используйте модуль ibm.storage_virtualize.ibm_svc_auth.
type string added in ibm.storage_virtualize 1.9.0	Указывает тип группы томов, которая будет создана из снимка. Действительно при создании группы томов, доступных хосту, из существующего снимка. Choices: `"clone"` `"thinclone"`
username string	Имя пользователя REST API для системы Storage Virtualize. Параметры username и password обязательны, если для аутентификации пользователя не используется token.
validate_certs boolean	Проверяет сертификат. Choices: `false` ← (default) `true`

Примечания

Примечание

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

Примеры

- 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: 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

Авторы

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

Ссылки на сборник

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ibm/storage_virtualize/ibm_svc_manage_volumegroup_module.html