hitachivantara.vspone_block.sds_block.hv_sds_block_snapshot module – Manages snapshots on Hitachi SDS Block storage systems.

Note

This module is part of the hitachivantara.vspone_block collection (version 4.1.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.sds_block.hv_sds_block_snapshot.

New in hitachivantara.vspone_block 4.1.0

Synopsis

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.

connection_type

string

Type of connection to the storage system.

Choices:

  • "direct" ← (default)

password

string / required

Password for authentication. This is a required field.

username

string / required

Username for authentication. This is a required field.

spec

dictionary / required

Specification for the snapshot operation.

master_volume_id

string

The ID of the master volume.

master_volume_name

string

The name of the master volume.

name

string

The name of the snapshot.

operation_type

string

The type of snapshot operation.

Choices:

  • "prepare_and_finalize"

  • "prepare"

  • "finalize"

qos

dictionary

QoS settings for the snapshot.

upper_alert_allowable_time

integer

Upper alert allowable time.

upper_limit_for_iops

integer

Upper limit for IOPS.

upper_limit_for_transfer_rate

integer

Upper limit for transfer rate.

snapshot_volume_id

string

The ID of the snapshot volume.

snapshot_volume_name

string

The name of the snapshot volume.

vps_id

string

The ID of the VPS.

vps_name

string

The name of the VPS.

state

string

The desired state of the snapshot.

Choices:

  • "present" ← (default)

  • "absent"

  • "restore"

Attributes

Attribute

Support

Description

check_mode

Support: none

Determines if the module should run in check mode.

Examples

- name: Create a snapshot (present)
  hitachivantara.vspone_block.sds_block.hv_sds_block_snapshot:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    state: "present"
    spec:
      name: "snapshot1"
      master_volume_name: "volume1"
      operation_type: "prepare_and_finalize"

- name: Delete a snapshot (absent)
  hitachivantara.vspone_block.sds_block.hv_sds_block_snapshot:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    state: "absent"
    spec:
      snapshot_volume_name: "snapshot1"

- name: Restore a snapshot (restore)
  hitachivantara.vspone_block.sds_block.hv_sds_block_snapshot:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    state: "restore"
    spec:
      snapshot_volume_name: "snapshot1"

Authors

  • Hitachi Vantara LTD (@hitachi-vantara)