VhZ `dZddlmZmZmZeZdZdZdZ ddl m Z ddl m Z ddlmZdd lmZej$d ZGd d e Zd ZGddZGddZGddZGddZGddZGddZGddZGddZGddZGd d!ZGd"d#Z Gd$d%Z!Gd&d'Z"Gd(d)Z#Gd*d+Z$Gd,d-Z%Gd.d/Z&Gd0d1Z'Gd2d3Z(Gd4d5Z)Gd6d7Z*d8Z+e,d9k(re+y:y:);zKAnsible module for managing Dell Technologies (Dell) PowerFlex storage pool)absolute_importdivisionprint_functiona --- module: storagepool version_added: '1.0.0' short_description: Managing Dell PowerFlex storage pool description: - Dell PowerFlex storage pool module includes getting the details of storage pool, creating a new storage pool, and modifying the attribute of a storage pool. extends_documentation_fragment: - dellemc.powerflex.powerflex author: - Arindam Datta (@dattaarindam) - P Srinivas Rao (@srinivas-rao5) - Trisha Datta (@trisha-dell) options: storage_pool_name: description: - The name of the storage pool. - If more than one storage pool is found with the same name then protection domain id/name is required to perform the task. - Mutually exclusive with I(storage_pool_id). type: str storage_pool_id: description: - The id of the storage pool. - It is auto generated, hence should not be provided during creation of a storage pool. - Mutually exclusive with I(storage_pool_name). type: str protection_domain_name: description: - The name of the protection domain. - During creation of a pool, either protection domain name or id must be mentioned. - Mutually exclusive with I(protection_domain_id). type: str protection_domain_id: description: - The id of the protection domain. - During creation of a pool, either protection domain name or id must be mentioned. - Mutually exclusive with I(protection_domain_name). type: str media_type: description: - Type of devices in the storage pool. type: str choices: ['HDD', 'SSD', 'TRANSITIONAL'] storage_pool_new_name: description: - New name for the storage pool can be provided. - This parameter is used for renaming the storage pool. type: str use_rfcache: description: - Enable/Disable RFcache on a specific storage pool. type: bool use_rmcache: description: - Enable/Disable RMcache on a specific storage pool. type: bool enable_zero_padding: description: - Enable/Disable zero padding on a specific storage pool. type: bool rep_cap_max_ratio: description: - Set replication journal capacity of a storage pool. type: int enable_rebalance: description: - Enable/Disable rebalance on a specific storage pool. type: bool spare_percentage: description: - Set the spare percentage of a specific storage pool. type: int rmcache_write_handling_mode : description: - Set RM cache write handling mode of a storage pool. - I(Passthrough) Writes skip the cache and are stored in storage only. - I(Cached) Writes are stored in both cache and storage (the default). - Caching is only performed for IOs whose size is a multiple of 4k bytes. type: str choices: ['Cached', 'Passthrough'] default: 'Cached' enable_rebuild: description: - Enable/Disable rebuild of a specific storage pool. type: bool enable_fragmentation: description: - Enable/Disable fragmentation of a specific storage pool. type: bool parallel_rebuild_rebalance_limit: description: - Set rebuild/rebalance parallelism limit of a storage pool. type: int persistent_checksum: description: - Enable/Disable persistent checksum of a specific storage pool. type: dict suboptions: enable: description: - Enable / disable persistent checksum. type: bool validate_on_read: description: - Validate checksum upon reading data. type: bool builder_limit: description: - Bandwidth limit in KB/s for the checksum building process. - Valid range is 1024 to 10240. default: 3072 type: int protected_maintenance_mode_io_priority_policy: description: - Set protected maintenance mode I/O priority policy of a storage pool. type: dict suboptions: policy: description: - The I/O priority policy for protected maintenance mode. - C(unlimited) Protected maintenance mode IOPS are not limited - C(limitNumOfConcurrentIos)Limit the number of allowed concurrent protected maintenance mode migration I/Os to the value defined for I(concurrent_ios_per_device). - C(favorAppIos) Always limit the number of allowed concurrent protected maintenance mode migration I/Os to value defined for I(concurrent_ios_per_device). - If application I/Os are in progress, should also limit the bandwidth of protected maintenance mode migration I/Os to the limit defined for the I(bw_limit_per_device). type: str choices: ['unlimited', 'limitNumOfConcurrentIos', 'favorAppIos'] default: 'limitNumOfConcurrentIos' concurrent_ios_per_device: description: - The maximum number of concurrent protected maintenance mode migration I/Os per device. - Valid range is 1 to 20. type: int bw_limit_per_device: description: - The maximum bandwidth of protected maintenance mode migration I/Os, in KB per second, per device. - Valid range is 1024 to 1048576. type: int vtree_migration_io_priority_policy: description: - Set the I/O priority policy for V-Tree migration for a specific Storage Pool. type: dict suboptions: policy: description: - The I/O priority policy for protected maintenance mode. - C(limitNumOfConcurrentIos) Limit the number of allowed concurrent V-Tree migration I/Os (default) to the I(concurrent_ios_per_device). - C(favorAppIos) Always limit the number of allowed concurrent V-Tree migration I/Os to defined for I(concurrent_ios_per_device). - If application I/Os are in progress, should also limit the bandwidth of V-Tree migration I/Os to the limit defined for the I(bw_limit_per_device). type: str choices: ['limitNumOfConcurrentIos', 'favorAppIos'] concurrent_ios_per_device: description: - The maximum number of concurrent V-Tree migration I/Os per device. - Valid range is 1 to 20 type: int bw_limit_per_device: description: - The maximum bandwidth of V-Tree migration I/Os, in KB per second, per device. - Valid range is 1024 to 25600. type: int rebalance_io_priority_policy: description: - Set the rebalance I/O priority policy for a Storage Pool. type: dict suboptions: policy: description: - Policy to use for rebalance I/O priority. - C(unlimited) Rebalance I/Os are not limited. - C(limitNumOfConcurrentIos) Limit the number of allowed concurrent rebalance I/Os. - C(favorAppIos) Limit the number and bandwidth of rebalance I/Os when application I/Os are in progress. type: str choices: ['unlimited', 'limitNumOfConcurrentIos', 'favorAppIos'] default: 'favorAppIos' concurrent_ios_per_device: description: - The maximum number of concurrent rebalance I/Os per device. - Valid range is 1 to 20. type: int bw_limit_per_device: description: - The maximum bandwidth of rebalance I/Os, in KB/s, per device. - Valid range is 1024 to 1048576. type: int cap_alert_thresholds: description: - Set the threshold for triggering capacity usage alerts. - Alerts thresholds are calculated from each Storage Pool capacity after deducting the defined amount of spare capacity. type: dict suboptions: high_threshold: description: - Threshold of the non-spare capacity of the Storage Pool that will trigger a high-priority alert, expressed as a percentage. - This value must be lower than the I(critical_threshold). type: int critical_threshold: description: - Threshold of the non-spare capacity of the Storage Pool that will trigger a critical-priority alert, expressed as a percentage. type: int state: description: - State of the storage pool. type: str choices: ["present", "absent"] required: true notes: - TRANSITIONAL media type is supported only during modification. - The I(check_mode) is supported. a - 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" a@ changed: description: Whether or not the resource has changed. returned: always type: bool sample: 'false' storage_pool_details: description: Details of the storage pool. returned: When storage pool exists type: dict contains: mediaType: description: Type of devices in the storage pool. type: str useRfcache: description: Enable/Disable RFcache on a specific storage pool. type: bool useRmcache: description: Enable/Disable RMcache on a specific storage pool. type: bool id: description: ID of the storage pool under protection domain. type: str name: description: Name of the storage pool under protection domain. type: str protectionDomainId: description: ID of the protection domain in which pool resides. type: str protectionDomainName: description: Name of the protection domain in which pool resides. type: str "statistics": description: Statistics details of the storage pool. type: dict contains: "capacityInUseInKb": description: Total capacity of the storage pool. type: str "unusedCapacityInKb": description: Unused capacity of the storage pool. type: str "deviceIds": description: Device Ids of the storage pool. type: list sample: { "addressSpaceUsage": "Normal", "addressSpaceUsageType": "DeviceCapacityLimit", "backgroundScannerBWLimitKBps": 3072, "backgroundScannerMode": "DataComparison", "bgScannerCompareErrorAction": "ReportAndFix", "bgScannerReadErrorAction": "ReportAndFix", "capacityAlertCriticalThreshold": 90, "capacityAlertHighThreshold": 80, "capacityUsageState": "Normal", "capacityUsageType": "NetCapacity", "checksumEnabled": false, "compressionMethod": "Invalid", "dataLayout": "MediumGranularity", "externalAccelerationType": "None", "fglAccpId": null, "fglExtraCapacity": null, "fglMaxCompressionRatio": null, "fglMetadataSizeXx100": null, "fglNvdimmMetadataAmortizationX100": null, "fglNvdimmWriteCacheSizeInMb": null, "fglOverProvisioningFactor": null, "fglPerfProfile": null, "fglWriteAtomicitySize": null, "fragmentationEnabled": true, "id": "e0d8f6c900000000", "links": [ { "href": "/api/instances/StoragePool::e0d8f6c900000000", "rel": "self" }, { "href": "/api/instances/StoragePool::e0d8f6c900000000 /relationships/Statistics", "rel": "/api/StoragePool/relationship/Statistics" }, { "href": "/api/instances/StoragePool::e0d8f6c900000000 /relationships/SpSds", "rel": "/api/StoragePool/relationship/SpSds" }, { "href": "/api/instances/StoragePool::e0d8f6c900000000 /relationships/Volume", "rel": "/api/StoragePool/relationship/Volume" }, { "href": "/api/instances/StoragePool::e0d8f6c900000000 /relationships/Device", "rel": "/api/StoragePool/relationship/Device" }, { "href": "/api/instances/StoragePool::e0d8f6c900000000 /relationships/VTree", "rel": "/api/StoragePool/relationship/VTree" }, { "href": "/api/instances/ProtectionDomain::9300c1f900000000", "rel": "/api/parent/relationship/protectionDomainId" } ], "statistics": { "BackgroundScannedInMB": 3466920, "activeBckRebuildCapacityInKb": 0, "activeEnterProtectedMaintenanceModeCapacityInKb": 0, "aggregateCompressionLevel": "Uncompressed", "atRestCapacityInKb": 1248256, "backgroundScanCompareErrorCount": 0, "backgroundScanFixedCompareErrorCount": 0, "bckRebuildReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "bckRebuildWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "capacityAvailableForVolumeAllocationInKb": 369098752, "capacityInUseInKb": 2496512, "capacityInUseNoOverheadInKb": 2496512, "capacityLimitInKb": 845783040, "compressedDataCompressionRatio": 0.0, "compressionRatio": 1.0, "currentFglMigrationSizeInKb": 0, "deviceIds": [ ], "enterProtectedMaintenanceModeCapacityInKb": 0, "enterProtectedMaintenanceModeReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "enterProtectedMaintenanceModeWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "exitProtectedMaintenanceModeReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "exitProtectedMaintenanceModeWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "exposedCapacityInKb": 0, "failedCapacityInKb": 0, "fwdRebuildReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "fwdRebuildWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "inMaintenanceCapacityInKb": 0, "inMaintenanceVacInKb": 0, "inUseVacInKb": 184549376, "inaccessibleCapacityInKb": 0, "logWrittenBlocksInKb": 0, "maxCapacityInKb": 845783040, "migratingVolumeIds": [ ], "migratingVtreeIds": [ ], "movingCapacityInKb": 0, "netCapacityInUseInKb": 1248256, "normRebuildCapacityInKb": 0, "normRebuildReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "normRebuildWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "numOfDeviceAtFaultRebuilds": 0, "numOfDevices": 3, "numOfIncomingVtreeMigrations": 0, "numOfVolumes": 8, "numOfVolumesInDeletion": 0, "numOfVtrees": 8, "overallUsageRatio": 73.92289, "pendingBckRebuildCapacityInKb": 0, "pendingEnterProtectedMaintenanceModeCapacityInKb": 0, "pendingExitProtectedMaintenanceModeCapacityInKb": 0, "pendingFwdRebuildCapacityInKb": 0, "pendingMovingCapacityInKb": 0, "pendingMovingInBckRebuildJobs": 0, "persistentChecksumBuilderProgress": 100.0, "persistentChecksumCapacityInKb": 414720, "primaryReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "primaryReadFromDevBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "primaryReadFromRmcacheBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "primaryVacInKb": 92274688, "primaryWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "protectedCapacityInKb": 2496512, "protectedVacInKb": 184549376, "provisionedAddressesInKb": 2496512, "rebalanceCapacityInKb": 0, "rebalanceReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "rebalanceWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "rfacheReadHit": 0, "rfacheWriteHit": 0, "rfcacheAvgReadTime": 0, "rfcacheAvgWriteTime": 0, "rfcacheIoErrors": 0, "rfcacheIosOutstanding": 0, "rfcacheIosSkipped": 0, "rfcacheReadMiss": 0, "rmPendingAllocatedInKb": 0, "rmPendingThickInKb": 0, "rplJournalCapAllowed": 0, "rplTotalJournalCap": 0, "rplUsedJournalCap": 0, "secondaryReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "secondaryReadFromDevBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "secondaryReadFromRmcacheBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "secondaryVacInKb": 92274688, "secondaryWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "semiProtectedCapacityInKb": 0, "semiProtectedVacInKb": 0, "snapCapacityInUseInKb": 0, "snapCapacityInUseOccupiedInKb": 0, "snapshotCapacityInKb": 0, "spSdsIds": [ "abdfe71b00030001", "abdce71d00040001", "abdde71e00050001" ], "spareCapacityInKb": 84578304, "targetOtherLatency": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "targetReadLatency": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "targetWriteLatency": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "tempCapacityInKb": 0, "tempCapacityVacInKb": 0, "thickCapacityInUseInKb": 0, "thinAndSnapshotRatio": 73.92289, "thinCapacityAllocatedInKm": 184549376, "thinCapacityInUseInKb": 0, "thinUserDataCapacityInKb": 2496512, "totalFglMigrationSizeInKb": 0, "totalReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "totalWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "trimmedUserDataCapacityInKb": 0, "unreachableUnusedCapacityInKb": 0, "unusedCapacityInKb": 758708224, "userDataCapacityInKb": 2496512, "userDataCapacityNoTrimInKb": 2496512, "userDataReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "userDataSdcReadLatency": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "userDataSdcTrimLatency": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "userDataSdcWriteLatency": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "userDataTrimBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "userDataWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "volMigrationReadBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "volMigrationWriteBwc": { "numOccured": 0, "numSeconds": 0, "totalWeightInKb": 0 }, "volumeAddressSpaceInKb": 922XXXXX, "volumeAllocationLimitInKb": 3707XXXXX, "volumeIds": [ "456afc7900XXXXXXXX" ], "vtreeAddresSpaceInKb": 92274688, "vtreeIds": [ "32b1681bXXXXXXXX", ] }, "mediaType": "HDD", "name": "pool1", "numOfParallelRebuildRebalanceJobsPerDevice": 2, "persistentChecksumBuilderLimitKb": 3072, "persistentChecksumEnabled": true, "persistentChecksumState": "Protected", "persistentChecksumValidateOnRead": false, "protectedMaintenanceModeIoPriorityAppBwPerDeviceThresholdInKbps": null, "protectedMaintenanceModeIoPriorityAppIopsPerDeviceThreshold": null, "protectedMaintenanceModeIoPriorityBwLimitPerDeviceInKbps": 10240, "protectedMaintenanceModeIoPriorityNumOfConcurrentIosPerDevice": 1, "protectedMaintenanceModeIoPriorityPolicy": "limitNumOfConcurrentIos", "protectedMaintenanceModeIoPriorityQuietPeriodInMsec": null, "protectionDomainId": "9300c1f900000000", "protectionDomainName": "domain1", "rebalanceEnabled": true, "rebalanceIoPriorityAppBwPerDeviceThresholdInKbps": null, "rebalanceIoPriorityAppIopsPerDeviceThreshold": null, "rebalanceIoPriorityBwLimitPerDeviceInKbps": 10240, "rebalanceIoPriorityNumOfConcurrentIosPerDevice": 1, "rebalanceIoPriorityPolicy": "favorAppIos", "rebalanceIoPriorityQuietPeriodInMsec": null, "rebuildEnabled": true, "rebuildIoPriorityAppBwPerDeviceThresholdInKbps": null, "rebuildIoPriorityAppIopsPerDeviceThreshold": null, "rebuildIoPriorityBwLimitPerDeviceInKbps": 10240, "rebuildIoPriorityNumOfConcurrentIosPerDevice": 1, "rebuildIoPriorityPolicy": "limitNumOfConcurrentIos", "rebuildIoPriorityQuietPeriodInMsec": null, "replicationCapacityMaxRatio": 32, "rmcacheWriteHandlingMode": "Cached", "sparePercentage": 10, "useRfcache": false, "useRmcache": false, "vtreeMigrationIoPriorityAppBwPerDeviceThresholdInKbps": null, "vtreeMigrationIoPriorityAppIopsPerDeviceThreshold": null, "vtreeMigrationIoPriorityBwLimitPerDeviceInKbps": 10240, "vtreeMigrationIoPriorityNumOfConcurrentIosPerDevice": 1, "vtreeMigrationIoPriorityPolicy": "favorAppIos", "vtreeMigrationIoPriorityQuietPeriodInMsec": null, "zeroPaddingEnabled": true } ) AnsibleModule) PowerFlexBase) Configuration)utils storagepoolcreZdZdZfdZ ddZ ddZ ddZdZdZ dZ d Z d Z d Z d Zd ZxZS)PowerFlexStoragePoolz!Class with StoragePool operationsc ddgddgddgddgg}ddgg}td||d}t| t|t j |j tdi|_y ) z. Define all parameters required by this modulestorage_pool_namestorage_pool_idprotection_domain_nameprotection_domain_idT) argument_specsupports_check_modemutually_exclusiverequired_one_ofF)changedstorage_pool_detailsN) $get_powerflex_storagepool_parameterssuper__init__rr ensure_required_libsmoduledictresult)selfrransible_module_params __class__s q/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/dellemc/powerflex/plugins/modules/storagepool.pyrzPowerFlexStoragePool.__init__s-24EF79OP02JK02HIK 01BCDBC#'"4. !  (=> ""4;;/!#  cdt|j|jj||S)zRGet the details of a protection domain in a given PowerFlex storage system)rr)rpowerflex_connrget_protection_domain)rrrs r"r&z*PowerFlexStoragePool.get_protection_domains6 T00$++>TT#9PdUf fr#c|r|n|} i}|rd|i}|r|jd|i|r|jd|i|jjj|}|gk7rt |dkDrCdj |}t j||jj|y t |dk(rW|d}|jjj|d}|r|ni|d <|d}|j| d} | |d <|Sy #t$rV} d j |t| } t j| |jj| Yd } ~ y d } ~ wwxYw)zGet storage pool details :param pd_id: ID of the protection domain :param storage_pool_name: The name of the storage pool :param storage_pool_id: The storage pool id :return: Storage pool details idnameprotectionDomainId) filter_fieldsztMore than one storage pool found with {0}, Please provide protection domain Name/Id to fetch the unique storage poolmsgr statistics)rprotectionDomainNameNz1Failed to get the storage pool {0} with error {1})updater% storage_poolgetlenformatLOGerrorr fail_jsonget_statisticsr& Exceptionstr) rrrpd_id name_or_idr+ pool_detailserr_msgr/pd_nameeerrormsgs r"get_storage_poolz%PowerFlexStoragePool.get_storage_pools)8_" $ 0M!% 7  $$f.?%@A$$&:E%BC..;;??+@-Lr!|$q(./5f5F.GIIg&KK))g)6&!+#/?L!%!4!4!A!A!P!PQ]^bQc!dJ?IrL.()=>E"88-2944:r@r<s r"verify_protection_domainz-PowerFlexStoragePool.verify_protection_domainss ++$$%=> ""#9:  #,/C"DD %%+L%M 7l3I&JJ %%+O%PKw $r#cp|jjd3t|jjdjdk(sL|jjdQt|jjdjdk(r|jj dyyy)Nrrstorage_pool_new_namez]Empty or white spaced string provided for storage pool name. Provide valid storage pool name.r-)rrOr4stripr8)rs r"verify_storage_pool_namez-PowerFlexStoragePool.verify_storage_pool_names KK  2 3 ?T[[''(;<BBDEJ##$;<H++,CDJJLMQRR KK ! !" " #SIr#c |ddr}|ddur?|jjj|d|dd|dd|ddn7|jjj|d|dd|dd |j |d }|S#t $rU}d j t|}tj||jj| Yd}~yd}~wwxYw) Npersistent_checksumenablepersistentChecksumEnabledTr(validate_on_read builder_limit)rrWvalidaterZ)rr[rZrz0Failed to set persistent checksum with error {0}r-) r%r2set_persistent_checksummodify_persistent_checksumrCr:r5r;r6r7rr8)rr> pool_paramsrAr?s r"r]z,PowerFlexStoragePool.set_persistent_checksums* /01(; ;r_ checksum_dicts r"to_modify_persistent_checksumz2PowerFlexStoragePool.to_modify_persistent_checksums , -h 7 C128< Mh@ii&12G&H&RM( # , -.@ A M123EF,WyJzz128<D0; J12?C|TvGww128<D-89N-OP_-`M/ *r#c@dddd}d}|dd|dd|dk7r |dd|d<d}|dd"|dd|dk7rt|dd|d <|dd "|dd |d k7rt|dd |d <|d|d |d  |d|d<d}|dur|Sy) Npolicyconcurrent_iosbw_limitFrebalance_io_priority_policyrhrebalanceIoPriorityPolicyTconcurrent_ios_per_device.rebalanceIoPriorityNumOfConcurrentIosPerDeviceribw_limit_per_device)rebalanceIoPriorityBwLimitPerDeviceInKbpsrjr;rr>r_ policy_dictmodifys r"&to_modify_rebalance_io_priority_policyz;PowerFlexStoragePool.to_modify_rebalance_io_priority_policysN"  5 6x @ L:;HEVqIrr$/0N$OPX$YK !F 5 67R S _:; r#c@dddd}d}|dd|dd|dk7r |dd|d<d}|dd"|dd|dk7rt|dd|d <|dd "|dd |d k7rt|dd |d <|d|d |d  |d|d<d}|dur|Sy) NrgF"vtree_migration_io_priority_policyrhvtreeMigrationIoPriorityPolicyTrm3vtreeMigrationIoPriorityNumOfConcurrentIosPerDeviceriro.vtreeMigrationIoPriorityBwLimitPerDeviceInKbpsrjrqrrs r",to_modify_vtree_migration_io_priority_policyzAPowerFlexStoragePool.to_modify_vtree_migration_io_priority_policys<"  ;  r#c@dddd}d}|dd|dd|dk7r |dd|d<d}|dd"|dd|dk7rt|dd|d <|dd "|dd |d k7rt|dd |d <|d|d |d  |d|d<d}|dur|Sy) NrgF-protected_maintenance_mode_io_priority_policyrh(protectedMaintenanceModeIoPriorityPolicyTrm=protectedMaintenanceModeIoPriorityNumOfConcurrentIosPerDeviceriro8protectedMaintenanceModeIoPriorityBwLimitPerDeviceInKbpsrjrqrrs r"7to_modify_protected_maintenance_mode_io_priority_policyzLPowerFlexStoragePool.to_modify_protected_maintenance_mode_io_priority_policysT"  F G Q ]KLXVZfhR[SS$/0_$`ai$jK !F F GHc d pKLMhi\]^,/  r#c*d}t}|dd$|dd|dk7rt|dd|d<d}|dd$|dd|dk7rt|dd|d <d}|dur*d|vrt|d|d<d |vrt|d|d <|S) NFcap_alert_thresholdshigh_thresholdcapacityAlertHighThresholdhighTcritical_thresholdcapacityAlertCriticalThresholdcritical)rr;)rr>r_ thresholdsrt thresholds r"#to_modify_capacity_alert_thresholdsz8PowerFlexStoragePool.to_modify_capacity_alert_thresholdssF - ./? @ LQ\]sQt R"%12N%ORP #K0F$GHX$Y ZIf F - ./C D P234HI\0N22$' 4J(KL`(a$bIj !F T>Y&$' 5Q(R$S &!*(+L9Y,Z([ *%r#)NN)NNN)__name__ __module__ __qualname____doc__rr&rCrMrPrTr]rerur{rr __classcell__)r!s@r"r r s]+ 2EIfHL#.0b;?"0HP*#/0$<>@r#r ctd0idtdddtdddtdddtdddtddgd  d tdd d tdd dtd dtddtddgddtddtd dtd dtd dtdddtddtdttdtdd tdttgd!d"tdtd#d$tdttgd!d%tdtd#d&tdttd"d%g'tdtd#d(tdttd td tdd)*+d,td-dd.d/g S)1z]This method provides parameters required for the ansible Storage Pool module on powerflexrFr;)requiredtyperrrrF)HDDSSD TRANSITIONAL)rrchoicesrGboolrHenable_zero_padding)rrep_cap_max_ratiointrmcache_write_handling_modeCached Passthrough)rdefaultspare_percentageenable_rebalanceenable_fragmentationenable_rebuildrR parallel_rebuild_rebalance_limitrr)rr)roptionsr}) unlimitedlimitNumOfConcurrentIos favorAppIosr)rhrmrorkrrw)rrVi )rr)rWrYrZstateTpresentabsentrcrr#r"rr.sK % NE:% Ne%8% N $U?% N"5u= % N U >@ % N%f5% N%f5% N!f-% NE*% N%)(M1JT\$]% N5)% N6*% N"v.% N(% N #E>!% N"*.5)9#% N$"vtU+#/812%% N*7;PT Waz{&*&6 $% 0Q273+% N2&*vt Wano&*&6 $% 0@2&33% N:,0VT!:M JK&*&6 $% 0F2,3;% NB!fdV$!v.E487:;C% NJDuy(6KLK% N%Nr#ceZdZdZy)StoragePoolExitHandlerc|r|j|d}||jd<|jjdi|jy)Nr(r\rr)rCrr exit_json)rpool_objr>s r"handlezStoragePoolExitHandler.handleZsH #44\RVEW4XL2>./!!!4HOO4r#Nrrrrrr#r"rrYs5r#rceZdZdZy)StoragePoolDeleteHandlerc|ddk(r5|r3d}tj||jj|t j ||y)Nrrz>Deleting storage pool is not supported through ansible module.r-)r6r7rr8rr)rrr_r>r.s r"rzStoragePoolDeleteHandler.handlecsK w 8 + %C IIcN OO % %# % . '',?r#Nrrr#r"rrbs@r#rceZdZdZy)*StoragePoolModifyPersistentChecksumHandlerc |ddk(rW|rU|dP|j||}|ik7r8|jjs|j||}d|jd<t j |||y#t$rI}dt|}tj||jj|Yd}~yd}~wwxYw) NrrrVr>r_Trz-Modify Persistent Checksum failed with error r-) rerrIr]rrrr:r;r6r7r8)rrr_r>rdrA error_msgs r"rz1StoragePoolModifyPersistentChecksumHandler.handlens 57#y0\45A$,$J$J%1$/%K%1M%*'99+3+K+K-9,7,L,9L6: 2 $ & - -h \ R 5''*1vh0I IIi OO % %) % 4 4  5sA:A== C?C  CNrrr#r"rrms5r#rceZdZdZy)1StoragePoolModifyRebalanceIOPriorityPolicyHandlerc |ddk(rv|rt|do|j||}|Z|jjs5|jjj |d|d|d|d }d |j d <tj|||y#t$rI}d t|}tj||jj| Yd}~yd}~wwxYw)Nrrrkrr(rhrirjrrhrmroTrz6Modify rebalance IO Priority Policy failed with error r-)rurrIr%r2rkrrrr:r;r6r7r8rrr_r>rsrArs r"rz8StoragePoolModifyRebalanceIOPriorityPolicyHandler.handles 57#y0\=>J"*"Q"Q%1$/#R#K#.'99+3+B+B+O+O+l+l0r_rr(rr)rcap_alert_high_thresholdcap_alert_critical_thresholdTrz=Modify Capacity Alert Thresholds operation failed with error r-)rrrIr%r2set_cap_alert_thresholdsrrrr:r;r6r7r8)rrr_r>rrArs r"rz6StoragePoolModifyCapacityAlertThresholdsHandler.handles 57#y0\56B ( L LZfYdXcQgYi!M!jI!B'99+3+B+B+O+O+h+h0rArs r"rz?StoragePoolModifyRebuildRebalanceParallelismLimitHandler.handles 57#y0\ABN#$FG<YELFF#??55'/'>'>'K'K's's(.K@b4c0d(f 15HOOI. ; = D DX{\h i 5''*1vh0I IIi OO % %) % 4 4  5BB C$?CC$Nrrr#r"rr5r#rceZdZdZy)0StoragePoolModifyRMCacheWriteHandlingModeHandlerc |ddk(rc|ra|d\|d|dk7rQ|jjs,|jjj |d|d}d|j d<t j|||y#t$rI}dt|}tj||jj| Yd}~yd}~wwxYw) NrrrrmcacheWriteHandlingModer(Trz5Modify RMCache Write Handling Mode failed with error r-) rrIr%r2set_rmcache_write_handling_moderrrr:r;r6r7r8rs r"rz7StoragePoolModifyRMCacheWriteHandlingModeHandler.handles 57#y0\<=I#$ABlSmFnn#??55'/'>'>'K'K'k'k(. ;OaCbfrtEgFDF#??55'/'>'>'K'K'`'`(.K@R4S0T(V 15HOOI. < > E EhP[]i j 5''*1vh0I IIi OO % %) % 4 4  5rNrrr#r"rr5r#rceZdZdZy)%StoragePoolEnableFragmentationHandlerc |ddk(rc|ra|d\|d|dk7rQ|jjs,|jjj |d|d}d|j d<t j|||y#t$rI}dt|}tj||jj| Yd}~yd}~wwxYw) NrrrfragmentationEnabledr(Trz9Enable/Disable Fragmentation operation failed with error r-) rrIr%r2set_fragmentation_enabledrrrr:r;r6r7r8rs r"rz,StoragePoolEnableFragmentationHandler.handle,s 57#y0\56B{SiGjnz|RoSHS#??55'/'>'>'K'K'e'e(. '>'K'K'_'_(. ;OaCbfrtFgGDG#??55'/'>'>'K'K'a'a(. '>'K'K'a'a(.K@S4T0U(W 15HOOI. - / 6 6xl [ 5''*1vh0I IIi OO % %) % 4 4  5rNrrr#r"rrerr#rceZdZdZy)#StoragePoolEnableZeroPaddingHandlerc |ddk(rc|ra|d\|d|dk7rQ|jjs,|jjj |d|d}d|j d<t j|||y#t$rI}dt|}tj||jj| Yd}~yd}~wwxYw) NrrrzeroPaddingEnabledr(Trz8Enable/Disable zero padding operation failed with error r-) rrIr%r2set_zero_padding_policyrrrr:r;r6r7r8rs r"rz*StoragePoolEnableZeroPaddingHandler.handleys 57#y0\45AkRgFhlxzNmOGO#??55'/'>'>'K'K'c'c(. X\hiu\v>v#??55'/'>'>'K'K'['[(. M0J(L 15HOOI. / 1 8 8;P\ ] 5''*1vh0I IIi OO % %) % 4 4  5rNrrr#r"rrrr#rceZdZdZy)StoragePoolUseRMCacheHandlerc |ddk(rc|ra|d\|d|dk7rQ|jjs,|jjj |d|d}d|j d<t j|||y#t$rI}dt|}tj||jj| Yd}~yd}~wwxYw) NrrrH useRmcacher(Trz,Modify RM cache operation failed with error r-) rrIr%r2set_use_rmcacherrrr:r;r6r7r8rs r"rz#StoragePoolUseRMCacheHandler.handles 57#y0\}-9k->X\hiu\v>v#??55'/'>'>'K'K'['[(. M0J(L 15HOOI. ( * 1 1(K V 5''*1vh0I IIi OO % %) % 4 4  5rNrrr#r"rrrr#rceZdZdZy)StoragePoolRenameHandlerc |ddk(rc|ra|d\|d|dk7rQ|jjs,|jjj |d|dd|j d<t j|||y#t$rI}dt|}tj||jj| Yd}~yd}~wwxYw) NrrrRr)r(Trz+Modify storage pool name failed with error r-) rrIr%r2renamerrrr:r;r6r7r8rs r"rzStoragePoolRenameHandler.handles 57#y0\67C TkHlp|~DqEIE#??55 //<<CCLQUDVXcd{X|}15HOOI. ( * 1 1(K V 5''*1vh0I IIi OO % %) % 4 4  5rNrrr#r"r r s5r#r ceZdZdZy)!StoragePoolModifyMediaTypeHandlerc |ddk(rZ|rX|V||dk7rN|jjs)|jjj |d|}d|j d<t j|||y#t$rI}dt|}tj||jj|Yd}~yd}~wwxYw) Nrr mediaTyper(Trz$Modify Media Type failed with error r-) rrIr%r2set_media_typerr rr:r;r6r7r8)rrr_r>rFrArs r"rz(StoragePoolModifyMediaTypeHandler.handles 57#y0\)jL'>'K'K'Z'Z(. (< 15HOOI. $ & - -h \ R 5''*1vh0I IIi OO % %) % 4 4  5sA=B C ?C  CNrrr#r"rrrr#rceZdZdZy)StoragePoolCreateHandlercD|ddk(r||z|jjsUtjd|dr|jj d|j |d|||d|d  }d |j d <tj||||y) NrrzCreating new storage poolrznstorage_pool_name is missing & name required to create a storage pool. Please enter a valid storage_pool_name.r-rrGrH)rKr<rFrGrHTr) rrIr6infor8rMrrr)rrr_r>r<rFs r"rzStoragePoolCreateHandler.handles w 9 ,1E??--4501KK))1*2 (;;)*=>) +M : +M : < < *.HOOI &)+228[,Xbcr#Nrrr#r"rrsdr#rceZdZdZy)StoragePoolHandlerc|j|d}|dk(rd}d}|ds|dr|j|d|dd}|j|d|d | }|j| t j |||||y) NrFrrErr)rrr(rr)rrr<)r>)rTr&rCrPrr)rrr_rFr<r>s r"rzStoragePoolHandler.handles))+ .  ''J - .+>V2W22%01G%H'23K'L3NNRTE 00M^A_CNObCc7<1>  ))|)D "))(KuV`ar#Nrrr#r"rrsbr#rctt}tj||jjy)zh Create PowerFlex storage pool object and perform action on it based on user input from playbookN)r rrrrO)objs r"mainrs)  CSZZ%6%67r#__main__N)-r __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicr`ansible_collections.dellemc.powerflex.plugins.module_utils.storage.dell.libraries.powerflex_baser_ansible_collections.dellemc.powerflex.plugins.module_utils.storage.dell.libraries.configurationrGansible_collections.dellemc.powerflex.plugins.module_utils.storage.dellr get_loggerr6r rrrrrrrrrrrrrrrrrrr rrrrrrr#r"r's` R@@ g RZ x^ @ 5e}%o=od (NV55@@55055655655655455(55(55&55(55&55&55&55&55&55&55$55&dd.bb$8 zFr#