powermax_storagegroup (Data Source)

Data Source for reading StorageGroups in PowerMax array. PowerMax storage groups are a collection of devices that are stored on the array. An application, a server, or a collection of servers use them.

Example Usage

/*
Copyright (c) 2023 Dell Inc., or its subsidiaries. All Rights Reserved.

Licensed under the Mozilla Public License Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://mozilla.org/MPL/2.0/


Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

# This terraform DataSource is used to query the existing storagegroup from PowerMax array.
# The information fetched from this data source can be used for getting the details / for further processing in resource block.

# Returns all of the PowerMax storage groups and their details
data "powermax_storagegroup" "testall" {
  # Optional Update the read timeout with (XXm) for minutes or (XXs) for timeout in seconds
  # If unset defaults to 2 minute timeout
  # timeouts = {
  #   read = "3m"
  # }
}

output "storagegroup_data_all" {
  value = data.powermax_storagegroup.testall
}

# Returns a subset of the PowerMax storage groups based on the names provided in the `names` filter block and their details
data "powermax_storagegroup" "test" {
  # Optional Update the read timeout with (XXm) for minutes or (XXs) for timeout in seconds
  # If unset defaults to 2 minute timeout
  # timeouts = {
  #   read = "3m"
  # }

  # Optional list of names to filter upon
  filter {
    names = ["example_sg"]
  }
}

output "storagegroup_data" {
  value = data.powermax_storagegroup.test
}

# After the successful execution of above said block, We can see the output value by executing 'terraform output' command.
# Also, we can use the fetched information by the variable data.powermax_storagegroup.example

Schema

Optional

filter (Block, Optional) (see below for nested schema)
timeouts (Attributes) (see below for nested schema)

Read-Only

id (String) Placeholder value to run tests
storage_groups (Attributes List) List of storage group attributes (see below for nested schema)

Nested Schema for `filter`

Optional:

names (Set of String)

Nested Schema for `timeouts`

Optional:

read (String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as “30s” or “2h45m”. Valid time units are “s” (seconds), “m” (minutes), “h” (hours).

Nested Schema for `storage_groups`

Read-Only:

cap_gb (Number) The capacity of the storage group
child_storage_group (List of String) The child storage group(s) associated with the storage group
compression (Boolean) States whether compression is enabled on storage group
compression_ratio (String) States whether compression is enabled on storage group
compression_ratio_to_one (Number) Compression ratio numeric value of the storage group
device_emulation (String) The emulation of the volumes in the storage group
host_io_limit (Object) Host IO limit of the storage group (see below for nested schema)
id (String) The ID of the storage group
maskingview (List of String) The masking views associated with the storage group
name (String) The name of the storage group
num_of_child_sgs (Number) The number of child storage groups associated with the storage group
num_of_masking_views (Number) The number of masking views associated with the storage group
num_of_parent_sgs (Number) The number of parent storage groups associated with the storage group
num_of_snapshot_policies (Number) The number of snapshot policies associated with the storage group
num_of_snapshots (Number) The number of snapshots associated with the storage group
num_of_vols (Number) The number of volumes associated with the storage group
parent_storage_group (List of String) The parent storage group(s) associated with the storage group
service_level (String) The service level associated with the storage group
slo (String) The service level associated with the storage group
slo_compliance (String) The service level compliance status of the storage group
snapshot_policies (List of String) The snapshot policies associated with the storage group
srp_id (String) The SRP to be associated with the Storage Group. An existing SRP or ’none’ must be specified
tags (String) The tags associated with the storage group
type (String) The storage group type
unprotected (Boolean) States whether the storage group is protected
unreducible_data_gb (Number) The amount of unreducible data in Gb.
uuid (String) Storage Group UUID
volume_ids (List of String) The IDs of the volume associated with the storage group.
vp_saved_percent (Number) VP saved percentage figure
workload (String) The workload associated with the storage group

Nested Schema for `storage_groups.host_io_limit`