hitachivantara.vspone_block.vsp.hv_resource_group module – Manages resource groups on VSP block storage systems.

Note

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

New in hitachivantara.vspone_block 3.2.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.

api_token

string

Token used to operate on locked resources.

connection_type

string

Type of connection to the storage system.

Choices:

  • "direct" ← (default)

password

string

Password for authentication. This is a required field.

username

string

Username for authentication. This is a required field.

spec

dictionary / required

Specification for the resource group.

add_resource_time_out_in_sec

integer

Timeout for an add resource operation. The default timeout is 300 seconds.

end_ldev

string

Last LDEV number. If you specify this attribute, you must also specify start_ldev. If you specify ldevs, you cannot specify this attribute. Required for add/remove LDEVs using LDEV range by ID.

external_parity_groups

list / elements=string

List of external parity groups to be added or removed from the resource group.

force

boolean

For delete operations, specifies if the operation should be forced. Optional for Delete a Resource Group by ID forcefully.

Choices:

  • false ← (default)

  • true

host_groups

list / elements=dictionary

List of host groups to be added or removed from the resource group. Required for Create, Add, or Remove operations involving host groups.

name

string / required

Name of the host group. Required for create/add/remove operations involving host groups.

port

string / required

Port name associated with the host group. Required for create/add/remove operations involving host groups.

id

integer

The ID of the resource group. Optional for the following tasks: - Add the following resources to an existing Resource Group by ID: LDEVs, ports, host groups, NVM subsystem IDs - Remove the following resources from an existing Resource Group by ID: LDEVs, ports, host groups, NVM subsystem IDs - Delete a Resource Group by ID - Delete a Resource Group by ID forcefully Required for the following tasks: - Add LDEVs using LDEV range to an existing Resource Group by ID - Remove LDEVs using LDEV range from an existing Resource Group by ID

iscsi_targets

list / elements=dictionary

List of iSCSI targets to be added or removed from the resource group. Optional for add/remove operations by Name.

name

string / required

Name of the iSCSI target. Required for add/remove operations by Name.

port

string / required

Port name associated with the iSCSI target. Required for add/remove operations by Name.

ldevs

list / elements=string

List of LDEVs to be added or removed from the resource group. Optional for the Create a Resource Group with LDEVs or with the following resources: LDEVs, parity groups, ports, host groups, NVM subsystem IDs. Also used for add/remove operations by ID or Name.

name

string

The name of the resource group. Required for the following tasks: - Create a Resource Group without any resources - Create a Resource Group with virtual storage serial number of VSM - Create a Resource Group with LDEVs - Create a Resource Group with the following resources: LDEVs, parity groups, ports, host groups, NVM subsystem IDs - Create a Resource Group with storage pool IDs and parity groups - Add the following resources to an existing Resource Group by Name: LDEVs, ports, host groups, iSCSI targets - Remove the following resources from an existing Resource Group by Name: LDEVs, ports, host groups, iSCSI targets - Delete a Resource Group by Name

nvm_subsystem_ids

list / elements=integer

List of NVM subsystem IDs to be added or removed from the resource group. Optional for Create or Add/Remove operations by ID.

parity_groups

list / elements=string

List of parity groups to be added or removed from the resource group. Optional for the Create a Resource Group with LDEVs, parity groups, ports, host groups, NVM subsystem IDs, or with storage pool IDs.

ports

list / elements=string

List of ports to be added or removed from the resource group. Optional for Create or Add/Remove operations by ID or Name.

start_ldev

string

First LDEV number. If you specify this attribute, you must also specify end_ldev. If you specify ldevs, you cannot specify this attribute. Required for add/remove LDEVs using LDEV range by ID.

state

string

- Operation to be performed on the resources in the resource group. - add_resource- To add resources to the resource group. - remove_resource - To remove resources from the resource group.

Choices:

  • "add_resource" ← (default)

  • "remove_resource"

storage_pool_ids

list / elements=integer

Pool volumes to be added or removed from the resource group. Optional for Create a Resource Group with storage pool IDs and parity groups.

virtual_storage_model

string

Virtual storage model name associated with the resource group. Required for the Create a Resource Group with virtual storage serial number of VSM task.

Choices:

  • "VSP_5100H"

  • "VSP_5200H"

  • "VSP_5500H"

  • "VSP_5600H"

  • "VSP_5100"

  • "VSP_5200"

  • "VSP_5500"

  • "VSP_5600"

  • "VSP_E1090"

  • "VSP_E590"

  • "VSP_E790"

  • "VSP_E990"

  • "VSP_F350"

  • "VSP_F370"

  • "VSP_F400"

  • "VSP_F600"

  • "VSP_F700"

  • "VSP_F800"

  • "VSP_F900"

  • "VSP_G130"

  • "VSP_G150"

  • "VSP_G200"

  • "VSP_G350"

  • "VSP_G370"

  • "VSP_G400"

  • "VSP_G600"

  • "VSP_G700"

  • "VSP_G800"

  • "VSP_G900"

  • "VSP_ONE_B28"

  • "VSP_ONE_B26"

  • "VSP_ONE_B24"

  • "VSP_ONE_B85"

  • "VSP_E790H"

  • "VSP_E590H"

  • "VSP_G1000"

  • "VSP_G1500"

  • "VSP_F1500"

  • "VSP_E1090H"

virtual_storage_serial

string

Virtual storage serial number associated with the resource group. Required for the Create a Resource Group with virtual storage serial number of VSM task.

state

string

The desired state of the resource group task.

Choices:

  • "present" ← (default)

  • "absent"

storage_system_info

dictionary

Information about the storage system. This field is optional.

serial

string

The serial number of the storage system.

Attributes

Attribute

Support

Description

check_mode

Support: none

Determines if the module should run in check mode.

Notes

Note

  • If any resource is locked in the target storage system, the operations related to resource groups cannot be performed. In such cases, unlock the resources before running resource group related operations.

  • Connection type gateway was removed starting from version 3.4.0. Please use an earlier version if you require this connection type.

Examples

- name: Create a Resource Group with virtual storage serial number of VSM
  hitachivantara.vspone_block.vsp.hv_resource_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      name: "my_resource_group_1"
      virtual_storage_serial: "69200"
      virtual_storage_model: "VSP G370"

- name: Get Resource Group by name
  hitachivantara.vspone_block.vsp.hv_resource_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      name: "my_resource_group"

- name: Create a Resource Group with LDEVs, parity groups, ports, and host groups
  hitachivantara.vspone_block.vsp.hv_resource_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      ldevs: [1, 2, 3]
      parity_groups: ["PG1", "PG2"]
      ports: ["CL1-A", "CL1-C"]
      host_groups:
        - port: "CL1-A"
          name: "my_host_group_1"
        - port: "CL1-A"
          name: "my_host_group_2"

- name: Add resources to an existing Resource Group by ID
  hitachivantara.vspone_block.vsp.hv_resource_group:
    connection_info:
    address: storage1.company.com
    username: "admin"
    password: "secret"
    spec:
    state: add_resource
    id: 4
    ldevs: [3, 4]
    host_groups:
      - port: "CL1-A"
        name: "my_host_group_3"
    iscsi_targets:
      - port: "CL1-C"
        name: "my_iscsi_target_2"

- name: Remove resources from an existing Resource Group by ID
  hitachivantara.vspone_block.vsp.hv_resource_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      id: 4
      state: remove_resource
      ldevs: [3, 4]
      host_groups:
        - port: "CL1-A"
          name: "my_host_group_3"
      iscsi_targets:
        - port: "CL1-C"
          name: "my_iscsi_target_2"

- name: Delete a Resource Group by ID forcefully
  hitachivantara.vspone_block.vsp.hv_resource_group:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    state: absent
    spec:
      id: 4
      force: true

Return Values

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

Key

Description

resource_groups

list / elements=dictionary

The resource group information.

Returned: always

host_groups

list / elements=dictionary

List of host groups in the resource group.

Returned: success

id

integer

The ID of the host group.

Returned: success

Sample: 1

name

string

The name of the host group.

Returned: success

Sample: "my_host_group_1"

port

string

The port name associated with the host group.

Returned: success

Sample: "CL1-A"

id

integer

The ID of the resource group.

Returned: success

Sample: 4

iscsi_targets

list / elements=dictionary

List of iSCSI targets in the resource group.

Returned: success

id

integer

The ID of the iSCSI target.

Returned: success

Sample: 1

name

string

The name of the iSCSI target.

Returned: success

Sample: "my_iscsi_target_1"

port

string

The port name associated with the iSCSI target.

Returned: success

Sample: "CL1-C"

ldevs

list / elements=integer

List of LDEVs in the resource group.

Returned: success

Sample: [1, 2, 3]

ldevs_hex

list / elements=string

List of LDEVs in hexadecimal format in the resource group.

Returned: success

Sample: ["0x1", "0x2", "0x3"]

lock_status

string

The lock status of the resource group.

Returned: success

Sample: "Unlocked"

name

string

The name of the resource group.

Returned: success

Sample: "my_resource_group"

parity_groups

list / elements=string

List of parity groups in the resource group.

Returned: success

Sample: ["PG1", "PG2"]

ports

list / elements=string

List of ports in the resource group.

Returned: success

Sample: ["CL1-A", "CL1-C"]

virtual_storage_id

integer

The virtual storage ID associated with the resource group.

Returned: success

Sample: 200

virtual_storage_serial

string

The virtual storage serial number associated with the resource group.

Returned: success

Sample: "69200"

Authors

  • Hitachi Vantara LTD (@hitachi-vantara)