Spec-Zone.ru › Ansible

Модуль ibm.storage_virtualize.ibm_svc_manage_volume – Этот модуль управляет стандартными томами на системах семейства 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_volume.

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

  • Описание
  • Параметры
  • Примечания
  • Примеры

Описание

  • Интерфейс Ansible для управления командами томов «mkvolume», «rmvolume» и «chvdisk».

Параметры

Параметр

Комментарии

allow_hs

boolean

added in ibm.storage_virtualize 2.0.0

Если указано `True`, управляет томом hyperswap, игнорируя проверку типа тома.

Допустимо, когда state=present, для изменения существующего тома.

Варианты:

  • false ← (default)
  • true

buffersize

string

Указывает емкость пула, которую том будет резервировать в качестве буфера для томов с тонкой провизионированием и сжатых томов.

Для использования этого параметра необходимо указать параметр ‘thin’ или ‘compressed’.

Размер буфера по умолчанию составляет 2%.

thin или compressed требуется при использовании buffersize.

Допустимо, когда state=present, для создания тома.

cloud_account_name

string

added in ibm.storage_virtualize 1.11.0

Указывает имя облачного аккаунта.

Допустимо, когда enable_cloud_snapshot=true.

clustername

string / required

Имя хоста или IP-адрес управления системы Storage Virtualize.

compressed

boolean

Указывает, что необходимо создать сжатый том.

Параметры ‘compressed’ и ‘thin’ являются взаимоисключающими.

Допустимо, когда state=present, для создания сжатого тома.

Варианты:

  • false
  • true

deduplicated

boolean

Указывает, что необходимо создать том с дедупликацией.

Требуется, когда state=present, для создания тома с дедупликацией.

Варианты:

  • false
  • true

domain

string

Домен для системы Storage Virtualize.

Допустимо, когда для параметра clustername используется имя хоста.

enable_cloud_snapshot

boolean

added in ibm.storage_virtualize 1.11.0

Укажите, чтобы включить или отключить облачный снимок.

Допустимо, когда state=present, для изменения существующего тома.

Варианты:

  • false
  • true

fromsourcevolume

string

Указывает имя тома в снимке, используемом для предварительного заполнения тома clone или thinclone.

Допустимо, когда state=present, для создания тома thinclone или clone.

Поддерживается системами семейства Storage Virtualize начиная с версии 8.6.2.0 или более поздней.

iogrp

string

Указывает список имен групп ввода-вывода. Имена групп в списке должны быть разделены запятой.

При создании нового тома первая группа ввода-вывода в списке добавляется как кэшированная и группа доступа ввода-вывода, а остальные группы ввода-вывода добавляются как группы доступа ввода-вывода.

Этот параметр поддерживает функциональность обновления.

Допустимо, когда state=present, для создания или изменения тома.

log_path

string

Путь к файлу отладочного журнала.

name

string / required

Указывает имя, которое нужно присвоить новому тому.

novolumegroup

boolean

Если указано `True`, том удаляется из связанной с ним группы томов.

Параметры ‘novolumegroup’ и ‘volumegroup’ являются взаимоисключающими.

Допустимо, когда state=present, для изменения тома.

Варианты:

  • false
  • true

old_name

string

added in ibm.storage_virtualize 1.9.0

Указывает старое имя тома при переименовании.

Допустимо, когда state=present, для переименования существующего тома.

password

string

Пароль REST API для системы Storage Virtualize.

Параметры username и password являются обязательными, если не используется token для аутентификации пользователя.

pool

string

Указывает имя пула хранения, который нужно использовать при создании тома.

Этот параметр обязателен, когда state=present, для создания тома.

size

string

Определяет размер тома. Этот параметр также может использоваться для изменения размера существующего тома.

Требуется, когда state=present, для создания или изменения тома.

state

string / required

Создает или обновляет (present) или удаляет (absent) том.

Варианты:

  • "absent"
  • "present"

thin

boolean

Указывает, что необходимо создать тонкоразмеренный том.

Параметры ‘thin’ и ‘compressed’ взаимоисключающие.

Допустимо при state=present для создания тонкоразмерного тома.

Варианты:

  • false
  • true

token

string

Токен аутентификации для проверки пользователя в системе Storage Virtualize.

Для генерации токена используйте модуль ibm_svc_auth.

type

string

Определяет тип создаваемого тома. Том может быть типа thinclone или clone.

Допустимо при state=present для создания тома типа thinclone или clone.

Поддерживается системами Storage Virtualize семейства с версии 8.6.2.0 или более поздней.

Варианты:

  • "thinclone"
  • "clone"

unit

string

Указывает единицы измерения данных для емкости, указанной параметром ‘size’.

size требуется при использовании unit.

Варианты:

  • "b"
  • "kb"
  • "mb" ← (по умолчанию)
  • "gb"
  • "tb"
  • "pb"

username

string

Имя пользователя REST API для системы Storage Virtualize.

Параметры username и password требуются, если не используется token для аутентификации пользователя.

validate_certs

boolean

Проверяет сертификаты.

Варианты:

  • false ← (по умолчанию)
  • true

volumegroup

string

Указывает имя группы томов, к которой должен быть добавлен том.

Параметры ‘volumegroup’ и ‘novolumegroup’ взаимоисключающие.

Допустимо при state=present для создания или изменения тома.

Примечания

Примечание

  • Этот модуль поддерживает check_mode.

Примеры

- 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_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "vol1_thinclone"
    fromsourcevolume: "vol1"
    state: "present"
    pool: "pool0"
- name: Create clone volume from volume vol1
  ibm_svc_manage_volume:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    name: "vol1_clone"
    fromsourcevolume: "vol1"
    state: "present"
    pool: "pool0"
- 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"
    size: "1"
    unit: "gb"
    iogrp: "io_grp0, iogrp1"
- 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: 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"

Авторы

  • Sreshtant Bohidar(@Sreshtant-Bohidar)

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

  • Трекер задач
  • Репозиторий (исходные коды)
  • Сообщить об ошибке

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API