Модуль dellemc.powerflex.storagepool – Управление пулом хранения Dell PowerFlex
Примечание
Этот модуль является частью коллекции dellemc.powerflex (версия 2.5.0).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install dellemc.powerflex. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.
Для использования в плейбуке укажите: dellemc.powerflex.storagepool.
Впервые в dellemc.powerflex 1.0.0
Описание
- Модуль Dell PowerFlex storage pool позволяет получить подробную информацию о пуле хранения, создать новый пул хранения и изменить атрибуты существующего пула.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Система хранения Dell PowerFlex версии 3.6 или новее.
- PyPowerFlex 1.12.0.
Параметры
Параметр | Комментарии |
|---|---|
cap_alert_thresholds словарь | Установите порог для срабатывания предупреждений об использовании емкости. Пороги предупреждений рассчитываются для каждой емкости хранилища после вычитания заданного количества резервной емкости. |
|
critical_threshold целое число |
Порог нерезервной емкости хранилища, который приведет к срабатыванию предупреждения критического приоритета, выражается в процентах. |
|
high_threshold целое число |
Порог нерезервной емкости хранилища, который приведет к срабатыванию предупреждения высокого приоритета, выражается в процентах. Это значение должно быть меньше значения critical_threshold. |
enable_fragmentation булево | Включить/выключить фрагментацию конкретного хранилища. Варианты:
|
enable_rebalance булево | Включить/выключить перебалансировку на конкретном хранилище. Варианты:
|
enable_rebuild булево | Включить/выключить восстановление конкретного хранилища. Варианты:
|
enable_zero_padding булево | Включить/выключить нулевое заполнение на конкретном хранилище. Варианты:
|
hostname псевдонимы: gateway_host строка / обязательно | IP-адрес или FQDN хоста PowerFlex. |
media_type строка | Тип устройств в хранилище. Варианты:
|
parallel_rebuild_rebalance_limit целое число | Установите лимит параллельности восстановления/перебалансировки хранилища. |
password строка / обязательно | Пароль хоста PowerFlex. |
persistent_checksum словарь | Включить/выключить постоянную проверку контрольной суммы для конкретного хранилища. |
|
builder_limit целое число |
Предел пропускной способности в КБ/с для процесса создания контрольной суммы. Допустимый диапазон от 1024 до 10240. По умолчанию: |
|
enable булево |
Включить/выключить постоянную проверку контрольной суммы. Варианты:
|
|
validate_on_read булево |
Проверить контрольную сумму при чтении данных. Варианты:
|
port целое число | Номер порта, через который происходит общение с хостом PowerFlex. По умолчанию: |
protected_maintenance_mode_io_priority_policy словарь | Установите политику приоритета операций ввода/вывода в защищенном режиме технического обслуживания хранилища. |
|
bw_limit_per_device целое число |
Максимальная пропускная способность операций ввода/вывода миграции в защищенном режиме технического обслуживания, в КБ в секунду на устройство. Допустимый диапазон от 1024 до 1048576. |
|
concurrent_ios_per_device целое число |
Максимальное количество одновременных операций ввода/вывода миграции в защищенном режиме технического обслуживания на устройство. Допустимый диапазон от 1 до 20. |
|
policy string |
Политика приоритета ввода/вывода для защищённого режима технического обслуживания.
Если в работе находятся операции ввода/вывода приложений, то также ограничить пропускную способность операций миграции защищённого режима технического обслуживания до предела, определённого для bw_limit_per_device. Варианты:
|
protection_domain_id string | Идентификатор домена защиты. При создании пула необходимо указать либо имя, либо идентификатор домена защиты. Взаимоисключающее с protection_domain_name. |
protection_domain_name string | Имя домена защиты. При создании пула необходимо указать либо имя, либо идентификатор домена защиты. Взаимоисключающее с protection_domain_id. |
rebalance_io_priority_policy dictionary | Установить политику приоритета ввода/вывода ребалансировки для пула хранилища. |
|
bw_limit_per_device integer |
Максимальная пропускная способность операций ребалансировки ввода/вывода в КБ/с на устройство. Допустимый диапазон от 1024 до 1048576. |
|
concurrent_ios_per_device integer |
Максимальное количество одновременных операций ребалансировки ввода/вывода на устройство. Допустимый диапазон от 1 до 20. |
|
policy string |
Политика, используемая для приоритета ввода/вывода ребалансировки.
Варианты:
|
rep_cap_max_ratio integer | Установить ёмкость журнала репликации пула хранилища. |
rmcache_write_handling_mode string | Установить режим обработки записи кэша RM для пула хранилища. Passthrough Записи пропускают кэш и хранятся только в хранилище. Cached Записи хранятся как в кэше, так и в хранилище (по умолчанию). Кэширование выполняется только для операций ввода/вывода, размер которых кратен 4К байтам. Варианты:
|
spare_percentage integer | Установить процент резерва для определённого пула хранилища. |
state string / обязательно | Состояние пула хранилища. Варианты:
|
storage_pool_id string | Идентификатор пула хранилища. Автоматически генерируется, поэтому не должен предоставляться при создании пула хранилища. Взаимоисключающее с storage_pool_name. |
storage_pool_name string | Имя пула хранилища. Если найдено более одного пула хранилища с одинаковым именем, то для выполнения задачи требуется идентификатор/имя домена защиты. Взаимоисключающее с storage_pool_id. |
storage_pool_new_name string | Можно указать новое имя для пула хранилища. Этот параметр используется для переименования пула хранилища. |
timeout integer | Время, после которого соединение будет разорвано. Указывается в секундах. По умолчанию: |
use_rfcache boolean | Включить/выключить RFcache для определённого пула хранилища. Варианты:
|
use_rmcache boolean | Включить/выключить RMcache для определённого пула хранилища. Варианты:
|
username string / обязательно | Имя пользователя хоста PowerFlex. |
validate_certs aliases: verifycert boolean | Булево значение, определяющее, нужно ли проверять сертификат SSL.
Варианты:
|
vtree_migration_io_priority_policy словарь | Устанавливает политику приоритета ввода/вывода для миграции V-Tree для определенного хранилища. |
|
bw_limit_per_device целое число |
Максимальная пропускная способность операций ввода/вывода миграции V-Tree, в КБ в секунду, на устройство. Допустимый диапазон — от 1024 до 25600. |
|
concurrent_ios_per_device целое число |
Максимальное количество одновременных операций ввода/вывода миграции V-Tree на устройство. Допустимый диапазон — от 1 до 20 |
|
policy строка |
Политика приоритета ввода/вывода для защищенного режима обслуживания.
Если приложения выполняют операции ввода/вывода, то также следует ограничить пропускную способность операций ввода/вывода миграции V-Tree до предела, определенного для bw_limit_per_device. Варианты:
|
Примечания
Примечание
- Тип медиа TRANSITIONAL поддерживается только во время модификации.
- Поддерживается режим check_mode.
- Модули, присутствующие в коллекции с именем «dellemc.powerflex», разработаны для поддержки платформы хранения Dell PowerFlex.
Примеры
- name: Get the details of storage pool by name
dellemc.powerflex.storagepool:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
storage_pool_name: "sample_pool_name"
protection_domain_name: "sample_protection_domain"
state: "present"
- name: Get the details of storage pool by id
dellemc.powerflex.storagepool:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
storage_pool_id: "abcd1234ab12r"
state: "present"
- name: Create a new Storage pool
dellemc.powerflex.storagepool:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
storage_pool_name: "{{ pool_name }}"
protection_domain_name: "{{ protection_domain_name }}"
cap_alert_thresholds:
high_threshold: 30
critical_threshold: 50
media_type: "TRANSITIONAL"
enable_zero_padding: true
rep_cap_max_ratio: 40
rmcache_write_handling_mode: "Passthrough"
spare_percentage: 80
enable_rebalance: false
enable_fragmentation: false
enable_rebuild: false
use_rmcache: true
use_rfcache: true
parallel_rebuild_rebalance_limit: 3
protected_maintenance_mode_io_priority_policy:
policy: "unlimited"
rebalance_io_priority_policy:
policy: "unlimited"
vtree_migration_io_priority_policy:
policy: "limitNumOfConcurrentIos"
concurrent_ios_per_device: 10
persistent_checksum:
enable: false
state: "present"
- name: Modify a Storage pool by name
dellemc.powerflex.storagepool:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
storage_pool_name: "{{ pool_name }}"
protection_domain_name: "{{ protection_domain_name }}"
storage_pool_new_name: "pool_name_new"
cap_alert_thresholds:
high_threshold: 50
critical_threshold: 70
enable_zero_padding: false
rep_cap_max_ratio: 60
rmcache_write_handling_mode: "Passthrough"
spare_percentage: 90
enable_rebalance: true
enable_fragmentation: true
enable_rebuild: true
use_rmcache: true
use_rfcache: true
parallel_rebuild_rebalance_limit: 6
protected_maintenance_mode_io_priority_policy:
policy: "limitNumOfConcurrentIos"
concurrent_ios_per_device: 4
rebalance_io_priority_policy:
policy: "favorAppIos"
concurrent_ios_per_device: 10
bw_limit_per_device: 4096
vtree_migration_io_priority_policy:
policy: "limitNumOfConcurrentIos"
concurrent_ios_per_device: 10
persistent_checksum:
enable: true
validate_on_read: true
builder_limit: 1024
state: "present"
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:
Ключ | Описание |
|---|---|
changed boolean | Изменился ли ресурс. Возвращается: всегда Пример: |
storage_pool_details словарь | Подробности хранилища. Возвращается: когда хранилище существует Пример: |
|
id строка |
Идентификатор хранилища в домене защиты. Возвращается: успех |
|
mediaType строка |
Тип устройств в хранилище. Возвращается: успех |
|
name строка |
Имя хранилища в домене защиты. Возвращается: успех |
|
protectionDomainId строка |
Идентификатор домена защиты, в котором находится хранилище. Возвращается: успех |
|
protectionDomainName строка |
Имя домена защиты, в котором находится хранилище. Возвращается: успех |
|
statistics словарь |
Подробности статистики хранилища. Возвращается: успех |
|
capacityInUseInKb строка |
Общий объем хранилища. Возвращается: успех |
|
deviceIds список / элементы=строка |
Идентификаторы устройств хранилища. Возвращается: успех |
|
unusedCapacityInKb строка |
Неиспользуемая емкость хранилища. Возвращается: успех |
|
useRfcache boolean |
Включить/выключить RFcache для конкретного хранилища. Возвращается: успех |
|
useRmcache boolean |
Включить/выключить RMcache для конкретного хранилища. Возвращается: успех |
Ссылки на коллекции
© 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/powerflex/storagepool_module.html