hitachivantara.vspone_block.vsp.hv_ddp_pool_facts module – Get facts of DDP Pools on VSP block storage systems.

Note

This module is part of the hitachivantara.vspone_block collection (version 4.8.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install hitachivantara.vspone_block. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: hitachivantara.vspone_block.vsp.hv_ddp_pool_facts.

New in hitachivantara.vspone_block 3.4.0

Synopsis
Requirements
Parameters
Attributes
Notes
Examples
Returned Facts

Synopsis

- This module retrieves details of DDP Pools on VSP block storage systems. - This module is supported only when the storage system is VSP One Block 20. - For examples go to URL https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/ddp_pool_facts.yml

Requirements

The below requirements are needed on the host that executes this module.

python >= 3.9

Parameters

Parameter	Comments
connection_info dictionary / required	Information required to establish a connection to the storage system.
address string / required	IP address or hostname of the storage system.
api_token string	Token used to operate on locked resources.
password string	Password for authentication. This is a required field.
username string	Username for authentication. This is a required field.
spec dictionary	Specification for retrieving DDP pool information.
pool_id integer	ID of the DDP Pool. Required for the Get DDP pool information using pool_id task.
pool_name string	Name of the DDP Pool. Required for the Get DDP pool information using pool_name task.

Attributes

Attribute	Support	Description
check_mode	Support: full	Determines if the module should run in check mode.

Notes

Note

Connection type gateway was removed starting from version 3.4.0. Please use an earlier version if you require this connection type.
This module is not supported for VSP One BHE and higher storage models.

Examples

- name: Get all DDP Pools
  hitachivantara.vspone_block.vsp.hv_ddp_pool_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"

- name: Get DDP Pool by ID
  hitachivantara.vspone_block.vsp.hv_ddp_pool_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    spec:
      pool_id: 15

- name: Get DDP Pool by Name
  hitachivantara.vspone_block.vsp.hv_ddp_pool_facts:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "password"
    spec:
      pool_name: "DDP-1"

Returned Facts

Facts returned by this module are added/updated in the hostvars host facts and can be referenced by name just like any other host fact. They do not need to be registered in order to use them.

Key	Description
DDP_Pools list / elements=dictionary	A list of DDP pool information. Returned: success
capacity_manage dictionary	Capacity management details. Returned: success
threshold_depletion integer	Threshold for capacity depletion. Returned: success
threshold_warning integer	Threshold for capacity warning. Returned: success
used_capacity_rate integer	Used capacity rate. Returned: success
config_status list / elements=string	Configuration status of the pool. Returned: success
contains_capacity_saving_volume boolean	Indicates if the pool contains capacity-saving volumes. Returned: success
drives list / elements=dictionary	Details of the drives in the pool. Returned: success
display_drive_capacity string	Display capacity of the drive. Returned: success
drive_capacity_gb integer	Capacity of the drive in GB. Returned: success
drive_interface string	Interface type of the drive. Returned: success
drive_rpm string	Drive RPM. Returned: success
drive_type string	Type of the drive. Returned: success
locations list / elements=string	Locations of the drives. Returned: success
number_of_drives integer	Number of drives. Returned: success
parity_group_type string	Parity group type. Returned: success
raid_level string	RAID level. Returned: success
total_capacity_mb integer	Total capacity of the drives in MiB. Returned: success
effective_capacity_mb integer	Effective capacity of the pool in MiB. Returned: success
encryption string	Encryption status of the pool. Returned: success
free_capacity_mb integer	Free capacity of the pool in MiB. Returned: success
id integer	ID of the DDP Pool. Returned: success
name string	Name of the DDP Pool. Returned: success
number_of_drive_types integer	Number of drive types in the pool. Returned: success
number_of_tiers integer	Number of tiers in the pool. Returned: success
number_of_volumes integer	Number of volumes in the pool. Returned: success
saving_effects dictionary	Details of saving effects in the pool. Returned: success
calculation_end_time string	End time of the calculation. Returned: success
calculation_start_time string	Start time of the calculation. Returned: success
data_reduction_without_system_data integer	Data reduction without system data. Returned: success
data_reduction_without_system_data_status string	Status of data reduction without system data. Returned: success
efficiency_data_reduction integer	Efficiency of data reduction. Returned: success
efficiency_fmd_saving integer	Efficiency of FMD saving. Returned: success
is_total_efficiency_support boolean	Indicates if total efficiency is supported. Returned: success
post_capacity_fmd_saving integer	Post-capacity FMD saving. Returned: success
pre_capacity_fmd_saving integer	Pre-capacity FMD saving. Returned: success
software_saving_without_system_data integer	Software saving without system data. Returned: success
software_saving_without_system_data_status string	Status of software saving without system data. Returned: success
total_efficiency integer	Total efficiency of the pool. Returned: success
total_efficiency_status string	Status of total efficiency. Returned: success
status string	Status of the pool. Returned: success
subscription_limit dictionary	Subscription limit details. Returned: success
current_rate integer	Current subscription rate. Returned: success
is_enabled boolean	Indicates if subscription limit is enabled. Returned: success
tiers list / elements=dictionary	Details of the tiers in the pool. Returned: success
total_capacity_mb integer	Total capacity of the pool in MiB. Returned: success
used_capacity_mb integer	Used capacity of the pool in MiB. Returned: success

Authors

Hitachi Vantara, LTD. (@hitachi-vantara)

Collection links

© 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/hitachivantara/vspone_block/vsp.hv_ddp_pool_facts_module.html