Модуль dellemc.unity.volume – Управление томом в системе хранения Unity

Примечание

Этот модуль входит в коллекцию dellemc.unity (версия 2.0.0).

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

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

Чтобы использовать его в книге задач, укажите: dellemc.unity.volume.

Добавлен в dellemc.unity 1.1.0

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Управление томом в системе хранения Unity включает: Создание нового тома, Модификацию атрибутов тома, Сопоставление тома с узлом, Отключение тома от узла, Просмотр деталей тома, Удаление тома.

Требования

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

Устройство Dell Unity Storage версии 5.1 или более поздней.
Ansible-core 2.14 или более поздней версии.
Python 3.9, 3.10 или 3.11.
Storops Python SDK 1.2.11.

Параметры

Параметр	Комментарии
advanced_dedup boolean	Булево значение, Указывает, включена ли расширенная дедупликация. Для включения расширенной дедупликации необходимо включить сжатие. Она может быть включена только на платформах all flash high end. Дублированные данные останутся неизменными даже после отключения расширенной дедупликации. Выбори: `false` `true`
cap_unit string	Единица измерения размера тома. По умолчанию `GB`, если не указано. Выбори: `"GB"` `"TB"`
compression boolean	Булево значение, Указывает, включено ли сжатие. Сжатие поддерживается только для тонких томов. Выбори: `false` `true`
description string	Описание тома. Описание можно удалить, передав пустую строку (“”).
hlu integer	Единица LUN хоста, которая должна быть сопоставлена/отсопоставлена с данным томом. Это необязательный параметр; hlu можно указать вместе с host_name или host_id и mapping_state. Если hlu не указан, Unity выберет его автоматически. Максимальное значение, поддерживаемое, `255`.
host_id string	Идентификатор хоста, который должен быть сопоставлен/отсопоставлен с данным томом. В одной задаче можно указать либо host_name, либо host_id вместе с mapping_state.
host_name string	Имя хоста, который должен быть сопоставлен/отсопоставлен с этим томом. В одной задаче можно указать либо host_name, либо host_id вместе с mapping_state.
hosts list / elements=dictionary	Имя хостов для сопоставления с томом.
hlu string	Единица LUN хоста, которая должна быть сопоставлена/отсопоставлена с этим томом. Это необязательный параметр; hlu можно указать вместе с host_name или host_id и mapping_state. Если hlu не указан, Unity выберет его автоматически. Максимальное значение, поддерживаемое, `255`.
host_id string	Идентификатор хоста.
host_name string	Имя хоста.
io_limit_policy string	Политика ограничения ввода-вывода, связанная с этим томом. После ее установки ее нельзя удалить с помощью модуля ansible, но можно изменить.
is_thin boolean	Булево значение, Указывает, является ли это тонким томом. По умолчанию значение `true` , если не указано. Выбори: `false` `true`
mapping_state string	Состояние доступа хоста для тома. Выбори: `"mapped"` `"unmapped"`
new_vol_name string	Новое имя тома для операции переименования.
password string / обязательно	Пароль сервера управления Unity.
pool_id string	Это идентификатор пула, в котором будет создан том. Для создания нового тома необходимо указать либо pool_name, либо pool_id.
pool_name string	Это имя пула, в котором будет создан том. Для создания нового тома необходимо указать либо pool_name, либо pool_id.
port integer	Номер порта, через который происходит общение с сервером управления Unity. По умолчанию: `443`
size integer	Размер тома.
snap_schedule string	Расписание создания снимков, назначенное тому. Добавление/удаление/модификация расписания создания снимков для тома.
sp string	Процессор хранения для этого тома. Выбори: `"SPA"` `"SPB"`

state string / обязательно	Переменная состояния, определяющая, будет ли существовать том. Варианты: `"absent"` `"present"`
tiering_policy string	Варианты политики тиеринга, определяющие, как данные хранилища будут распределяться между доступными уровнями пула. Варианты: `"AUTOTIER_HIGH"` `"AUTOTIER"` `"HIGHEST"` `"LOWEST"`
unispherehost string / обязательно	IP-адрес или FQDN сервера управления Unity.
username string / обязательно	Имя пользователя сервера управления Unity.
validate_certs псевдонимы: verifycert boolean	Булева переменная, указывающая, следует ли проверять сертификат SSL. `true` — указывает, что сертификат SSL должен быть проверен. `false` — указывает, что сертификат SSL проверять не нужно. Варианты: `false` `true` ← (по умолчанию)
vol_id string	Идентификатор тома. Может использоваться только для операций get, modify, map/unmap host или delete.
vol_name string	Имя тома. Обязательно только для операции создания.

Примечания

Примечание

check_mode не поддерживается.
Модули, представленные в этом наборе, с именем ‘dellemc.unity’, разработаны для поддержки платформы хранения Dell Unity.

Примеры

- name: Create Volume
  dellemc.unity.volume:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    vol_name: "{{vol_name}}"
    description: "{{description}}"
    pool_name: "{{pool}}"
    size: 2
    cap_unit: "{{cap_GB}}"
    is_thin: true
    compression: true
    advanced_dedup: true
    state: "{{state_present}}"

- name: Expand Volume by volume id
  dellemc.unity.volume:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    vol_id: "{{vol_id}}"
    size: 5
    cap_unit: "{{cap_GB}}"
    state: "{{state_present}}"

- name: Modify Volume, map host by host_name
  dellemc.unity.volume:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    vol_name: "{{vol_name}}"
    host_name: "{{host_name}}"
    hlu: 5
    mapping_state: "{{state_mapped}}"
    state: "{{state_present}}"

- name: Modify Volume, unmap host mapping by host_name
  dellemc.unity.volume:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    vol_name: "{{vol_name}}"
    host_name: "{{host_name}}"
    mapping_state: "{{state_unmapped}}"
    state: "{{state_present}}"

- name: Map multiple hosts to a Volume
  dellemc.unity.volume:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    vol_id: "{{vol_id}}"
    hosts:
      - host_name: "10.226.198.248"
        hlu: 1
      - host_id: "Host_929"
        hlu: 2
    mapping_state: "mapped"
    state: "present"

- name: Modify Volume attributes
  dellemc.unity.volume:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    vol_name: "{{vol_name}}"
    new_vol_name: "{{new_vol_name}}"
    tiering_policy: "AUTOTIER"
    compression: true
    is_thin: true
    advanced_dedup: true
    state: "{{state_present}}"

- name: Delete Volume by vol name
  dellemc.unity.volume:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    vol_name: "{{vol_name}}"
    state: "{{state_absent}}"

- name: Delete Volume by vol id
  dellemc.unity.volume:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    vol_id: "{{vol_id}}"
    state: "{{state_absent}}"

Значения возврата

Общие значения возврата документированы здесь, следующие — поля, уникальные для этого модуля:

Ключ	Описание
changed boolean	Изменилось ли ресурс. Возвращается: всегда Пример: `true`
volume_details словарь	Детали тома. Возвращается: когда том существует Пример: {"current_node": "NodeEnum.SPB", "data_reduction_percent": 0, "data_reduction_ratio": 1.0, "data_reduction_size_saved": 0, "default_node": "NodeEnum.SPB", "description": null, "effective_io_limit_max_iops": null, "effective_io_limit_max_kbps": null, "existed": true, "family_base_lun": {"UnityLun": {"hash": 8774954523796, "id": "sv_27"}}, "family_clone_count": 0, "hash": 8774954522426, "health": {"UnityHealth": {"hash": 8774954528278}}, "host_access": [{"accessMask": "PRODUCTION", "hlu": 0, "id": "Host_75", "name": "10.226.198.250"}], "id": "sv_27", "io_limit_policy": null, "is_advanced_dedup_enabled": false, "is_compression_enabled": null, "is_data_reduction_enabled": false, "is_replication_destination": false, "is_snap_schedule_paused": false, "is_thin_clone": false, "is_thin_enabled": false, "metadata_size": 4294967296, "metadata_size_allocated": 4026531840, "name": "VSI-UNITY-test-task", "per_tier_size_used": [111400714240, 0, 0], "pool": {"id": "pool_3", "name": "Extreme_Perf_tier"}, "size_allocated": 107374182400, "size_total": 107374182400, "size_total_with_unit": "100.0 GB", "size_used": null, "snap_count": 0, "snap_schedule": null, "snap_wwn": "60:06:01:60:5C:F0:50:00:94:3E:91:4D:51:5A:4F:97", "snaps_size": 0, "snaps_size_allocated": 0, "storage_resource": {"UnityStorageResource": {"hash": 8774954518887}}, "tiering_policy": "TieringPolicyEnum.AUTOTIER_HIGH", "type": "LUNTypeEnum.VMWARE_ISCSI", "wwn": "60:06:01:60:5C:F0:50:00:00:B5:95:61:2E:34:DB:B2"}
current_sp строка	Текущий процессор хранения для данного тома. Возвращается: успех
description строка	Описание тома. Возвращается: успех
host_access список / элементы=строка	Хост, подключенный к этому тому. Возвращается: успех
id строка	Сгенерированный системой идентификатор тома. Возвращается: успех
io_limit_policy словарь	Политика лимитов ввода-вывода, связанная с этим томом. Возвращается: успех
is_data_reduction_enabled boolean	Включена ли компрессия для этого тома. Возвращается: успех
is_thin_enabled boolean	Указание, включена ли тонкая виртуализация для данного тома. Возвращается: успех
name строка	Имя тома. Возвращается: успех
pool словарь	Пул, в котором размещен данный том. Возвращается: успех
size_total_with_unit строка	Размер тома с единицей измерения. Возвращается: успех
snap_schedule словарь	Расписание создания моментальных снимков для данного тома. Возвращается: успех
tiering_policy строка	Политика тиеринга, применённая к этому тому. Возвращается: успех
wwn строка	Глобальный идентификатор (WWN) этого тома. Возвращается: успех

Авторы

Arindam Datta (@arindam-emc)
Pavan Mudunuri(@Pavan-Mudunuri)

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

© 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/dellemc/unity/volume_module.html