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

Примечание

Этот модуль входит в коллекцию dellemc.unity (версия 2.1.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 версии 5.3 или более поздней.
Ansible-core версии 2.17 или более поздней.
Python 3.11, 3.12 или 3.13.
Storops Python SDK 1.2.12.

Параметры

Параметр	Комментарии
advanced_dedup boolean	Логическая переменная, указывающая, следует ли включить расширенную дедупликацию. Для включения расширенной дедупликации необходимо включить сжатие. Её можно включить только на высокопроизводительных системах хранения All Flash. Дедуплицированные данные останутся без изменений даже после отключения расширенной дедупликации. Допустимые значения: `false` `true`
cap_unit string	Единица измерения размера тома. Если не указана, по умолчанию используется `GB`. Допустимые значения: `"GB"` `"TB"`
compression boolean	Логическая переменная, указывающая, следует ли включить сжатие. Сжатие поддерживается только для тонких томов. Допустимые значения: `false` `true`
description string	Описание тома. Описание можно удалить, передав пустую строку («»).
hlu integer	Номер логического устройства узла (HLU), используемый для сопоставления или отмены сопоставления этого тома. Это необязательный параметр. hlu можно указать вместе с host_name или host_id и mapping_state. Если hlu не указан, Unity выберет его автоматически. Максимальное поддерживаемое значение — `255`.
host_id string	Идентификатор узла, для которого выполняется сопоставление или отмена сопоставления с этим томом. В одной задаче вместе с mapping_state можно указать либо host_name, либо host_id.
host_name string	Имя узла, для которого выполняется сопоставление или отмена сопоставления с этим томом. В одной задаче вместе с mapping_state можно указать либо host_name, либо host_id.
hosts list / elements=dictionary	Имена узлов для сопоставления с томом.
hlu string	Номер логического устройства узла (HLU), используемый для сопоставления или отмены сопоставления этого тома. Это необязательный параметр. 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-адрес или полное доменное имя сервера управления Unity.
username string / обязательный	Имя пользователя сервера управления Unity.
validate_certs псевдонимы: verifycert boolean	Логическая переменная, определяющая, следует ли проверять сертификат SSL. `true` — указывает, что сертификат SSL необходимо проверить. `false` — указывает, что сертификат SSL проверять не следует. Допустимые значения: `false` `true` ← (по умолчанию)
vol_id string	Идентификатор тома. Можно использовать только для получения сведений, изменения, сопоставления или отмены сопоставления с узлом, а также удаления.
vol_name string	Имя тома. Обязательно только для операции создания.

Примечания

Примечание

Режим check_mode не поддерживается.
Модули этой коллекции под названием «dellemc.unity» предназначены для поддержки платформы хранения Dell Unity.

Примеры

- name: Create Volume
  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
  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
  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
  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
  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
  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
  volume:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    vol_name: "{{vol_name}}"
    state: "{{state_absent}}"

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

Возвращаемые значения

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

Ключ	Описание
changed boolean	Указывает, был ли изменён ресурс. Возвращается: всегда Пример: `true`
volume_details dictionary	Сведения о томе. Возвращается: если том существует Пример: {"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 string	Текущий процессор хранения данных для этого тома. Возвращается: при успешном выполнении
description string	Описание тома. Возвращается: при успешном выполнении
host_access list / elements=string	Узел, сопоставленный с этим томом. Возвращается: при успешном выполнении
id string	Идентификатор тома, созданный системой. Возвращается: при успешном выполнении
io_limit_policy dictionary	Политика ограничения ввода-вывода, связанная с этим томом. Возвращается: при успешном выполнении
is_data_reduction_enabled boolean	Указывает, включено ли сжатие для этого тома. Возвращается: при успешном выполнении
is_thin_enabled boolean	Указывает, включено ли для этого тома тонкое выделение ресурсов. Возвращается: при успешном выполнении
name string	Имя тома. Возвращается: при успешном выполнении
pool dictionary	Пул, в котором размещён этот том. Возвращается: при успешном выполнении
size_total_with_unit string	Размер тома с указанием фактической единицы измерения. Возвращается: при успешном выполнении
snap_schedule dictionary	Расписание создания снимков, применённое к этому тому. Возвращается: при успешном выполнении
tiering_policy string	Политика распределения по уровням хранения, применённая к этому тому. Возвращается: при успешном выполнении
wwn string	Глобальное имя (WWN) этого тома. Возвращается: при успешном выполнении

Авторы

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

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

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