Spec-Zone.ru › Ansible

Модуль netapp_eseries.santricity.na_santricity_storagepool — управление группами томов и дисковыми пулами NetApp E-Series

Примечание

Этот модуль входит в коллекцию netapp_eseries.santricity (версия 1.4.1).

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

Чтобы установить её, используйте: ansible-galaxy collection install netapp_eseries.santricity.

Чтобы использовать её в плейбуке, укажите: netapp_eseries.santricity.na_santricity_storagepool.

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

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

  • Создание и удаление групп томов и дисковых пулов для систем хранения NetApp E-Series.

Параметры

Параметр

Комментарии

api_password

string / обязательный

Пароль для аутентификации в прокси-сервере SANtricity Web Services Proxy или API Embedded Web Services.

api_url

string / обязательный

URL прокси-сервера SANtricity Web Services Proxy или API Embedded Web Services.

Пример: https://prod-1.wahoo.acme.com:8443/devmgr/v2

api_username

string / обязательный

Имя пользователя для аутентификации в прокси-сервере SANtricity Web Services Proxy или API Embedded Web Services.

criteria_drive_count

integer

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

Если state==”present”, необходимо указать criteria_drive_count или criteria_min_usable_capacity.

Пул будет расширен, если это число превышает количество уже установленных дисков (см. примечание о расширении ниже).

criteria_drive_interface_type

string

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

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

Варианты:

  • "scsi"
  • "fibre"
  • "sata"
  • "pata"
  • "fibre520b"
  • "sas"
  • "sas4k"
  • "nvme4k"

criteria_drive_max_size

float

Максимальный размер отдельного диска (в единицах size_unit), учитываемый при выборе дисков для пула хранения.

criteria_drive_min_size

float

Минимальный размер отдельного диска (в единицах size_unit), учитываемый при выборе дисков для пула хранения.

criteria_drive_require_da

boolean

Гарантирует, что пул хранения будет создан только на дисках с поддержкой Data Assurance (DA).

Доступно только для новых пулов хранения; существующие пулы хранения нельзя преобразовать.

Варианты:

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

criteria_drive_require_fde

boolean

Требуется ли поддержка полного шифрования диска для дисков, добавляемых в пул хранения.

Варианты:

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

criteria_drive_type

string

Тип диска (hdd или ssd), используемый при поиске подходящих дисков.

Если значение не указано, будет проверяться каждый тип диска — начиная с наиболее распространённого — до обнаружения подходящих дисков.

Варианты:

  • "hdd"
  • "ssd"

criteria_min_usable_capacity

float

Минимальный размер пула хранения (в единицах size_unit).

Если state==”present”, необходимо указать criteria_drive_count или criteria_min_usable_capacity.

Пул будет расширен, если это значение превышает его текущий размер. (См. примечание о расширении ниже.)

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

criteria_size_unit

string

Единица измерения для параметров размера.

Варианты:

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

ddp_critical_threshold_pct

integer

Выдаёт критическое предупреждение при достижении порога выделенного пространства хранения.

Применяется только при raid_level==”raidDiskPool”.

Установите ddp_critical_threshold_pct==0, чтобы отключить предупреждение.

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

ddp_warning_threshold_pct

integer

Выдаёт предупреждение при достижении порога выделенного пространства хранения.

Применяется только при raid_level==”raidDiskPool”.

Установите ddp_warning_threshold_pct==0, чтобы отключить предупреждение.

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

erase_secured_drives

boolean

Если state==”absent”, будут очищены все диски пула хранения.

Если state==”present”, будут удалены все доступные диски массива хранения с включённой функцией безопасности.

Варианты:

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

name

string / обязательный

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

raid_level

string

Уровень RAID создаваемого пула хранения.

Обязателен только при state==”present”.

При raid_level==”raidDiskPool” требуется criteria_drive_count >= 10 or criteria_drive_count >= 11 в зависимости от спецификаций массива хранения.

При raid_level==”raid0” требуется 1<=criteria_drive_count.

При raid_level==”raid1” требуется 2<=criteria_drive_count.

При raid_level==”raid3” требуется 3<=criteria_drive_count<=30.

При raid_level==”raid5” требуется 3<=criteria_drive_count<=30.

При raid_level==”raid6” требуется 5<=criteria_drive_count<=30.

Обратите внимание: raidAll будет считаться raidDiskPool, а raid3 — raid5.

Варианты:

  • "raidAll"
  • "raid0"
  • "raid1"
  • "raid3"
  • "raid5"
  • "raid6"
  • "raidDiskPool" ← (по умолчанию)

remove_volumes

boolean

Перед удалением пула хранения удалить все тома в нём.

Варианты:

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

reserve_drive_count

integer

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

Допустимо только для дисковых пулов RAID.

secure_pool

boolean

Включает функцию защиты данных в состоянии покоя для пула хранения.

Работает только в том случае, если все диски в пуле поддерживают защиту (FDE, FIPS или смешанный вариант).

Предупреждение: после включения защиты её невозможно отключить без очистки дисков.

Варианты:

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

ssid

string

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

По умолчанию: "1"

state

string

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

Обратите внимание: для удаления пула хранения в настоящее время сначала требуется удалить все созданные тома.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

usable_drives

string

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

Каждый диск указывается в формате <номер_лотка>:<(необязательно) номер_отсека>:<номер_слота_диска> (например, 99:0 — это слот диска 0 базового лотка).

Идентификатор базового лотка по умолчанию — 99; лотки расширения добавляются в порядке подключения, но пользователь может изменить эти идентификаторы.

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

Если usable_drives не задан, подходящие диски выберет система хранения.

validate_certs

boolean

Следует ли проверять сертификаты HTTPS?

Варианты:

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

Примечания

Примечание

  • Операции расширения выполняются в неблокирующем режиме из-за длительного времени, необходимого для расширения групп томов.
  • Традиционные группы томов (raid0, raid1, raid5, raid6) создаются поэтапно, согласно требованиям массива хранения. Будет предпринята попытка выполнить каждый необходимый шаг, пока запрос не завершится ошибкой, что, вероятно, произойдёт из-за времени, требуемого для расширения.
  • raidUnsupported будет считаться raid0, raidAll — raidDiskPool, а raid3 — raid5.
  • По возможности будет выбрана защита от потери лотка и от потери отсека.
  • Для работы модулей E-Series Ansible требуется либо экземпляр Web Services Proxy (WSP), доступный для управления системой хранения, либо система хранения E-Series с поддержкой API Embedded Web Services.
  • Embedded Web Services в настоящее время доступен на моделях E2800, E5700, EF570 и более новых моделях оборудования.
  • Для настройки систем, управляемых экземпляром WSP, можно использовать netapp_eseries.santricity.netapp_e_storage_system.

Примеры

- name: No disk groups
  na_santricity_storagepool:
    ssid: "{{ ssid }}"
    name: "{{ item }}"
    state: absent
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"

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

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

Ключ

Описание

msg

string

Сообщение об успешном выполнении

Возвращается: при успехе

Пример: "Json facts for the pool that was created."

Авторы

  • Nathan Swartz (@swartzn)
  • Vu Tran (@VuTran007)

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

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

© 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/netapp_eseries/santricity/na_santricity_storagepool_module.html

Spec-Zone.ru

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