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

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: dellemc.unity.storagepool.

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

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

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

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

Требования

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

Устройство Dell Unity Storage версии 5.3 или новее.
Ansible-core 2.17 или новее.
Python 3.11, 3.12 или 3.13.
Python SDK Storops 1.2.12.

Параметры

Параметр	Комментарии
alert_threshold integer	Пороговое значение в процентах, при достижении которого система будет отправлять оповещения о свободном пространстве в пуле. Минимальное значение порога — 50. Максимальное значение порога — 84.
fast_cache string	Указывает, включен ли FAST Cache для пула хранения. `Enabled` — FAST Cache включен для пула. `Disabled` — FAST Cache отключен для пула. Допустимые значения: `"enabled"` `"disabled"`
fast_vp string	Указывает, следует ли включить запланированное перемещение данных для пула. `Enabled` — запланированное перемещение данных для пула включено. `Disabled` — запланированное перемещение данных для пула отключено. Допустимые значения: `"enabled"` `"disabled"`
is_harvest_enabled boolean	Включить или отключить автоматическое удаление снимков на основе использования пространства пула. Допустимые значения: `false` `true`
is_snap_harvest_enabled boolean	Включить или отключить автоматическое удаление снимков на основе использования пространства пула. Допустимые значения: `false` `true`
new_pool_name string	Новое имя пула хранения, уникальное в системе хранения.
password string / обязательно	Пароль сервера управления Unity.
pool_description string	Описание пула хранения.
pool_harvest_high_threshold float	Максимальный порог использования пространства пула, при превышении которого система автоматически начинает удалять снимки в пуле. Применяется, если в системе и пуле включено автоматическое удаление снимков на основе использования пространства пула. Минимальное значение верхнего порога очистки пула — 1. Максимальное значение верхнего порога очистки пула — 99.
pool_harvest_low_threshold float	Минимальный порог использования пространства пула, ниже которого система автоматически прекращает удаление снимков в пуле. Применяется, если в системе и пуле включено автоматическое удаление снимков на основе использования пространства пула. Минимальное значение нижнего порога очистки пула — 0. Максимальное значение нижнего порога очистки пула — 98.
pool_id string	Уникальный идентификатор экземпляра пула.
pool_name string	Имя пула хранения, уникальное в системе хранения.
pool_type string	Тип пула хранения. Допустимые значения: `"TRADITIONAL"` `"DYNAMIC"`
port integer	Номер порта для связи с сервером управления Unity. По умолчанию: `443`
raid_groups dictionary	Параметры создания группы RAID из дисков и добавления ее в пул.
disk_group_id string	Идентификатор группы дисков.
disk_num integer	Количество дисков.
raid_type string	Типы групп RAID или уровни RAID. Допустимые значения: `"None"` `"RAID5"` `"RAID0"` `"RAID1"` `"RAID3"` `"RAID10"` `"RAID6"` `"Mixed"` `"Automatic"`
stripe_width string	Ширина полосы группы RAID, включая диски четности или зеркалирования. Допустимые значения: `"BEST_FIT"` `"2"` `"4"` `"5"` `"6"` `"8"` `"9"` `"10"` `"12"` `"13"` `"14"` `"16"`
snap_harvest_high_threshold float	Максимальный порог использования пространства снимками, при превышении которого система автоматически начинает удалять снимки в пуле. Применяется, если для пула включено автоматическое удаление снимков на основе использования пространства пула. Минимальное значение верхнего порога очистки снимков — 1. Максимальное значение верхнего порога очистки снимков — 99.
snap_harvest_low_threshold float	Минимальный порог использования пространства снимками, ниже которого система прекращает автоматическое удаление снимков в пуле. Применяется, если для пула включено автоматическое удаление снимков на основе использования пространства пула. Минимальное значение нижнего порога очистки снимков — 0. Максимальное значение нижнего порога очистки снимков — 98.
state string / обязательно	Указывает, должен ли пул хранения существовать. `Present` — указывает, что пул хранения должен существовать в системе. `Absent` — указывает, что пул хранения не должен существовать в системе. Допустимые значения: `"absent"` `"present"`
unispherehost string / обязательно	IP-адрес или FQDN сервера управления Unity.
username string / обязательно	Имя пользователя сервера управления Unity.
validate_certs псевдонимы: verifycert boolean	Логическая переменная, указывающая, нужно ли проверять сертификат SSL. `true` — указывает, что сертификат SSL следует проверять. `false` — указывает, что сертификат SSL проверять не следует. Допустимые значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Get Storage pool details using pool_name
  storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_name: "{{pool_name}}"
    state: "present"

- name: Get Storage pool details using pool_id
  storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_id: "{{pool_id}}"
    state: "present"

- name: Modify Storage pool attributes using pool_name
  storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_name: "{{pool_name}}"
    new_pool_name: "{{new_pool_name}}"
    pool_description: "{{pool_description}}"
    fast_cache: "{{fast_cache_enabled}}"
    fast_vp: "{{fast_vp_enabled}}"
    state: "present"

- name: Modify Storage pool attributes using pool_id
  storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_id: "{{pool_id}}"
    new_pool_name: "{{new_pool_name}}"
    pool_description: "{{pool_description}}"
    fast_cache: "{{fast_cache_enabled}}"
    fast_vp: "{{fast_vp_enabled}}"
    state: "present"

- name: Create a StoragePool
  storagepool:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    pool_name: "Test"
    pool_description: "test pool"
    raid_groups:
      disk_group_id: "dg_16"
      disk_num: 2
      raid_type: "RAID10"
      stripe_width: "BEST_FIT"
    alert_threshold: 50
    is_harvest_enabled: true
    pool_harvest_high_threshold: 60
    pool_harvest_low_threshold: 40
    is_snap_harvest_enabled: true
    snap_harvest_high_threshold: 70
    snap_harvest_low_threshold: 50
    fast_vp: "enabled"
    fast_cache: "enabled"
    pool_type: "DYNAMIC"
    state: "present"

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

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

Ключ	Описание
changed boolean	Изменился ли пул хранения. Возвращается: всегда Пример: `true`
storage_pool_details dictionary	Сведения о пуле хранения. Возвращается: если пул хранения существует. Пример: {"alert_threshold": 50, "creation_time": "2022-03-08 14:05:32+00:00", "description": "", "drives": [{"disk_technology": "SAS", "id": "dpe_disk_22", "name": "DPE Drive 22", "size": 590860984320, "tier_type": "PERFORMANCE"}, {"disk_technology": "SAS", "id": "dpe_disk_23", "name": "DPE Drive 23", "size": 590860984320, "tier_type": "PERFORMANCE"}, {"disk_technology": "SAS", "id": "dpe_disk_24", "name": "DPE Drive 24", "size": 590860984320, "tier_type": "PERFORMANCE"}], "existed": true, "harvest_state": "UsageHarvestStateEnum.IDLE", "hash": 8744642897210, "health": {"UnityHealth": {"hash": 8744642799842}}, "id": "pool_280", "is_all_flash": false, "is_empty": false, "is_fast_cache_enabled": false, "is_fast_vp_enabled": false, "is_harvest_enabled": true, "is_snap_harvest_enabled": true, "metadata_size_subscribed": 105763569664, "metadata_size_used": 57176752128, "name": "test_pool", "object_id": 12884902146, "pool_fast_vp": {"UnityPoolFastVp": {"hash": 8744647518980}}, "pool_space_harvest_high_threshold": 59.0, "pool_space_harvest_low_threshold": 40.0, "pool_type": "StoragePoolTypeEnum.DYNAMIC", "raid_type": "RaidTypeEnum.RAID10", "rebalance_progress": null, "size_free": 470030483456, "size_free_with_unit": "437.75 GB", "size_subscribed": 447215820800, "size_subscribed_with_unit": "416.5 GB", "size_total": 574720311296, "size_total_with_unit": "535.25 GB", "size_used": 76838068224, "size_used_with_unit": "71.56 GB", "snap_size_subscribed": 128851369984, "snap_size_subscribed_with_unit": "120.0 GB", "snap_size_used": 2351104, "snap_size_used_with_unit": "2.24 MB", "snap_space_harvest_high_threshold": 80.0, "snap_space_harvest_low_threshold": 60.0, "tiers": {"UnityPoolTierList": [{"disk_count": [0, 3, 0], "existed": true, "hash": 8744643017382, "name": ["Extreme Performance", "Performance", "Capacity"], "pool_units": [null, {"UnityPoolUnitList": [{"UnityPoolUnit": {"hash": 8744642786759, "id": "rg_4"}}, {"UnityPoolUnit": {"hash": 8744642786795, "id": "rg_5"}}]}, null], "raid_type": ["RaidTypeEnum.NONE", "RaidTypeEnum.RAID10", "RaidTypeEnum.NONE"], "size_free": [0, 470030483456, 0], "size_moving_down": [0, 0, 0], "size_moving_up": [0, 0, 0], "size_moving_within": [0, 0, 0], "size_total": [0, 574720311296, 0], "size_used": [0, 104689827840, 0], "stripe_width": [null, "RaidStripeWidthEnum._2", null], "tier_type": ["TierTypeEnum.EXTREME_PERFORMANCE", "TierTypeEnum.PERFORMANCE", "TierTypeEnum.CAPACITY"]}]}}
drives list / elements=string	Сведения о дисках, связанных с пулом хранения. Возвращается: при успешном выполнении
disk_technology string	Технология диска. Возвращается: при успешном выполнении
id string	Уникальный идентификатор диска. Возвращается: при успешном выполнении
name string	Имя диска. Возвращается: при успешном выполнении
size string	Размер диска. Возвращается: при успешном выполнении
tier_type string	Тип уровня диска. Возвращается: при успешном выполнении
id string	Идентификатор пула — уникальный идентификатор пула. Возвращается: при успешном выполнении
is_fast_cache_enabled boolean	Указывает, включен ли FAST Cache для пула хранения. true — FAST Cache включен для пула. false — FAST Cache отключен для пула. Возвращается: при успешном выполнении
is_fast_vp_enabled boolean	Указывает, включено ли запланированное перемещение данных для пула хранения. true — запланированное перемещение данных для пула включено. false — запланированное перемещение данных для пула отключено. Возвращается: при успешном выполнении
name string	Имя пула, уникальное в системе хранения. Возвращается: при успешном выполнении
size_free_with_unit string	Размер свободного пространства size_free с соответствующей единицей измерения в удобочитаемом формате. Возвращается: при успешном выполнении
size_subscribed_with_unit string	Размер выделенного пространства size_subscribed с соответствующей единицей измерения в удобочитаемом формате. Возвращается: при успешном выполнении
size_total_with_unit string	Общий размер size_total с соответствующей единицей измерения в удобочитаемом формате. Возвращается: при успешном выполнении
size_used_with_unit string	Размер использованного пространства size_used с соответствующей единицей измерения в удобочитаемом формате. Возвращается: при успешном выполнении
snap_size_subscribed_with_unit string	Размер выделенного пространства для снимков snap_size_subscribed с соответствующей единицей измерения в удобочитаемом формате. Возвращается: при успешном выполнении
snap_size_used_with_unit string	Размер использованного снимками пространства snap_size_used с соответствующей единицей измерения в удобочитаемом формате. Возвращается: при успешном выполнении

Авторы

Ambuj Dubey (@AmbujDube)

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

© 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/storagepool_module.html