dellemc.openmanage.redfish_storage_volume – Manages the storage volume configuration

Note

This plugin is part of the dellemc.openmanage collection (version 3.6.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 dellemc.openmanage.

To use it in a playbook, specify: dellemc.openmanage.redfish_storage_volume.

New in version 2.1.0: of dellemc.openmanage

Synopsis

This module allows to create, modify, initialize, or delete a single storage volume.

Requirements

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

python >= 2.7.5

Parameters

Parameter	Choices/Defaults	Comments
baseuri string / required		IP address of the target out-of-band controller. For example- <ipaddress>:<port>.
block_size_bytes integer		Block size in bytes.Only applicable when state is `present`.
capacity_bytes string		Volume size in bytes. Only applicable when state is `present`.
command string	Choices: initialize	`initialize` initializes an existing storage volume for a specified volume_id.
controller_id string		Fully Qualified Device Descriptor (FQDD) of the storage controller. For example- RAID.Slot.1-1. This option is mandatory when state is `present` while creating a volume.
drives list / elements=string		FQDD of the Physical disks. For example- Disk.Bay.0:Enclosure.Internal.0-1:RAID.Slot.1-1. Only applicable when state is `present` when creating a new volume.
encrypted boolean	Choices: no yes	Indicates whether volume is currently utilizing encryption or not. Only applicable when state is `present`.
encryption_types string	Choices: NativeDriveEncryption ControllerAssisted SoftwareAssisted	The following encryption types can be selected. `ControllerAssisted` The volume is encrypted by the storage controller entity. `NativeDriveEncryption` The volume utilizes the native drive encryption capabilities of the drive hardware. `SoftwareAssisted` The volume is encrypted by the software running on the system or the operating system. Only applicable when state is `present`.
initialize_type string	Choices: Fast ← Slow	Initialization type of existing volume. Only applicable when command is `initialize`.
name string		Name of the volume to be created. Only applicable when state is `present`.
oem dictionary		Includes OEM extended payloads. Only applicable when state is present.
optimum_io_size_bytes integer		Stripe size value must be in multiples of 64 * 1024. Only applicable when state is `present`.
password string / required		Password of the target out-of-band controller.
state string	Choices: present absent	`present` creates a storage volume for the specified I (controller_id), or modifies the storage volume for the specified I (volume_id). "Note: Modification of an existing volume properties depends on drive and controller capabilities". `absent` deletes the volume for the specified volume_id.
username string / required		Username of the target out-of-band controller.
volume_id string		FQDD of existing volume. For example- Disk.Virtual.4:RAID.Slot.1-1. This option is mandatory in the following scenarios, state is `present`, when updating a volume. state is `absent`, when deleting a volume. command is `initialize`, when initializing a volume.
volume_type string	Choices: NonRedundant Mirrored StripedWithParity SpannedMirrors SpannedStripesWithParity	One of the following volume types must be selected to create a volume. `Mirrored` The volume is a mirrored device. `NonRedundant` The volume is a non-redundant storage device. `SpannedMirrors` The volume is a spanned set of mirrored devices. `SpannedStripesWithParity` The volume is a spanned set of devices which uses parity to retain redundant information. `StripedWithParity` The volume is a device which uses parity to retain redundant information.

Notes

Note

Run this module from a system that has direct access to Redfish APIs.
This module does not support check_mode.

Examples

---
- name: Create a volume with supported options
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    volume_type: "Mirrored"
    name: "VD0"
    controller_id: "RAID.Slot.1-1"
    drives:
      - Disk.Bay.5:Enclosure.Internal.0-1:RAID.Slot.1-1
      - Disk.Bay.6:Enclosure.Internal.0-1:RAID.Slot.1-1
    block_size_bytes: 512
    capacity_bytes: 299439751168
    optimum_io_size_bytes: 65536
    encryption_types: NativeDriveEncryption
    encrypted: true

- name: Create a volume with minimum options
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    controller_id: "RAID.Slot.1-1"
    volume_type: "NonRedundant"
    drives:
       - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-1

- name: Modify a volume's encryption type settings
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    volume_id: "Disk.Virtual.5:RAID.Slot.1-1"
    encryption_types: "ControllerAssisted"
    encrypted: true

- name: Delete an existing volume
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "absent"
    volume_id: "Disk.Virtual.5:RAID.Slot.1-1"

- name: Initialize an existing volume
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    command: "initialize"
    volume_id: "Disk.Virtual.6:RAID.Slot.1-1"
    initialize_type: "Slow"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
error_info dictionary	on http error	Details of a http error. Sample: {'error': {'@Message.ExtendedInfo': [{'Message': 'Unable to perform configuration operations because a configuration job for the device already exists.', 'MessageArgs': [], 'MessageArgs@odata.count': 0, 'MessageId': 'IDRAC.1.6.STOR023', 'RelatedProperties': [], 'RelatedProperties@odata.count': 0, 'Resolution': 'Wait for the current job for the device to complete or cancel the current job before attempting more configuration operations on the device.', 'Severity': 'Informational'}], 'code': 'Base.1.2.GeneralError', 'message': 'A general error has occurred. See ExtendedInfo for more information'}}
msg string	always	Overall status of the storage configuration operation. Sample: Successfully submitted create volume task.
task dictionary	success	Returns ID and URI of the created task. Sample: {'id': 'JID_XXXXXXXXXXXXX', 'uri': '/redfish/v1/TaskService/Tasks/JID_XXXXXXXXXXXXX'}

Authors

Sajna Shetty(@Sajna-Shetty)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/openmanage/redfish_storage_volume_module.html

Docs

Docs4dev

Title here