Модуль dellemc.powerflex.storagepool_v2 — управление пулом хранения в Dell PowerFlex 5.x

Примечание

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

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

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

Чтобы использовать его в плейбуке, укажите: dellemc.powerflex.storagepool_v2.

Добавлено в dellemc.powerflex 3.0.0

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

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

Модуль пулов хранения Dell PowerFlex позволяет получать сведения о пуле хранения, создавать новые пулы хранения и изменять атрибуты пула хранения.

Требования

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

Система хранения Dell PowerFlex версии 5.0 или новее.
PyPowerFlex 2.0.0

Параметры

Параметр	Описание
cap_alert_thresholds словарь	Пороговые значения оповещений о емкости.
critical_threshold целое число	Критическое пороговое значение.
high_threshold целое число	Высокое пороговое значение.
compression_method строка	Метод сжатия. Допустимые значения: `"None"` `"Normal"`
device_group_id строка	Идентификатор группы устройств.
device_group_name строка	Имя группы устройств.
hostname псевдонимы: gateway_host строка / обязательный	IP-адрес или полное доменное имя узла PowerFlex.
over_provisioning_factor целое число	Коэффициент избыточного выделения ресурсов.
password строка / обязательный	Пароль узла PowerFlex.
physical_size_gb целое число	Физический размер в ГБ. Если для параметра ‘use_all_available_capacity’ задано значение true, этот параметр указывать нельзя. Если для параметра ‘use_all_available_capacity’ задано значение false, этот параметр обязателен.
port целое число	Номер порта, используемого для связи с узлом PowerFlex. По умолчанию: `443`
protection_domain_id строка	Идентификатор домена защиты. При создании пула необходимо указать имя или идентификатор домена защиты. Взаимоисключающий параметр: protection_domain_name.
protection_domain_name строка	Имя домена защиты. При создании пула необходимо указать имя или идентификатор домена защиты. Взаимоисключающий параметр: protection_domain_id.
protection_scheme строка	Схема защиты. Допустимые значения: `"TwoPlusTwo"` `"EightPlusTwo"`
state строка / обязательный	Состояние пула хранения. Может иметь значение ‘present’ или ‘absent’. Допустимые значения: `"present"` `"absent"`
storage_pool_id строка	Идентификатор пула хранения. Он создается автоматически, поэтому его не следует указывать при создании пула хранения. Взаимоисключающий параметр: storage_pool_name.
storage_pool_name строка	Имя пула хранения. Если найдено несколько пулов хранения с одинаковым именем, для выполнения задачи необходимо указать идентификатор или имя домена защиты. Взаимоисключающий параметр: storage_pool_id.
storage_pool_new_name строка	Можно указать новое имя пула хранения. Этот параметр используется для переименования пула хранения.
timeout целое число	Время, по истечении которого соединение будет разорвано. Значение указывается в секундах. По умолчанию: `120`
use_all_available_capacity логический	Использовать ли всю доступную емкость для пула хранения. Если задано значение true, параметр ‘physical_size_gb’ указывать нельзя. Если задано значение false, параметр ‘physical_size_gb’ обязателен. Допустимые значения: `false` `true`
username строка / обязательный	Имя пользователя узла PowerFlex.
validate_certs псевдонимы: verifycert логический	Логическая переменная, определяющая, нужно ли проверять сертификат SSL. `true` — указывает, что сертификат SSL необходимо проверить. `false` — указывает, что сертификат SSL проверять не нужно. Допустимые значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

Этот модуль поддерживается в Dell PowerFlex 5.x и более поздних версиях.
Поддерживается режим check_mode.
Модули коллекции ‘dellemc.powerflex’ предназначены для работы с платформой хранения Dell PowerFlex.

Примеры

- name: Get the details of storage pool by name
  dellemc.powerflex.storagepool_v2:
    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_v2:
    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_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    storage_pool_name: "{{ pool_name }}"
    protection_domain_name: "{{ protection_domain_name }}"
    device_group_name: "{{ device_group_name }}"
    cap_alert_thresholds:
      high_threshold: 80
      critical_threshold: 90
    compression_method: Normal
    over_provisioning_factor: 2
    physical_size_gb: 100
    protection_scheme: TwoPlusTwo
    state: "present"

- name: Modify a Storage pool by name
  dellemc.powerflex.storagepool_v2:
    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: 85
      critical_threshold: 95
    compression_method: None
    state: "present"

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

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

Ключ	Описание
changed boolean	Изменился ли ресурс. Возвращается: всегда Пример: `false`
storage_pool_details dictionary	Сведения о пуле хранения. Возвращается: если пул хранения существует Пример: {"addressSpaceUsage": "Normal", "addressSpaceUsageType": "TypeHardLimit", "backgroundScannerBWLimitKBps": null, "backgroundScannerMode": null, "bgScannerCompareErrorAction": "Invalid", "bgScannerReadErrorAction": "Invalid", "capacityAlertCriticalThreshold": 90, "capacityAlertHighThreshold": 80, "capacityUsageState": "Normal", "capacityUsageType": "NetCapacity", "checksumEnabled": false, "compressionMethod": "Normal", "dataLayout": "ErasureCoding", "deviceGroupId": "39a898be00000000", "deviceGroupName": "DG1", "externalAccelerationType": "None", "fglAccpId": null, "fglExtraCapacity": null, "fglMaxCompressionRatio": null, "fglMetadataSizeXx100": null, "fglNvdimmMetadataAmortizationX100": null, "fglNvdimmWriteCacheSizeInMb": null, "fglOverProvisioningFactor": null, "fglPerfProfile": null, "fglWriteAtomicitySize": null, "fragmentationEnabled": false, "genType": "EC", "id": "5dabf3f800000000", "links": [{"href": "/api/instances/StoragePool::5dabf3f800000000", "rel": "self"}, {"body": {"ids": ["5dabf3f800000000"], "resource_type": "storage_pool"}, "href": "/dtapi/rest/v1/metrics/query", "rel": "/dtapi/rest/v1/metrics/query"}, {"href": "/api/instances/StoragePool::5dabf3f800000000/relationships/SpSds", "rel": "/api/StoragePool/relationship/SpSds"}, {"href": "/api/instances/StoragePool::5dabf3f800000000/relationships/Volume", "rel": "/api/StoragePool/relationship/Volume"}, {"href": "/api/instances/StoragePool::5dabf3f800000000/relationships/Device", "rel": "/api/StoragePool/relationship/Device"}, {"href": "/api/instances/StoragePool::5dabf3f800000000/relationships/VTree", "rel": "/api/StoragePool/relationship/VTree"}, {"href": "/api/instances/ProtectionDomain::f3d03dcf00000000", "rel": "/api/parent/relationship/protectionDomainId"}, {"href": "/api/instances/DeviceGroup::39a898be00000000", "rel": "/api/parent/relationship/deviceGroupId"}, {"href": "/api/instances/WrcDeviceGroup::39a898be00000000", "rel": "/api/parent/relationship/wrcDeviceGroupId"}], "mediaType": null, "name": "SP_EC", "numOfParallelRebuildRebalanceJobsPerDevice": null, "overProvisioningFactor": 0, "persistentChecksumBuilderLimitKb": null, "persistentChecksumEnabled": false, "persistentChecksumState": "StateInvalid", "persistentChecksumValidateOnRead": null, "physicalSizeGB": 5120, "protectedMaintenanceModeIoPriorityAppBwPerDeviceThresholdInKbps": null, "protectedMaintenanceModeIoPriorityAppIopsPerDeviceThreshold": null, "protectedMaintenanceModeIoPriorityBwLimitPerDeviceInKbps": null, "protectedMaintenanceModeIoPriorityNumOfConcurrentIosPerDevice": null, "protectedMaintenanceModeIoPriorityPolicy": null, "protectedMaintenanceModeIoPriorityQuietPeriodInMsec": null, "protectionDomainId": "f3d03dcf00000000", "protectionDomainName": "PD_EC", "protectionScheme": "TwoPlusTwo", "rawSizeGB": 10240, "rebalanceEnabled": null, "rebalanceIoPriorityAppBwPerDeviceThresholdInKbps": null, "rebalanceIoPriorityAppIopsPerDeviceThreshold": null, "rebalanceIoPriorityBwLimitPerDeviceInKbps": null, "rebalanceIoPriorityNumOfConcurrentIosPerDevice": null, "rebalanceIoPriorityPolicy": null, "rebalanceIoPriorityQuietPeriodInMsec": null, "rebuildEnabled": null, "rebuildIoPriorityAppBwPerDeviceThresholdInKbps": null, "rebuildIoPriorityAppIopsPerDeviceThreshold": null, "rebuildIoPriorityBwLimitPerDeviceInKbps": null, "rebuildIoPriorityNumOfConcurrentIosPerDevice": null, "rebuildIoPriorityPolicy": null, "rebuildIoPriorityQuietPeriodInMsec": null, "replicationCapacityMaxRatio": null, "rmcacheWriteHandlingMode": "Invalid", "spClass": "Default", "spHealthState": "Protected", "sparePercentage": null, "statistics": {"format": "ID_TIMESTAMP_METRIC", "resource_type": "storage_pool", "resources": [{"id": "5dabf3f800000000", "metrics": [{"name": "physical_free", "values": [5443871047680]}, {"name": "logical_provisioned", "values": [0]}, {"name": "raw_used", "values": [10995116277760]}, {"name": "logical_used", "values": [0]}, {"name": "physical_total", "values": [5497558138880]}, {"name": "physical_used", "values": [0]}, {"name": "over_provisioning_limit", "values": [4611686017353646080]}]}], "timestamps": ["2025-08-25T05:24:06Z"]}, "useRfcache": false, "useRmcache": false, "vtreeMigrationIoPriorityAppBwPerDeviceThresholdInKbps": null, "vtreeMigrationIoPriorityAppIopsPerDeviceThreshold": null, "vtreeMigrationIoPriorityBwLimitPerDeviceInKbps": null, "vtreeMigrationIoPriorityNumOfConcurrentIosPerDevice": null, "vtreeMigrationIoPriorityPolicy": null, "vtreeMigrationIoPriorityQuietPeriodInMsec": null, "wrcDeviceGroupId": "39a898be00000000", "zeroPaddingEnabled": true}
addressSpaceUsage string	Текущее состояние использования адресного пространства. Возвращается: при успешном выполнении
addressSpaceUsageType string	Тип ограничения на использование адресного пространства. Возвращается: при успешном выполнении
capacityAlertCriticalThreshold integer	Критический порог оповещения о ёмкости (в процентах). Возвращается: при успешном выполнении
capacityAlertHighThreshold integer	Высокий порог оповещения о ёмкости (в процентах). Возвращается: при успешном выполнении
capacityUsageState string	Текущее состояние использования ёмкости пула хранения. Возвращается: при успешном выполнении
capacityUsageType string	Тип использования ёмкости, за которым ведётся наблюдение. Возвращается: при успешном выполнении
compressionMethod string	Метод сжатия, используемый в пуле хранения. Возвращается: при успешном выполнении
deviceGroupId string	Идентификатор группы устройств, связанной с пулом хранения. Возвращается: при успешном выполнении
fragmentationEnabled boolean	Указывает, включена ли дефрагментация для пула хранения. Возвращается: при успешном выполнении
genType string	Тип поколения защиты данных пула хранения. Возвращается: при успешном выполнении
id string	Идентификатор пула хранения. Возвращается: при успешном выполнении
inflightBandwidthFactor integer	Коэффициент пропускной способности для выполняющихся операций, используемый для настройки производительности. Возвращается: при успешном выполнении
inflightRequestsFactor integer	Коэффициент количества выполняющихся запросов, используемый для настройки производительности. Возвращается: при успешном выполнении
name string	Имя пула хранения. Возвращается: при успешном выполнении
numDataSlices integer	Количество срезов данных, используемых при кодировании с устранением ошибок. Возвращается: при успешном выполнении
numProtectionSlices integer	Количество защитных срезов, используемых при кодировании с устранением ошибок. Возвращается: при успешном выполнении
overProvisioningFactor integer	Коэффициент избыточного выделения ресурсов для пула хранения. Возвращается: при успешном выполнении
physicalSizeGb integer	Физический размер пула хранения в ГБ. Возвращается: при успешном выполнении
protectionDomainId string	Идентификатор домена защиты, в котором находится пул хранения. Возвращается: при успешном выполнении
protectionScheme string	Схема защиты данных, используемая в пуле хранения. Возвращается: при успешном выполнении
rawSizeGb integer	Исходный размер пула хранения в ГБ. Возвращается: при успешном выполнении
spClass string	Класс пула хранения. Возвращается: при успешном выполнении
spHealthState string	Состояние работоспособности пула хранения. Возвращается: при успешном выполнении
statistics dictionary	Статистические сведения о пуле хранения. Возвращается: при успешном выполнении
capacityInUseInKb string	Общая ёмкость пула хранения. Возвращается: при успешном выполнении
deviceIds list / элементы=string	Идентификаторы устройств пула хранения. Возвращается: при успешном выполнении
unusedCapacityInKb string	Неиспользуемая ёмкость пула хранения. Возвращается: при успешном выполнении
wrcDeviceGroupId string	Идентификатор группы устройств WRC. Возвращается: при успешном выполнении
zeroPaddingEnabled boolean	Указывает, включено ли заполнение нулями для пула хранения. Возвращается: при успешном выполнении

Авторы

Luis Liu (@vangork)
Yiming Bao (@baoy1)

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

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