Spec-Zone.ru › Ansible

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

Примечание

Этот модуль является частью коллекции dellemc.unity (версия 2.0.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.1 или более поздней.
  • Ansible-core версии 2.14 или более поздней.
  • Python 3.9, 3.10 или 3.11.
  • Storops Python SDK версии 1.2.11.
END_OF_DOCUMENT_MARKER

Параметры

Параметр

Комментарии

alert_threshold

целое число

Пороговое значение, при котором система будет генерировать оповещения о свободном пространстве в пуле, заданное в процентах.

Минимальное значение порога — 50.

Максимальное значение порога — 84.

fast_cache

строка

Указывает, включен ли быстрый кэш для хранилища.

Enabled — Быстрый кэш включен для пула.

Disabled — Быстрый кэш выключен для пула.

Варианты:

  • "enabled"
  • "disabled"

fast_vp

строка

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

Enabled — Запланированные перемещения данных для пула включены.

Disabled — Запланированные перемещения данных для пула выключены.

Варианты:

  • "enabled"
  • "disabled"

is_harvest_enabled

булево

Включить/выключить автоматическое удаление снимков на основе использования дискового пространства пула.

Варианты:

  • false
  • true

is_snap_harvest_enabled

булево

Включить/выключить автоматическое удаление снимков на основе использования дискового пространства пула.

Варианты:

  • false
  • true

new_pool_name

строка

Новое имя хранилища, уникальное в системе хранения.

password

строка / обязательно

Пароль сервера управления Unity.

pool_description

строка

Описание хранилища.

pool_harvest_high_threshold

вещественное число

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

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

Минимальное значение максимального порога сбора урожая для пула — 1.

Максимальное значение максимального порога сбора урожая для пула — 99.

pool_harvest_low_threshold

вещественное число

Минимальный порог использования пространства в пуле, при достижении которого система автоматически прекращает удаление снимков в пуле.

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

Минимальное значение порога сбора урожая для пула — 0.

Максимальное значение порога сбора урожая для пула — 98.

pool_id

строка

Уникальный идентификатор экземпляра пула.

pool_name

строка

Имя хранилища, уникальное в системе хранения.

pool_type

строка

Указывает тип хранилища.

Варианты:

  • "TRADITIONAL"
  • "DYNAMIC"

port

целое число

Номер порта, через который происходит общение с сервером управления Unity.

По умолчанию: 443

raid_groups

словарь

Параметры для создания группы RAID из дисков и добавления её в пул.

disk_group_id

строка

Идентификатор группы дисков.

disk_num

целое число

Количество дисков.

raid_type

строка

Типы групп RAID или уровни RAID.

Варианты:

  • "None"
  • "RAID5"
  • "RAID0"
  • "RAID1"
  • "RAID3"
  • "RAID10"
  • "RAID6"
  • "Mixed"
  • "Automatic"

stripe_width

строка

Ширина полос группы RAID, включая диски четности или зеркалирования.

Варианты:

  • "BEST_FIT"
  • "2"
  • "4"
  • "5"
  • "6"
  • "8"
  • "9"
  • "10"
  • "12"
  • "13"
  • "14"
  • "16"

snap_harvest_high_threshold

вещественное число

Максимальный порог использования места в снимке, при превышении которого система автоматически начинает удалять снимки в пуле.

Применяется, когда автоматическое удаление снимков на основе использования пространства пула включено для пула.

Минимальное значение максимального порога сбора урожая снимков — 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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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

словарь

Детали пула хранилища.

Возвращаемое значение: при существовании пула хранилища.

Пример: {"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

список / элементы=строка

Информация об устройствах, связанных с пулом хранилища.

Возвращаемое значение: успех

disk_technology

строка

Тип технологии диска.

Возвращаемое значение: успех

id

строка

Уникальный идентификатор диска.

Возвращаемое значение: успех

name

строка

Название диска.

Возвращаемое значение: успех

size

строка

Размер диска.

Возвращаемое значение: успех

tier_type

строка

Тип уровня диска.

Возвращаемое значение: успех

id

строка

Идентификатор пула, уникальный идентификатор пула.

Возвращаемое значение: успех

is_fast_cache_enabled

boolean

Указывает, включен ли быстрый кэш для пула хранилища. true — быстрый кэш включен для пула, false — быстрый кэш выключен для пула.

Возвращаемое значение: успех

is_fast_vp_enabled

boolean

Указывает, нужно ли включить запланированные перемещения данных для пула хранилища. true — запланированные перемещения данных включены для пула, false — запланированные перемещения данных выключены для пула.

Возвращаемое значение: успех

name

строка

Имя пула, уникальное в системе хранения.

Возвращаемое значение: успех

size_free_with_unit

строка

Свободный размер с соответствующей единицей измерения в удобочитаемой форме.

Возвращаемое значение: успех

size_subscribed_with_unit

строка

Подписанный размер с соответствующей единицей измерения в удобочитаемой форме.

Возвращаемое значение: успех

size_total_with_unit

строка

Общий размер с соответствующей единицей измерения в удобочитаемой форме.

Возвращаемое значение: успех

size_used_with_unit

строка

Используемый размер с соответствующей единицей измерения в удобочитаемой форме.

Возвращаемое значение: успех

snap_size_subscribed_with_unit

строка

Подписанный размер снимков с соответствующей единицей измерения в удобочитаемой форме.

Возвращаемое значение: успех

snap_size_used_with_unit

строка

Используемый размер снимков с соответствующей единицей измерения в удобочитаемой форме.

Возвращаемое значение: успех

Авторы

  • Ambuj Dubey (@AmbujDube)

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

  • Система отслеживания ошибок
  • Репозиторий (исходный код)

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

Spec-Zone.ru

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