Модуль 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. |
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 | Тип интерфейса, используемый при выборе дисков для пула хранения. Если значение не указано, будут учитываться все типы интерфейсов. Варианты:
|
criteria_drive_max_size float | Максимальный размер отдельного диска (в единицах size_unit), учитываемый при выборе дисков для пула хранения. |
criteria_drive_min_size float | Минимальный размер отдельного диска (в единицах size_unit), учитываемый при выборе дисков для пула хранения. |
criteria_drive_require_da boolean | Гарантирует, что пул хранения будет создан только на дисках с поддержкой Data Assurance (DA). Доступно только для новых пулов хранения; существующие пулы хранения нельзя преобразовать. Варианты:
|
criteria_drive_require_fde boolean | Требуется ли поддержка полного шифрования диска для дисков, добавляемых в пул хранения. Варианты:
|
criteria_drive_type string | Тип диска (hdd или ssd), используемый при поиске подходящих дисков. Если значение не указано, будет проверяться каждый тип диска — начиная с наиболее распространённого — до обнаружения подходящих дисков. Варианты:
|
criteria_min_usable_capacity float | Минимальный размер пула хранения (в единицах size_unit). Если state==”present”, необходимо указать criteria_drive_count или criteria_min_usable_capacity. Пул будет расширен, если это значение превышает его текущий размер. (См. примечание о расширении ниже.) Не используйте этот параметр, если система хранения содержит диски разных типов и указан usable_drives, поскольку доступная ёмкость может быть рассчитана неточно. |
criteria_size_unit string | Единица измерения для параметров размера. Варианты:
|
ddp_critical_threshold_pct integer | Выдаёт критическое предупреждение при достижении порога выделенного пространства хранения. Применяется только при raid_level==”raidDiskPool”. Установите ddp_critical_threshold_pct==0, чтобы отключить предупреждение. По умолчанию: |
ddp_warning_threshold_pct integer | Выдаёт предупреждение при достижении порога выделенного пространства хранения. Применяется только при raid_level==”raidDiskPool”. Установите ddp_warning_threshold_pct==0, чтобы отключить предупреждение. По умолчанию: |
erase_secured_drives boolean | Если state==”absent”, будут очищены все диски пула хранения. Если state==”present”, будут удалены все доступные диски массива хранения с включённой функцией безопасности. Варианты:
|
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. Варианты:
|
remove_volumes boolean | Перед удалением пула хранения удалить все тома в нём. Варианты:
|
reserve_drive_count integer | Установите количество дисков, резервируемых пулом хранения для операций восстановления. Допустимо только для дисковых пулов RAID. |
secure_pool boolean | Включает функцию защиты данных в состоянии покоя для пула хранения. Работает только в том случае, если все диски в пуле поддерживают защиту (FDE, FIPS или смешанный вариант). Предупреждение: после включения защиты её невозможно отключить без очистки дисков. Варианты:
|
ssid string | Идентификатор массива, которым необходимо управлять. Это значение должно быть уникальным для каждого массива. По умолчанию: |
state string | Указывает, должен ли указанный пул хранения существовать. Обратите внимание: для удаления пула хранения в настоящее время сначала требуется удалить все созданные тома. Варианты:
|
usable_drives string | Упорядоченный список номеров лотков и слотов дисков, разделённых запятыми, для выбора подходящих дисков (уже используемые диски будут пропущены). Каждый диск указывается в формате <номер_лотка>:<(необязательно) номер_отсека>:<номер_слота_диска> (например, 99:0 — это слот диска 0 базового лотка). Идентификатор базового лотка по умолчанию — 99; лотки расширения добавляются в порядке подключения, но пользователь может изменить эти идентификаторы. Обратите внимание: в лотках с несколькими отсеками для всех дисков предусмотрены отдельные слоты, и номер слота не зависит от отсека; однако, если вы планируете защиту от потери отсека, диски нужно упорядочить соответствующим образом. Если usable_drives не задан, подходящие диски выберет система хранения. |
validate_certs boolean | Следует ли проверять сертификаты HTTPS? Варианты:
|
Примечания
Примечание
- Операции расширения выполняются в неблокирующем режиме из-за длительного времени, необходимого для расширения групп томов.
- Традиционные группы томов (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 | Сообщение об успешном выполнении Возвращается: при успехе Пример: |
Ссылки на коллекцию
© 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