hitachivantara.vspone_block.vsp.hv_vsp_one_volume_facts module – Retrieves facts about Hitachi VSP One storage system volumes.

Note

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

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_vsp_one_volume_facts.

New in hitachivantara.vspone_block 4.2.0

Synopsis

• This module gathers information about volumes in Hitachi VSP One storage systems.

• It supports filtering by pool, server, volume nickname, capacity, and volume ID.

• For usage examples, see https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/vsp_one_volume_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 the volume task.
count integer	Number of volumes.
max_total_capacity string	Maximum total capacity.
max_used_capacity string	Maximum used capacity.
min_total_capacity string	Minimum total capacity.
min_used_capacity string	Minimum used capacity.
nickname string	Nickname of the volume.
pool_id integer	ID of the pool.
pool_name string	Name of the pool. if both pool_id is present, it will ignore this parameter.
server_id integer	ID of the server.
server_nickname string	Nickname of the server. if both server_id is present, it will ignore this parameter.
start_volume_id integer	Starting volume ID.
volume_id integer	ID of the volume.

Attributes

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

Examples

- name: Get facts for volumes in a specific pool by pool_id
  hitachivantara.vspone_block.vsp.hv_vsp_one_volume_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      pool_id: 101

- name: Get facts for volumes in a specific pool by pool_name
  hitachivantara.vspone_block.vsp.hv_vsp_one_volume_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      pool_name: "SP01"

- name: Get facts for volumes attached to a server by server_id
  hitachivantara.vspone_block.vsp.hv_vsp_one_volume_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      server_id: 2001

- name: Get facts for volumes attached to a server by server_nickname
  hitachivantara.vspone_block.vsp.hv_vsp_one_volume_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      server_nickname: "ComputeNode-1"

- name: Get facts for a volume by nickname
  hitachivantara.vspone_block.vsp.hv_vsp_one_volume_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      nickname: "RD-volume-0004"

- name: Get facts for volumes with capacity filters
  hitachivantara.vspone_block.vsp.hv_vsp_one_volume_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      min_total_capacity: 100
      max_total_capacity: 500
      min_used_capacity: 50
      max_used_capacity: 400

- name: Get facts for a range of volumes by start_volume_id and count
  hitachivantara.vspone_block.vsp.hv_vsp_one_volume_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      start_volume_id: 1000
      count: 10

- name: Get facts for a specific volume by volume_id
  hitachivantara.vspone_block.vsp.hv_vsp_one_volume_facts:
    connection_info:
      address: vsp.company.com
      username: "admin"
      password: "password"
    spec:
      volume_id: 12345

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
volumes list / elements=dictionary	List of volume information objects. Returned: success
capacity_saving_status string	Capacity saving status. Returned: success
compression_acceleration boolean	Whether compression acceleration is enabled. Returned: success
compression_acceleration_status string	Compression acceleration status. Returned: success
free_capacity integer	Free capacity of the volume. Returned: success
free_capacity_in_mb string	Free capacity in MB. Returned: success
id integer	ID of the volume. Returned: success
is_data_reduction_share_enabled boolean	Whether data reduction share is enabled. Returned: success
luns list / elements=dictionary	List of LUNs associated with the volume. Returned: success
nickname string	Nickname of the volume. Returned: success
number_of_connecting_servers integer	Number of servers connected to the volume. Returned: success
number_of_snapshots integer	Number of snapshots for the volume. Returned: success
pool_id integer	ID of the pool. Returned: success
pool_name string	Name of the pool. Returned: success
qos_settings dictionary	QoS settings for the volume. Returned: success
reserved_capacity integer	Reserved capacity of the volume. Returned: success
saving_setting string	Saving setting (e.g., COMPRESSION). Returned: success
total_capacity integer	Total capacity of the volume. Returned: success
total_capacity_in_mb string	Total capacity in MB. Returned: success
used_capacity integer	Used capacity of the volume. Returned: success
used_capacity_in_mb string	Used capacity in MB. Returned: success
volume_types list / elements=string	List of volume types. Returned: success

Authors

• Hitachi Vantara LTD (@hitachi-vantara)

Collection links

• Issue Tracker
• Repository (Sources)