Dell Technologies – Terraform Providers

V1.0.4: Support

Mon, 01 Jan 0001 00:00:00 +0000

For all your support needs or to follow the latest ongoing discussions and updates, join our Slack group. Click Here to request your invite.

You can also interact with us on GitHub by creating a GitHub Issue.

V1.0.4: ReadMe

Mon, 01 Jan 0001 00:00:00 +0000

Terraform Provider for Dell Technologies PowerMax

The Terraform Provider for Dell Technologies (Dell) PowerMax allows Data Center and IT administrators to use Hashicorp Terraform to automate and orchestrate the provisioning and management of Dell PowerMax storage systems.

The Terraform Provider can be used to manage volumes, storage groups, port groups, hosts, host groups and masking views.

Support

For any Terraform Provider for Dell PowerMax issues, questions or feedback, please follow our support process

License

The Terraform Provider for Dell PowerMax is released and licensed under the MPL-2.0 license. See LICENSE for the full terms.

Prerequisites

Terraform Provider	PowerMax Unisphere Version	OS	Terraform	Golang
v1.0.4	10.2 10.1	ubuntu22.04.x rhel9.x	1.14.x 1.15.x	1.25.x

List of DataSources in Terraform Provider for Dell PowerMax

List of Resources in Terraform Provider for Dell PowerMax

Installation and execution of Terraform Provider for Dell PowerMax

The installation and execution steps of Terraform Provider for Dell PowerMax can be found here.

Releasing, Maintenance and Deprecation

Terraform Provider for Dell Technnologies PowerMax follows Semantic Versioning.

New versions will be release regularly if significant changes (bug fix or new feature) are made in the provider.

Released code versions are located on tags in the form of “vx.y.z” where x.y.z corresponds to the version number.

V1.0.4: Installation Guide

Mon, 01 Jan 0001 00:00:00 +0000

Installation of Terraform Provider for Dell PowerMax

Installation from public repository

The PowerMax Provider can be found on the Terraform Registry here

The provider will be fetched from the public repository and installed by Terraform automatically. Create a file called main.tf in your workspace with the following contents

terraform {
  required_providers {
    powermax = { 
      version = "1.0.0"
      source = "registry.terraform.io/dell/powermax"
    }
  }
}

Then, in that workspace, run

terraform init

Installation from source code

Clone this repo
In the root of this repo run

make install

Then follow installation from public repo

Usage

Once you have installed the PowerMax provider, you can start using it in your Terraform configuration files. The provider has a number of resources that you can use to manage your PowerMax storage arrays.

For example, you can use the powermax_storagegroup resource to create a new storage group:

resource "powermax_storagegroup" "test" {
  name             = "terraform_sg"
  srp_id           = "SRP_1"
  slo              = "Gold"
  host_io_limit = {
    host_io_limit_io_sec = "1000"
    host_io_limit_mb_sec = "1000"
    dynamic_distribution  = "Never"
  }
}

For more resources, please refer to Product Guide

SSL Certificate Verification

For SSL verifcation on RHEL, below steps can be performed:

Copy the CA certificate to the /etc/pki/ca-trust/source/anchors path of the host by any external means.
Import the SSL certificate to host by running

update-ca-trust extract

V1.0.4: Release Notes

Mon, 01 Jan 0001 00:00:00 +0000

Terraform Provider for Dell PowerMax

Release Notes 1.0.4

© 2026 Dell Inc. or its subsidiaries. All rights reserved. Dell, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be trademarks of their respective owners.

Content

This release note contains supplemental information about Terraform Provider for Dell PowerMax.

Revision history

The table in this section lists the revision history of this document.

Table 1. Revision history

Revision	Date	Description
01	September 2023	Release of Terraform Provider for Dell PowerMax 1.0.0
02	December 2023	Patch release of Terraform Provider for Dell PowerMax 1.0.1
03	March 2024	Patch release of Terraform Provider for Dell PowerMax 1.0.2
04	May 2025	Patch release of Terraform Provider for Dell PowerMax 1.0.3
05	June 2026	Patch release of Terraform Provider for Dell PowerMax 1.0.4

Product Description

The Terraform Provider for Dell PowerMax allows Data Center and IT administrators to use Hashicorp Terraform to automate and orchestrate the provisioning and management of Dell PowerMax storage systems.

The Terraform Provider can be used to manage hosts, host groups, masking views, port groups, storage groups, snapshots, snapshot policies, ports and volumes.

New features & enhancement

Addressed security vulnerablities in PowerMax dependencies.
Added BlackDuck security fixes
Fixed OpenAPI spec and client zip issues
Added clarification to endpoint variable

Limitations

There are no known limitations.

Distribution

The software package is available for download from the Official Terraform Registry as well as from the Terraform Provider for PowerMax GitHub page.

Documentation

Readme

Product Guide

V1.0.4: Licensing

Mon, 01 Jan 0001 00:00:00 +0000

Terraform Provider is released and licensed under the MPL 2.0 license.

V1.0.4: Creating Multiple Volumes

Mon, 01 Jan 0001 00:00:00 +0000

You can use the for_each meta-argument to create multiple volumes.

Example

To create 3 different volumes using terraform_for_each using the following configuration:

resource "powermax_volume" "test" {
  for_each = toset(["vol_1", "vol_2", "vol_3"])
  vol_name = each.key
  size = 2.45
  sg_name = "terraform_sg"
  cap_unit = "GB"
}

You can use the count meta-argument to create multiple volumes.

Example

To create 3 different volumes using the following configuration:

resource "powermax_volume" "test" {
  count = 3
  vol_name = "terraform_volume-${count.index}"
  size = 2.45
  sg_name = "terraform_sg"
  cap_unit = "GB"
}

V1.0.4: Environment Variables

Mon, 01 Jan 0001 00:00:00 +0000

Environment Variables Overview

This Guide will describe two common ways on how to use environment variables with terraform. For more information you may check out the terraform docs directly.

Export or Directly Set During Terraform Command

This section will desribe how to pass in environment variables directly during the terraform command.

main.tf

// Create a variable which will be assigned during the command
variable "foo" {
  type = string
}

data "example_datasource" "all" {
  filter {
    // Reference that variable how you would normally in terraform 
    name = [var.foo]
  }
}

Using the above example, to set the environment variable for foo you must use the prefix of TF_VAR_ + the name of the variable i.e: TF_VAR_foo. This will translate to setting the variable during the command.

Example Command: TF_VAR_foo="example-name" terraform plan

Export and then run the terraform command

export TF_VAR_foo="example-name"

This will execute terraform plan with the value of example-name for the variable foo.

Using the External Terraform Provider

This section will describe how to use environment variables using the external terraform provider

env.sh

cat << EOF
{
 "foo": "test"
}
EOF

main.tf

terraform {
  required_providers {
    external = {
      source = "hashicorp/external"
      version = "2.3.4"
    }
  }
}

# Run the script to get the environment variables of interest.
# This is a datasource, so it will run at plan time.
data "external" "env" {
  program = ["bash", "env.sh"]
}

# Show the results of running the datasource. This is a map of environment
# variable names to their values.
output "env" {
  value = data.external.env.result
}

data "example_datasource" "all" {
  filter {
    name = [data.external.env.result["foo"]]
  }
}

In this example there are 2 files.

env.sh This creates the input for the environment variables you would like to pass into and use in the terraform configuration main.tf
main.tf this defines the external datasource which takes in the output from the external datasource and then it can be used in the example_datasource filter i.e data.external.env.result["foo"]

V1.0.4: How to use our Provider

Mon, 01 Jan 0001 00:00:00 +0000

This provider gives Terraform the ablility to work with a PowerMax Storage System. It can be used to manage many aspects of the PowerMax including hosts, host groups, masking views, port groups, snapshots, storage groups and volumes. For more information about each particular resource or datasource view those specific examples and documentation.

Below is an example of the PowerMax Provider and how to use it.

Example

The following example demonstrates basic usage of the provider to provision a volume to a storage group.

terraform {
  required_providers {
    powermax = {
      source = "dell/powermax"
    }
  }
}

provider "powermax" {
  username      = var.username
  password      = var.password
  endpoint      = var.endpoint
  serial_number = var.serial_number
  pmax_version  = var.pmax_version
  insecure      = true

  ## Provider can also be set using environment variables
  ## If environment variables are set it will override this configuration
  ## Example environment variables
  # POWERMAX_USERNAME="username"
  # POWERMAX_PASSWORD="password"
  # POWERMAX_ENDPOINT="https://yourhost.host.com:8443"
  # POWERMAX_SERIAL_NUMBER="xxxxxxxxxxxx"
  # POWERMAX_POWERMAX_VERSION="100"
  # POWERMAX_INSECURE="false"
}

resource "powermax_volume" "test" {

  # Required name of the volume to be created
  vol_name = "terraform_volume"

  # Required size of the volume
  size = 2.45

  # Required name of the storage group which the volume will be created with
  sg_name = "terraform_sg"

  # Optional Default Unit is GB
  # Possible units are MB, GB, TB, and CYL
  cap_unit = "GB"

  # Optional enable the mobility id 
  mobility_id_enabled = false

}

Refer to the specific provider and resource documetation for more information

Argument Reference

The following arguments are used to configure the provider

Required

endpoint (String) Schema + IP or FQDN + port IE: (https://x.x.x.x:8443) of the PowerMax host
password (String, Sensitive) The password of the PowerMax host.
pmax_version (String) The version of the PowerMax host.
serial_number (String) The serial_number of the PowerMax host.
username (String) The username of the PowerMax host.

Optional

insecure (Boolean) Boolean variable to specify whether to validate SSL certificate or not.

Bug Reports and Contributing

If you need to sumbit a bug please do so on our github issues page https://github.com/dell/terraform-provider-powermax/issues If you would like to contribute please follow the README here: https://github.com/dell/terraform-provider-powermax

V1.0.4: powermax_host data source

Mon, 01 Jan 0001 00:00:00 +0000

powermax_host (Data Source)

Data source for reading Hosts in PowerMax array. PowerMax hosts systems are storage hosts that use storage system logical unit number (LUN) resources. A LUN is an identifier that is used for labeling and designating subsystems of physical or virtual storage

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 host 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 hosts and their details
data "powermax_host" "HostDsAll" {
  # 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 "hostDsResultAll" {
  value = data.powermax_host.HostDsAll
}

# # Returns a subset of the PowerMax hosts based on the names provided in the `names` filter block and their details
# data "powermax_host" "HostDsFiltered" {
#   # 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"
#   # }
#   filter {
#     # Optional list of names to filter upon
#     names = [
#       "Host124",
#       "Host173",
#     ]
#   }
# }

# output "hostDsResult" {
#   value = data.powermax_host.HostDsFiltered
# }

# 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_host.example

Schema

Optional

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

Read-Only

hosts (Attributes List) List of host attributes (see below for nested schema)
id (String) Unique identifier of the host instance.

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 `hosts`

Required:

host_flags (Attributes) Flags set for the host. When host_flags = {} then default flags will be considered. (see below for nested schema)
initiator (List of String) The initiators associated with the host.
name (String) The name of the host.

Optional:

consistent_lun (Boolean) It enables the rejection of any masking operation involving this host that would result in inconsistent LUN values.

Read-Only:

bw_limit (Number) Specifies the bandwidth limit for a host.
hostgroup (List of String) The host group associated with the host.
id (String) The ID of the host.
maskingview (List of String) The masking views associated with the host.
num_of_host_groups (Number) The number of hostgroups associated with the host.
num_of_initiators (Number) The number of initiators associated with the host.
num_of_masking_views (Number) The number of masking views associated with the host.
numofpowerpathhosts (Number) The number of powerpath hosts associated with the host.
port_flags_override (Boolean) States whether port flags override is enabled on the host.
powerpathhosts (List of String) The powerpath hosts associated with the host.
type (String) Specifies the type of host.

Nested Schema for `hosts.host_flags`

Optional:

avoid_reset_broadcast (Attributes) It enables a SCSI bus reset to only occur to the port that received the reset. (see below for nested schema)
disable_q_reset_on_ua (Attributes) It is used for hosts that do not expect the queue to be flushed on a 0629 sense. (see below for nested schema)
environ_set (Attributes) It enables the environmental error reporting by the storage system to the host on the specific port. (see below for nested schema)
openvms (Attributes) This attribute enables an Open VMS fibre connection. (see below for nested schema)
scsi_3 (Attributes) Alters the inquiry data to report that the storage system supports the SCSI-3 protocol. (see below for nested schema)
scsi_support1 (Attributes) This attribute provides a stricter compliance with SCSI standards. (see below for nested schema)
spc2_protocol_version (Attributes) When setting this flag, the port must be offline. (see below for nested schema)
volume_set_addressing (Attributes) It enables the volume set addressing mode. (see below for nested schema)

Nested Schema for `hosts.host_flags.avoid_reset_broadcast`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `hosts.host_flags.disable_q_reset_on_ua`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `hosts.host_flags.environ_set`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `hosts.host_flags.openvms`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `hosts.host_flags.scsi_3`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `hosts.host_flags.scsi_support1`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `hosts.host_flags.spc2_protocol_version`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `hosts.host_flags.volume_set_addressing`

Optional:

enabled (Boolean)
override (Boolean)

V1.0.4: powermax_host resource

Mon, 01 Jan 0001 00:00:00 +0000

powermax_host (Resource)

Resource for managing Host in PowerMax array. PowerMax hosts systems are storage hosts that use storage system logical unit number (LUN) resources. A LUN is an identifier that is used for labeling and designating subsystems of physical or virtual storage

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.
*/

# Available actions: Create, Update (name, initiator, consistent_lun, host_flags), Delete and Import an existing host from the PowerMax Array.
# After `terraform apply` of this example file it will create a new host with the name set in `name` attribute on the PowerMax

# PowerMax hosts systems are storage hosts that use storage system logical unit number (LUN) resources.
# A LUN is an identifier that is used for labeling and designating subsystems of physical or virtual storage.
resource "powermax_host" "host_1" {

  # Attributes which are able to be modified after create (name, initiator, consistent_lun, host_flags)

  # Required is the name of the host. 
  # Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed
  name = "host_1"

  # Required The initiator(s) associated with the host
  initiator = ["10000000c9fc4b7e"]

  # Optional consistent_lun the lun addresses on the source are consistent across all paths
  consistent_lun = false

  # Optional host flags
  # All flags are optional and have 2 possible values enabled (to enable that flag on the PowerMax) and override (to force that flag to be set on the PowerMax)
  # If a flag is not set then it will have a default value of false
  host_flags = {

    # Optional It enables a SCSI bus reset to only occur to the port that received the reset.
    avoid_reset_broadcast = {
      override = true
      enabled  = true
    }

    # Optional It is used for hosts that do not expect the queue to be flushed on a 0629 sense.
    disable_q_reset_on_ua = {
      override = true
      enabled  = true
    }

    # Optional It enables the environmental error reporting by the storage system to the host on the specific port.
    environ_set = {
      override = true
      enabled  = true
    }

    # Optional This attribute enables an Open VMS fibre connection
    openvms = {
      override = true
      enabled  = true
    }

    # Optional This attribute provides a stricter compliance with SCSI standards
    scsi_support1 = {
      override = true
      enabled  = true
    }

    # Optional SPC2 Protocol flag. When setting this flag, the port must be offline
    spc2_protocol_version = {
      override = true
      enabled  = true
    }

    # Optional Alters the inquiry data to report that the storage system supports the SCSI-3 protocol
    scsi_3 = {
      override = true
      enabled  = true
    }

    # Optional It enables the volume set addressing mode
    volume_set_addressing = {
      override = true
      enabled  = true
    }
  }
}

# After the execution of above resource block, a PowerMax host has been created at PowerMax array.
# For more information about the newly created resource use the `terraform show` command to review the current state

Schema

Required

initiator (List of String) The initiators associated with the host. (Update Supported)
name (String) The name of the host. Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed. (Update Supported)

Optional

consistent_lun (Boolean) It enables the rejection of any masking operation involving this host that would result in inconsistent LUN values. (Update Supported)
host_flags (Attributes) Flags set for the host. When host_flags = {} then default flags will be considered. (Update Supported) (see below for nested schema)

Read-Only

bw_limit (Number) Specifies the bandwidth limit for a host.
hostgroup (List of String) The host group associated with the host.
id (String) The ID of the host.
maskingview (List of String) The masking views associated with the host.
num_of_host_groups (Number) The number of hostgroups associated with the host.
num_of_initiators (Number) The number of initiators associated with the host.
num_of_masking_views (Number) The number of masking views associated with the host.
numofpowerpathhosts (Number) The number of powerpath hosts associated with the host.
port_flags_override (Boolean) States whether port flags override is enabled on the host.
powerpathhosts (List of String) The powerpath hosts associated with the host.
type (String) Specifies the type of host.

Nested Schema for `host_flags`

Optional:

avoid_reset_broadcast (Attributes) It enables a SCSI bus reset to only occur to the port that received the reset. (Update Supported) (see below for nested schema)
disable_q_reset_on_ua (Attributes) It is used for hosts that do not expect the queue to be flushed on a 0629 sense. (Update Supported) (see below for nested schema)
environ_set (Attributes) It enables the environmental error reporting by the storage system to the host on the specific port. (Update Supported) (see below for nested schema)
openvms (Attributes) This attribute enables an Open VMS fibre connection. (Update Supported) (see below for nested schema)
scsi_3 (Attributes) Alters the inquiry data to report that the storage system supports the SCSI-3 protocol. (Update Supported) (see below for nested schema)
scsi_support1 (Attributes) This attribute provides a stricter compliance with SCSI standards. (Update Supported) (see below for nested schema)
spc2_protocol_version (Attributes) When setting this flag, the port must be offline. (Update Supported) (see below for nested schema)
volume_set_addressing (Attributes) It enables the volume set addressing mode. (Update Supported) (see below for nested schema)

Nested Schema for `host_flags.avoid_reset_broadcast`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.disable_q_reset_on_ua`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.environ_set`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.openvms`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.scsi_3`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.scsi_support1`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.spc2_protocol_version`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.volume_set_addressing`

Optional:

enabled (Boolean)
override (Boolean)

Import

Import is supported using the following syntax:

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

# The command is
# terraform import powermax_host.host_1 <id>
# Example:
terraform import powermax_host.host_1 host_1
# after running this command, populate the name field in the config file to start managing this resource

V1.0.4: powermax_hostgroup data source

Mon, 01 Jan 0001 00:00:00 +0000

powermax_hostgroup (Data Source)

Data source for reading HostGroups in PowerMax array. PowerMax host groups are groups of PowerMax Hosts. see the host example for more information on hosts.

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 hostgroup 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 host groups and their details
data "powermax_hostgroup" "all" {
  # 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 "all" {
  value = data.powermax_hostgroup.all
}

# Returns a subset of the PowerMax host groups based on the names provided in the `names` filter block and their details
# data "powermax_hostgroup" "groups" {
#   # 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"
#   # }
#   filter {
#     # Optional list of names to filter upon
#     names = ["host_group_example_1", "host_group_example_2"]
#   }
# }

# output "groups" {
#   value = data.powermax_hostgroup.groups
# }

# 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_hostgroup.example

Schema

Optional

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

Read-Only

host_group_details (Attributes List) List of Hostgroups (see below for nested schema)
id (String) Identifier

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 `host_group_details`

Optional:

host (Attributes List) List of related host ids (see below for nested schema)
maskingview (List of String) List of masking views ids related to the host

Read-Only:

consistent_lun (Boolean) Consistent lun flag set
host_group_id (String) Id of a hostgroup
name (String) Name of a hostgroup
num_of_hosts (Number) Number of hosts related to a hostgroup
num_of_initiators (Number) Number of initiators related to a hostgroup
num_of_masking_views (Number) Number of masking views related to a hostgroup
port_flags_override (Boolean) Port flags are overwritten
type (String) The host group type

Nested Schema for `host_group_details.host`

Optional:

initiator (List of String) The host initators associated with the host

Read-Only:

host_id (String) The host id

V1.0.4: powermax_hostgroup resource

Mon, 01 Jan 0001 00:00:00 +0000

powermax_hostgroup (Resource)

Resource for managing HostGroups for a PowerMax Array. PowerMax host groups are groups of PowerMax Hosts. see the host example for more information on hosts.

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.
*/

# Available actions: Create, Update (name, host_ids, consistent_lun, host_flags), Delete and Import an existing host group from the PowerMax Array.
# After `terraform apply` of this example file it will create a new host_group with the name set in `name` attribute on the PowerMax

# PowerMax host groups are groups of PowerMax Hosts. see the host example for more information on hosts
resource "powermax_hostgroup" "test_host_group" {

  # Attributes which are able to be modified after create (name, host_ids, consistent_lun, host_flags)

  # Required the name of the new host group
  # Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed
  name = "host_group"

  # Required A list of host ids associated with the hostgroup (should have at least 1) 
  host_ids = ["testHost"]

  # Optional host flags
  # All flags are optional and have 2 possible values enabled (to enable that flag on the PowerMax) and override (to force that flag to be set on the PowerMax)
  # If a flag is not set then it will have a default value of false
  host_flags = {

    # Optional It enables a SCSI bus reset to only occur to the port that received the reset.
    avoid_reset_broadcast = {
      override = true
      enabled  = true
    }

    # Optional It is used for hosts that do not expect the queue to be flushed on a 0629 sense.
    disable_q_reset_on_ua = {
      override = true
      enabled  = true
    }

    # Optional It enables the environmental error reporting by the storage system to the host on the specific port.
    environ_set = {
      override = true
      enabled  = true
    }

    # Optional This attribute enables an Open VMS fibre connection
    openvms = {
      override = true
      enabled  = true
    }

    # Optional This attribute provides a stricter compliance with SCSI standards
    scsi_support1 = {
      override = true
      enabled  = true
    }

    # Optional SPC2 Protocol flag. When setting this flag, the port must be offline
    spc2_protocol_version = {
      override = true
      enabled  = true
    }

    # Optional Alters the inquiry data to report that the storage system supports the SCSI-3 protocol
    scsi_3 = {
      override = true
      enabled  = true
    }

    # Optional It enables the volume set addressing mode
    volume_set_addressing = {
      override = true
      enabled  = true
    }
  }
}

# After the execution of above resource block, a PowerMax host group has been created at PowerMax array.
# For more information about the newly created resource use the `terraform show` command to review the current state

Schema

Required

host_ids (Set of String) A list of host ids associated with the hostgroup. (Update Supported)
name (String) The name of the hostgroup. Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed. (Update Supported)

Optional

consistent_lun (Boolean) It enables the rejection of any masking operation involving this hostgroup that would result in inconsistent LUN values. (Update Supported)
host_flags (Attributes) Host Flags set for the hostgroup. When host_flags = {} or not set then default flags will be considered. (Update Supported) (see below for nested schema)

Read-Only

id (String) The ID of the hostgroup.
maskingviews (List of String) The masking views associated with the hostgroup.
numofhosts (Number) The number of hosts associated with the hostgroup.
numofinitiators (Number) The number of initiators associated with the hostgroup.
numofmaskingviews (Number) The number of masking views associated with the hostgroup.
port_flags_override (Boolean) States whether port flags override is enabled on the hostgroup.
type (String) Specifies the type of hostgroup.

Nested Schema for `host_flags`

Optional:

avoid_reset_broadcast (Attributes) It enables a SCSI bus reset to only occur to the port that received the reset. (Update Supported) (see below for nested schema)
disable_q_reset_on_ua (Attributes) It is used for hosts that do not expect the queue to be flushed on a 0629 sense. (Update Supported) (see below for nested schema)
environ_set (Attributes) It enables the environmental error reporting by the storage system to the host on the specific port. (Update Supported) (see below for nested schema)
openvms (Attributes) This attribute enables an Open VMS fibre connection. (Update Supported) (see below for nested schema)
scsi_3 (Attributes) Alters the inquiry data to report that the storage system supports the SCSI-3 protocol. (Update Supported) (see below for nested schema)
scsi_support1 (Attributes) This attribute provides a stricter compliance with SCSI standards. (Update Supported) (see below for nested schema)
spc2_protocol_version (Attributes) When setting this flag, the port must be offline. (Update Supported) (see below for nested schema)
volume_set_addressing (Attributes) It enables the volume set addressing mode. (Update Supported) (see below for nested schema)

Nested Schema for `host_flags.avoid_reset_broadcast`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.disable_q_reset_on_ua`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.environ_set`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.openvms`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.scsi_3`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.scsi_support1`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.spc2_protocol_version`

Optional:

enabled (Boolean)
override (Boolean)

Nested Schema for `host_flags.volume_set_addressing`

Optional:

enabled (Boolean)
override (Boolean)

Import

Import is supported using the following syntax:

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

# The command is
# terraform import powermax_hostgroup.test_host_group <id>
# Example:
terraform import powermax_hostgroup.test_host_group host_group
# after running this command, populate the name field in the config file to start managing this resource

V1.0.4: powermax_maskingview data source

Mon, 01 Jan 0001 00:00:00 +0000

powermax_maskingview (Data Source)

Data source for reading Masking Views in PowerMax array. PowerMax masking views are a container of a storage group, a port group, and an initiator group, and makes the storage group visible to the host. Devices are masked and mapped automatically. The groups must contain some device entries.

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 maskingview 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 masking views and their details
data "powermax_maskingview" "allMaskingViews" {
  # 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 "allMaskingViewsResult" {
  value = data.powermax_maskingview.allMaskingViews.masking_views
}

# Returns a subset of the PowerMax masking views based on the names provided in the `names` filter block and their details
data "powermax_maskingview" "maskingViewFilter" {
  # 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"
  # }
  filter {
    # Optional list of names to filter upon
    names = ["terraform_mv_1", "terraform_mv_2"]
  }
}

output "maskingViewFilterResult" {
  value = data.powermax_maskingview.maskingViewFilter.masking_views
}

# 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_maskingview.example

Schema

Optional

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

Read-Only

id (String) Unique identifier of the masking view instance.
masking_views (Attributes List) List of masking views. (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 `masking_views`

Read-Only:

capacity_gb (Number) The capacity of the storage group in the masking view.
host_group_id (String) The host group id of the masking view.
host_id (String) The host id of the masking view.
initiators (List of String) List of initiators.
masking_view_name (String) Unique identifier of the masking view.
port_group_id (String) The port group id of the masking view.
ports (List of String) List of ports.
storage_group_id (String) The storage group id of the masking view.
volumes (List of String) List of Volumes.

V1.0.4: powermax_maskingview resource

Mon, 01 Jan 0001 00:00:00 +0000

powermax_maskingview (Resource)

Resource for managing MaskingViews in PowerMax array. PowerMax masking views are a container of a storage group, a port group, and an initiator group, and makes the storage group visible to the host. Devices are masked and mapped automatically. The groups must contain some device entries.

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.
*/

# Available actions: Create, Update (name), Delete and Import an existing maskingview from the PowerMax Array.
# After `terraform apply` of this example file it will create a new masking_view with the name set in `name` attribute on the PowerMax

# PowerMax masking views are a container of a storage group, a port group, and an initiator group, and makes the storage group visible to the host. 
# Devices are masked and mapped automatically. The groups must contain some device entries.
resource "powermax_maskingview" "test" {

  # Attributes which are able to be modified after create (name)

  # Required the name of the new masking view
  # Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed
  name = "terraform_mv"

  # Required the storage group id to be assoiciated with the new masking view
  storage_group_id = "TestnewSG"

  # Required host to be assoiciated with the new masking view
  # NOTE if host_id is set then host_group_id must be empty string ""
  host_id = "Host124"

  # Required host group to be assoiciated with the new masking view
  # NOTE if host_group_id is set then host_id must be an empty string ""
  host_group_id = ""

  # Required the port group to be assoiciated with the new masking view
  port_group_id = "TestnewSG_PG"
}

# After the execution of above resource block, a PowerMax maskingview has been created at PowerMax array.
# For more information about the newly created resource use the `terraform show` command to review the current state

Schema

Required

host_group_id (String) The host group id of the masking view.
host_id (String) The host id of the masking view.
name (String) Unique identifier of the masking view. (Update Supported)
port_group_id (String) The port group id of the masking view.
storage_group_id (String) The storage group id of the masking view.

Read-Only

id (String) The ID of the masking view.

Import

Import is supported using the following syntax:

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

# The command is
# terraform import powermax_maskingview.test <id>
# Example:
terraform import powermax_maskingview.test terraform_mv
# after running this command, populate the name field in the config file to start managing this resource

V1.0.4: powermax_port data source

Mon, 01 Jan 0001 00:00:00 +0000

powermax_port (Data Source)

Data source for reading ports in PowerMax array. A port typically refers to the interface that allows for connections between the PowerMax system and other devices.

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 port 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 ports and their details
data "powermax_port" "all" {
  # 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 "all" {
  value = data.powermax_port.all
}

# Returns a subset of the PowerMax ports based on the names provided in the `names` filter block and their details
# data "powermax_port" "portFilter" {
#   # 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 {
#     # Should be in the format ["directorId:portId"]
#     port_ids = ["OR-1C:2"]
#   }
# }

# output "portFilter" {
#   value = data.powermax_port.portFilter
# }

# 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_port.example

Schema

Optional

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

Read-Only

id (String) Identifier
port_details (Attributes List) List of Ports (see below for nested schema)

Nested Schema for `filter`

Optional:

port_ids (Set of String) A set of port ids to filter on, should be look like the following [‘directorId:portId’]

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 `port_details`

Read-Only:

aclx (Boolean) Has aclx
avoid_reset_broadcast (Boolean) Avoid reset brodcast
capable_protocol (List of String) Capable Protocol
common_serial_number (Boolean) Common Serial Number
director_id (String) Id of the director
director_status (String) Director Status
disable_q_reset_on_ua (Boolean) Disable Q reset on ua
enable_auto_negotiate (Boolean) Enable Auto Negotiate
enabled_protocol (List of String) Enabled Protocol
environ_set (Boolean) Environ Set
hp_3000_mode (Boolean) HP 3000 mode
identifier (String) Port identifier
init_point_to_point (Boolean) Init point to point
ip_addresses (List of String) Ip Addresses
ipv4_address (String) Ipv4 Address
ipv4_default_gateway (String) Ipv4 Default Gateway
ipv4_domain_name (String) Ipv4 Domain Name
ipv4_netmask (String) Ipv4 Netmask
ipv6_address (String) Ipv6 Address
ipv6_prefix (String) Ipv6 Prefix
iscsi_endpoint (Boolean) iScsi Endpoint
iscsi_target (Boolean) iScsi Target
mac_address (String) Mac Address
maskingview (List of String) Masking Views
max_speed (String) Max Speed
negotiate_reset (Boolean) Negotiate reset
negotiated_speed (String) Negotiated speed
network_id (Number) Network Id
no_participating (Boolean) No Participating
num_of_cores (Number) Total number of cors
num_of_hypers (Number) TX Power Level MW
num_of_mapped_vols (Number) Total number of volumes
num_of_masking_views (Number) Total number of masking views
num_of_port_groups (Number) Total number of port groups
nvmetcp_endpoint (Boolean) NVME over TCP Endpoint
port_id (String) Id of the port
port_interface (String) Port Interface
port_status (String) Port Status
portgroup (List of String) Portgroup
power_levels_last_sampled_date_milliseconds (Number) Power Levels Last Sampled Date in Milliseconds
prevent_automatic_rdf_link_recovery (String) Prevent automatic rdf link recovery
prevent_ra_online_on_power_up (String) Prevent RA Online on Power Up
rdf_hardware_compression (String) RDF Hardware Compression
rdf_hardware_compression_supported (String) RDF Hardware Compression Supported
rdf_ra_group_attributes_farpoint (Boolean) RDF RA group attributes farpoint
rdf_software_compression (String) RDF Software Compression
rdf_software_compression_supported (String) RDF Software Compression Suppored
rx_power_level_mw (Number) RX Power Level MW
scsi_3 (Boolean) SCSI 3
scsi_support1 (Boolean) SCSI support 1
siemens (Boolean) Siemens
soft_reset (Boolean) Soft reset
spc2_protocol_version (Boolean) SPC2 Protocol Version
sunapee (Boolean) Sunapee
tcp_port (Number) TPC Port
tx_power_level_mw (Number) TX Power Level MW
type (String) Port Type
unique_wwn (Boolean) Unique WWN
vcm_state (String) VMC State
vnx_attached (Boolean) VNX Attached
volume_set_addressing (Boolean) Volume Set Addressing
wwn_node (String) WWN Node
z_hyperlink_port (Boolean) Z Hyperlink Port

V1.0.4: powermax_portgroup resource

Mon, 01 Jan 0001 00:00:00 +0000

powermax_portgroup (Resource)

Resource for managing PortGroups in PowerMax array. PowerMax port groups contain director and port identification and belong to a masking view. Ports can be added to and removed from the port group. Port groups that are no longer associated with a masking view can be deleted. Note the following recommendations: Port groups should contain four or more ports. Each port in a port group should be on a different director. A port can belong to more than one port group. However, for storage systems running HYPERMAX OS 5977 or higher, you cannot mix different types of ports (physical FC ports, virtual ports, and iSCSI virtual ports) within a single port group

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.
*/

# Available actions: Create, Update (name, ports), Delete and Import an existing portgroup from the PowerMax Array.
# After `terraform apply` of this example file it will create a new portgroup with the name set in `name` attribute on the PowerMax

# PowerMax port groups contain director and port identification and belong to a masking view. Ports can be added to and removed from the port group. Port groups that are no longer associated with a masking view can be deleted.
# Note the following recommendations:
# Port groups should contain four or more ports.
# Each port in a port group should be on a different director.
# A port can belong to more than one port group. However, for storage systems running HYPERMAX OS 5977 or higher, you cannot mix different types of ports (physical FC ports, virtual ports, and iSCSI virtual ports) within a single port group
resource "powermax_portgroup" "portgroup_1" {

  # Attributes which are able to be modified after create (name, ports)

  # Required The name of the portgroup. Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed.
  name = "tfacc_pg_test_1"

  # Required The portgroup protocol. Protocols: SCSI_FC, iSCSI, NVMe_FC, NVMe_TCP
  protocol = "SCSI_FC"

  # Required The list of ports associated with the portgroup
  # Must include the director and port id in each object below
  ports = [
    {
      director_id = "OR-1C"
      port_id     = "0"
    }
  ]
}

# After the execution of above resource block, a PowerMax port group has been created at PowerMax array.
# For more information about the newly created resource use the `terraform show` command to review the current state

Schema

Required

name (String) The name of the portgroup. Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed. (Update Supported)
ports (Attributes List) The list of ports associated with the portgroup. (Update Supported) (see below for nested schema)
protocol (String) The portgroup protocol. Protocols: SCSI_FC, iSCSI, NVMe_FC, NVMe_TCP

Read-Only

id (String) The ID of the portgroup.
maskingview (List of String) The masking views associated with the portgroup.
numofmaskingviews (Number) The number of masking views associated with the portgroup.
numofports (Number) The number of ports associated with the portgroup.
type (String) The type of the portgroup.

Nested Schema for `ports`

Required:

director_id (String)
port_id (String)

Import

Import is supported using the following syntax:

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

# The command is
# terraform import powermax_portgroup.portgroup_1 <id>
# Example:
terraform import powermax_portgroup.portgroup_1 tfacc_pg_test_1
# after running this command, populate the name field in the config file to start managing this resource

V1.0.4: powermax_portgroups data source

Mon, 01 Jan 0001 00:00:00 +0000

powermax_portgroups (Data Source)

Data source for reading PortGroups in PowerMax array. PowerMax port groups contain director and port identification and belong to a masking view. Ports can be added to and removed from the port group. Port groups that are no longer associated with a masking view can be deleted. Note the following recommendations: Port groups should contain four or more ports. Each port in a port group should be on a different director. A port can belong to more than one port group. However, for storage systems running HYPERMAX OS 5977 or higher, you cannot mix different types of ports (physical FC ports, virtual ports, and iSCSI virtual ports) within a single port group

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 port group from PowerMax array.
# The information fetched from this data source can be used for getting the details / for further processing in resource block.

# List fibre portgroups.
data "powermax_portgroups" "fibreportgroups" {
  # 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 filter to list specified Portgroups names and/or type
  filter {
    # type for which portgroups to be listed  - fibre or iscsi
    type = "fibre"
    # Optional list of IDs to filter
    names = [
      "tfacc_test1_fibre",
      #"test2_fibre",
    ]
  }
}

data "powermax_portgroups" "scsiportgroups" {
  filter {
    type = "iscsi"
    # Optional filter to list specified Portgroups Names
  }
}

# List all portgroups.
data "powermax_portgroups" "allportgroups" {
  # 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"
  # }

  #filter {
  # Optional list of IDs to filter
  #names = [
  #  "test1",
  #  "test2",
  #]
  #}
}

# 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_portgroups.example

Schema

Optional

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

Read-Only

id (String) Identifier
port_groups (Attributes List) List of port group attributes (see below for nested schema)

Nested Schema for `filter`

Optional:

names (Set of String)
type (String) The Type of the portgroup.

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 `port_groups`

Required:

name (String) The name of the portgroup.
ports (Attributes List) The list of ports associated with the portgroup. (see below for nested schema)
protocol (String) The portgroup protocol.
type (String) The Type of the portgroup.

Read-Only:

id (String) Identifier
maskingview (List of String) The masking views associated with the portgroup.
numofmaskingviews (Number) The number of masking views associated with the portgroup.
numofports (Number) The number of ports associated with the portgroup.

Nested Schema for `port_groups.ports`

Required:

director_id (String)
port_id (String)

V1.0.4: powermax_snapshot data source

Mon, 01 Jan 0001 00:00:00 +0000

powermax_snapshot (Data Source)

Data source for a specific StorageGroup Snapshots in PowerMax array. PowerMax Snaphots is a local replication solution that is designed to nondisruptively create point-in-time copies (snapshots) of critical data.

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 snapshot 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 snapshots related to a particular storage group and their details
data "powermax_snapshot" "test" {
  # The storage group name to which display all of its snapshots
  # Required
  storage_group {
    name = "example_storage_group"
  }

  # 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 "powermax_snapshot" {
  value = data.powermax_snapshot.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_snapshot.example

Schema

Optional

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

Read-Only

id (String) Identifier
snapshots (Attributes List) List of Snapshots (see below for nested schema)

Nested Schema for `storage_group`

Required:

name (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 `snapshots`

Optional:

generation (Number) Number of generation for the snapshot
linked_storage_group (Attributes List) Linked storage group and volume information. Only populated if the generation is linked (see below for nested schema)
non_shared_tracks (Number) The number of tracks uniquely allocated for this snapshots delta. This is an approximate indication of the number of tracks that will be returned to the SRP if this snapshot is terminated.
num_source_volumes (Number) The number of source volumes in the snapshot generation
persistent (Boolean) Set if this snapshot is persistent. Only applicable to policy based snapshots
secure_expiry_date (String) When the snapshot will expire once it is not linked
snapid (Number) Unique Snap ID for Snapshot
time_to_live_expiry_date (String) When the snapshot will expire once it is not linked
tracks (Number) The number of source tracks that have been overwritten by the host

Read-Only:

expired (Boolean) Set if this generation secure has expired
linked (Boolean) Set if this generation is SnapVX linked
linked_storage_group_names (List of String) Linked storage group names. Only populated if the generation is linked
name (String) Name of a snapshot
num_storage_group_volumes (Number) The number of non-gatekeeper storage group volumes
restored (Boolean) Set if this generation is SnapVX linked
source_volume (Attributes List) The source volumes of the snapshot generation (see below for nested schema)
state (List of String) The state of the snapshot generation
timestamp (String) Timestamp of the snapshot generation
timestamp_utc (String) The timestamp of the snapshot generation in milliseconds since 1970

Nested Schema for `snapshots.linked_storage_group`

Optional:

background_define_in_progress (Boolean) When the snapshot link is being defined
defined (Boolean) When the snapshot link has been fully defined

Read-Only:

linked_creation_timestamp (String) The average timestamp of all linked volumes that are linked
linked_volume_name (String) The linked volumes name
name (String) The storage group name
percentage_copied (Number) Percentage of tracks copied
source_volume_name (String) The source volumes name
track_size (Number) Size of the tracks.
tracks (Number) Number of tracks

Nested Schema for `snapshots.source_volume`

Read-Only:

capacity (Number) The capacity of the snapshot volume in cylinders
capacity_gb (Number) The capacity of the snapshot volume in GB
name (String) The name of the SnapVX snapshot generation source volume

V1.0.4: powermax_snapshot resource

Mon, 01 Jan 0001 00:00:00 +0000

powermax_snapshot (Resource)

Resource for managing Snapshots in PowerMax array. PowerMax Snaphots is a local replication solution that is designed to nondisruptively create point-in-time copies (snapshots) of critical data.

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.
*/

# Available actions: Create, Update (name, secure, time_to_live, link, restore), Delete and Import an existing snapshot from the PowerMax Array.
# After `terraform apply` of this example file it will create a new snapshot with the name set in `name` attribute on the PowerMax for the storage group set in the storage group `name` attribute
# NOTE: that all of the PowerMax `snapshot_actions` are only available during modify of the snapshot after it has been created.

# PowerMax Snaphots is a local replication solution that is designed to nondisruptively create point-in-time copies (snapshots) of critical data.
resource "powermax_snapshot" "snapshot_1" {

  # Attributes which are able to be modified after create (secure, time_to_live, link, restore)

  # Required The storage group that the snapshot will be taken upon 
  storage_group {
    name = "test_sg"
  }

  # The different actions that can be taken on a snapshot ONLY after the snapshot has already been created
  snapshot_actions {

    # Required, name of new snapshot
    # Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed.
    name = "new_test_snapshot"

    # Optional this is only available for modify after the resource is created
    # Secure will make it so the snapshot can not be delete until the time in the `secure` flag runs out.
    # Even if the user changes enabled to false after the secure flag is set
    # The snapshot will remmain secure and cannot be deleted
    secure = {
      # Set to true to it will enable this action
      enable = true
      # If set to true the time_to_live is in hours, otherwise it is in days
      time_in_hours = true
      # How long before the snapshot will no longer be secure
      secure = 3
    }

    # Optional this is only available for modify after the resource is created
    # When this flag is set it will delete the snapshot after the time_to_live expires
    time_to_live = {
      # Set to true to it will enable this action
      enable = true
      # If set to true the time_to_live is in hours, otherwise it is in days
      time_in_hours = false
      # How long before the snapshot is deleted
      time_to_live = 1
    }

    # Optional this is only available for modify after the resource is created
    # When this flag is set it will link the tareget_storage_group with the storage group above
    link = {
      # When set to false it will look through the already linked snapshots, if the one in the target group is currently linked it will remove that storage group
      # When set to true it will look through the already linked snapshots, if the one in the target group is not currently liked it will like that storage group
      enable = false
      # The storage group which will be linked
      target_storage_group = "test_target_sg"
      # The target storage group will not have compression turned on when the SRP is compression capable
      no_compression = true
      # Acknowledges that the data will be propagated to the remote mirror of the SRDF volume. This is not allowed on a nocopy linked target.
      remote = false
      # Sets the link copy mode to perform background copy to the target volume(s).
      copy = false
    }

    # Optional this is only available for modify after the resource is created
    # Will attempt to restore the snapshot to a pervious state
    restore = {
      # When enabled it will attempt to restore the snapshot
      enable = true
      # Acknowledges that the data will be propagated to the remote mirror of the RDF device. This is not allowed on a nocopy link target.
      remote = false
    }
  }
}

# After the execution of above resource block, a PowerMax snapshot has been created at PowerMax array.
# For more information about the newly created resource use the `terraform show` command to review the current state

Schema

Optional

generation (Number) Number of generation for the snapshot
linked_storage_group (Attributes List) Linked storage group and volume information. Only populated if the generation is linked (see below for nested schema)
non_shared_tracks (Number) The number of tracks uniquely allocated for this snapshots delta. This is an approximate indication of the number of tracks that will be returned to the SRP if this snapshot is terminated.
num_source_volumes (Number) The number of source volumes in the snapshot generation
persistent (Boolean) Set if this snapshot is persistent. Only applicable to policy based snapshots
secure_expiry_date (String) When the snapshot will expire once it is not linked
snapid (Number) Unique Snap ID for Snapshot
snapshot_actions (Block, Optional) (see below for nested schema)
storage_group (Block, Optional) (see below for nested schema)
time_to_live_expiry_date (String) When the snapshot will expire once it is not linked
tracks (Number) The number of source tracks that have been overwritten by the host

Read-Only

expired (Boolean) Set if this generation secure has expired
id (String) Identifier
linked (Boolean) Set if this generation is SnapVX linked
linked_storage_group_names (List of String) Linked storage group names. Only populated if the generation is linked
name (String) Name of a snapshot
num_storage_group_volumes (Number) The number of non-gatekeeper storage group volumes
restored (Boolean) Set if this generation is SnapVX linked
source_volume (Attributes List) The source volumes of the snapshot generation (see below for nested schema)
state (List of String) The state of the snapshot generation
timestamp (String) Timestamp of the snapshot generation
timestamp_utc (String) The timestamp of the snapshot generation in milliseconds since 1970

Nested Schema for `linked_storage_group`

Optional:

background_define_in_progress (Boolean) When the snapshot link is being defined
defined (Boolean) When the snapshot link has been fully defined

Read-Only:

linked_creation_timestamp (String) The average timestamp of all linked volumes that are linked
linked_volume_name (String) The linked volumes name
name (String) The storage group name
percentage_copied (Number) Percentage of tracks copied
source_volume_name (String) The source volumes name
track_size (Number) Size of the tracks.
tracks (Number) Number of tracks

Nested Schema for `snapshot_actions`

Required:

name (String) Name of the snapshot. (Update Supported)

Optional:

both_sides (Boolean) both_sides defaults to false. Performs the operation on both locally and remotely associated snapshots.
link (Attributes) Link a snapshot generation. (Update Supported) (see below for nested schema)
remote (Boolean) remote defaults to false. If true, The target storage group will not have compression turned on when the SRP is compression capable.
restore (Attributes) Restore a snapshot generation. (Update Supported) (see below for nested schema)
secure (Attributes) Set the number of days or hours for a snapshot generation to be secure before it auto-terminates (provided it is not linked). (Update Supported) (see below for nested schema)
time_to_live (Attributes) Set the number of days or hours for a snapshot generation before it auto-terminates (provided it is not linked). (Update Supported) (see below for nested schema)

Nested Schema for `snapshot_actions.link`

Optional:

copy (Boolean) copy defaults to false. If true Sets the link copy mode to perform background copy to the target volume(s).
enable (Boolean) enable defaults to false. Flag to enable link on the snapshot
no_compression (Boolean) no_compression defaults to false. If true, The target storage group will not have compression turned on when the SRP is compression capable. Option Used in Action Link
remote (Boolean) remote defaults to false. If true, The target storage group will not have compression turned on when the SRP is compression capable. Option Used in Action Link
target_storage_group (String) The target storage group to link the snapshot too

Nested Schema for `snapshot_actions.restore`

Optional:

enable (Boolean) enable defaults to false. Flag to enable restore on the snapshot
remote (Boolean) remote defaults to false. If true, The target storage group will not have compression turned on when the SRP is compression capable. Option Used in Action Link

Nested Schema for `snapshot_actions.secure`

Optional:

enable (Boolean) enable defaults to false. Flag to enable link on the snapshot
secure (Number) secure defaults to 1 day. The time that the snapshot generation is to be secure for.
time_in_hours (Boolean) time_in_hours or Days defaults to Days. False is days, true is hours.

Nested Schema for `snapshot_actions.time_to_live`

Optional:

enable (Boolean) enable defaults to false. Flag to enable link on the snapshot
time_in_hours (Boolean) time_in_hours or Days defaults to Days. False is days, true is hours.
time_to_live (Number) time_to_live defaults to 1 day. Gives the total time before expiry for these actions.

Nested Schema for `storage_group`

Required:

name (String) Name of the storage group you would like to take a snapshot.

Nested Schema for `source_volume`

Read-Only:

capacity (Number) The capacity of the snapshot volume in cylinders
capacity_gb (Number) The capacity of the snapshot volume in GB
name (String) The name of the SnapVX snapshot generation source volume

Import

Import is supported using the following syntax:

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

# The command is
# terraform import powermax_snapshot.snapshot_test storage_group.snapshot_name
# Example: must be storage_group.snapshot_name
terraform import powermax_snapshot.snapshot_test storage_group.snapshot_name
# after running this command, populate the name field in the config file to start managing this resource

V1.0.4: powermax_snapshotpolicy data source

Mon, 01 Jan 0001 00:00:00 +0000

powermax_snapshotpolicy (Data Source)

Data source for a specific Snapshot Policy in PowerMax array. PowerMax snapshot policy feature provides snapshot orchestration at scale (1,024 snaps per storage group). The resource simplifies snapshot management for standard and cloud snapshots.

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 snapshot_policy 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 snapshot policies and their details
data "powermax_snapshotpolicy" "SnapshotPolicyAll" {
  # 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 "SnapshotPolicyAll" {
  value = data.powermax_snapshotpolicy.SnapshotPolicyAll
}

# Returns a subset of the PowerMax snapshot policies based on the names provided in the `names` filter block and their details
data "powermax_snapshotpolicy" "SnapshotPolicyFiltered" {
  # 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"
  # }
  filter {
    # Optional list of names to filter upon
    names = [
      "tfacc_snapshotPolicy1",
    ]
  }
}

output "SnapshotPolicyFiltered" {
  value = data.powermax_snapshotpolicy.SnapshotPolicyFiltered
}

# 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_snapshotpolicy.example

Schema

Optional

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

Read-Only

id (String) Identifier
snapshot_policies (Attributes List) List of Snapshot Policies (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 `snapshot_policies`

Read-Only:

compliance_count_critical (Number) The threshold of good snapshots which are not failed/bad for compliance to change from warning to critical
compliance_count_warning (Number) The threshold of good snapshots which are not failed/bad for compliance to change from normal to warning.
interval_minutes (Number) Number of minutes between each policy execution
last_time_used (String) The last time that the snapshot policy was run
offset_minutes (Number) Number of minutes after 00:00 on Monday morning that the policy will execute
provider_name (String) The name of the cloud provider associated with this policy. Only applies to cloud policies
retention_days (Number) The number of days that snapshots will be retained in the cloud for. Only applies to cloud policies
secure (Boolean) Set if the snapshot policy creates secure snapshots
snapshot_count (Number) Number of snapshots that will be taken before the oldest ones are no longer required
snapshot_policy_name (String) Name of the snapshot policy
storage_group_count (Number) The total number of storage groups that this snapshot policy is associated with
suspended (Boolean) Set if the snapshot policy has been suspended
type (String) The type of Snapshots that are created with the policy, local or cloud

V1.0.4: powermax_snapshotpolicy resource

Mon, 01 Jan 0001 00:00:00 +0000

powermax_snapshotpolicy (Resource)

Resource for a specific Snapshot Policy in PowerMax array. PowerMax snapshot policy feature provides snapshot orchestration at scale (1,024 snaps per storage group). The resource simplifies snapshot management for standard and cloud snapshots.

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.
*/

# Available actions: Create, Update (snapshot_policy_name, storage_groups, interval, snapshot_count, compliance_count_critical, compliance_count_warning, offset_minutes, secure), Delete and Import an existing snapshot policy from the PowerMax Array.
# After `terraform apply` of this example file it will create a new snapshot policy with the name set in `snapshot_policy_name` attribute on the PowerMax

# PowerMax snapshot policy feature provides snapshot orchestration at scale (1,024 snaps per storage group).
# The resource simplifies snapshot management for standard and cloud snapshots.
# This resouce will take snapshots on a periodic basic based on the configuration below.

resource "powermax_snapshotpolicy" "terraform_sp" {

  # Attributes which are able to be modified after create (snapshot_policy_name, storage_groups, interval, snapshot_count, compliance_count_critical, compliance_count_warning, offset_minutes, secure)

  # Required Field will become the name of the snapshot policy
  snapshot_policy_name = "terraform_sp"

  # should only be set for modify/edit operation , not supported during create. 
  # Also the destroy/delete will also unlink any associted storage groups from Snapshot Policy before deleting the snapshot policy.
  # storage_groups =  ["tfacc_sp_sg1", "tfacc_sp_sg2"]

  # Default values are defined below and can be modifed before or after create 

  # The interval between snapshots
  # interval             = "1 Hour"

  # The number of the snapshots that will be maintained by the snapshot policy
  # snapshot_count       = "48"

  # The number of snapshots which are not failed or bad when compliance changes to critical.
  # compliance_count_critical = 46

  # The number of snapshots which are not failed or bad when compliance changes to warning.
  # compliance_count_warning  = 47

  # The number of minutes from 00:00 on a Monday morning when the policy should run. Default is 0 if not specified.
  # offset_minutes            = 420

  # The snapshot policy will create secure snapshots
  # secure = false

}

# After the execution of above resource block, a PowerMax snapshot policy has been created at PowerMax array.
# For more information about the newly created resource use the `terraform show` command to review the current state

Schema

Required

snapshot_policy_name (String) Name of the snapshot policy. Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed and max length can be 32 characters. (Update Supported)

Optional

compliance_count_critical (Number) The threshold of good snapshots which are not failed/bad for compliance to change from warning to critical. (Update Supported)
compliance_count_warning (Number) The threshold of good snapshots which are not failed/bad for compliance to change from normal to warning. (Update Supported)
interval (String) The interval between snapshots Enumeration values: 10 Minutes, 12 Minutes, 15 Minutes, 20 Minutes, 30 Minutes, 1 Hour, 2 Hours, 3 Hours, 4 Hours, 6 Hours, 8 Hours, 12 Hours, 1 Day, 7 Days. (Update Supported)
interval_minutes (Number) Number of minutes between each policy execution
last_time_used (String) The last time that the snapshot policy was run
offset_minutes (Number) Number of minutes after 00:00 on Monday morning that the policy will execute. (Update Supported)
provider_name (String) The name of the cloud provider associated with this policy. Only applies to cloud policies
retention_days (Number) The number of days that snapshots will be retained in the cloud for. Only applies to cloud policies
secure (Boolean) Set if the snapshot policy creates secure snapshots. (Update Supported)
snapshot_count (Number) Number of snapshots that will be taken before the oldest ones are no longer required. (Update Supported)
storage_groups (Set of String) The storage groups associated with the snapshot policy. This field cannot be set during create and is only valid for Edit/Update.If user wants to delete the snapshot policy all associated storage groups will also be unlinked from the Snapshot Policy. (Update Supported)
suspended (Boolean) Set if the snapshot policy has been suspended

Read-Only

id (String) Identifier
storage_group_count (Number) The total number of storage groups that this snapshot policy is associated with
type (String) The type of Snapshots that are created with the policy, local or cloud

Import

Import is supported using the following syntax:

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

# The command is
# terraform import powermax_storagegroup.test <id>
# Example:
terraform import powermax_snapshotpolicy.terraform_sp terraform_sp
# after running this command, populate the name field in the config file to start managing this resource

V1.0.4: powermax_storagegroup data source

Mon, 01 Jan 0001 00:00:00 +0000

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`

Read-Only:

dynamic_distribution (String)
host_io_limit_io_sec (String)
host_io_limit_mb_sec (String)

V1.0.4: powermax_storagegroup resource

Mon, 01 Jan 0001 00:00:00 +0000

powermax_storagegroup (Resource)

Resource for managing 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.
*/

# Available actions: Create, Update (name, compression, host_io_limit, workload, slo, srp_id, volume_ids), Delete and Import an existing storage group from the PowerMax Array.
# After `terraform apply` of this example file it will create a new storage group with the name set in `name` attribute on the PowerMax

# 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.
resource "powermax_storagegroup" "test" {

  # Attributes which are able to be modified after create (name, compression, host_io_limit, workload, slo, srp_id, volume_ids)

  # Required the name of the new storage group
  name = "terraform_sg"

  # Required The Srp to be associated with the Storage Group. If you dont want an SRP the srp_id can be set to 'None'
  srp_id = "SRP_1"

  # Optional the service level of the storage group
  slo = "Gold"

  # Optional enable or disable compression on the storage group (Default to disabled)
  compression = false

  # Optional the workload of the storage group
  workload = "workload"

  # Optional Set Host I/O limits for the specified storage sroup
  host_io_limit = {
    # The MBs per Second Host IO limit for the specified storage group, NOLIMIT means no limits
    host_io_limit_io_sec = "1000"
    # The IOs per Second Host IO limit for the specified storage group , NOLIMIT means no limits
    host_io_limit_mb_sec = "1000"
    # The dynamic distribution type which can be "Never","Always" or "OnFailure"
    dynamic_distribution = "Never"
  }

  # Optional a list of volume ids to be added to the storage groups
  volume_ids = ["0008F"]
}

# After the execution of above resource block, a PowerMax storage group has been created at PowerMax array.
# For more information about the newly created resource use the `terraform show` command to review the current state

Schema

Required

name (String) The name of the storage group. Only alphanumeric characters, underscores ( _ ), and hyphens (-) are allowed. (Update Supported)
srp_id (String) The Srp to be associated with the Storage Group. If you dont want an SRP the srp_id can be set to ‘None’. (Update Supported)

Optional

compression (Boolean) States whether compression is enabled on storage group. (Update Supported)
host_io_limit (Object) Host IO limit of the storage group. (Update Supported) (see below for nested schema)
num_of_vols (Number) The number of volumes associated with the storage group
slo (String) The service level associated with the storage group. (Update Supported)
volume_ids (List of String) The IDs of the volume associated with the storage group. Only pre-existing volumes are considered here. (Update Supported)
workload (String) The workload associated with the storage group. (Update Supported)

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_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
id (String) The ID of the storage group
maskingview (List of String) The masking views associated with 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
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_compliance (String) The service level compliance status of the storage group
snapshot_policies (List of String) The snapshot policies associated with the storage group
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
vp_saved_percent (Number) VP saved percentage figure

Nested Schema for `host_io_limit`

Optional:

dynamic_distribution (String)
host_io_limit_io_sec (String)
host_io_limit_mb_sec (String)

Import

Import is supported using the following syntax:

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

# The command is
# terraform import powermax_storagegroup.test <id>
# Example:
terraform import powermax_storagegroup.test terraform_sg
# after running this command, populate the name field in the config file to start managing this resource

V1.0.4: powermax_volume data source

Mon, 01 Jan 0001 00:00:00 +0000

powermax_volume (Data Source)

Data source for reading Volumes in PowerMax array. PowerMax volumes is an identifiable unit of data storage. Storage groups are sets of volumes.

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 volume 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 volumes and their details
# NOTE: PowerMax can have many volumes, running this command unfiltered can take several minutes
data "powermax_volume" "volume_datasource_all" {
  # 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 "volume_datasource_output" {
  value = data.powermax_volume.volume_datasource_all
}

# Returns a subset of the PowerMax volumes based on the filtered properties in the block
# All filter values are optional
# If you use more then one filter at a time, it will only show the subset of volumes which both of those filters satisfies 
data "powermax_volume" "volume_datasource_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"
  # }
  filter {

    # Optional Volume ids from a single Storage Group only
    storage_group_name = "terraform_vol_sg"

    # Optional Volume ids that contain the specified volume wwn
    wwn = "wwn_num"

    # Optiona lVolume ids that contain the specified volume encapsulated_wwn
    encapsulated_wwn = "encapsulated_wwn_num"

    # Optional Volume ids that contain greater than(">1"), Less than("<1") or equal to the specified symmlun
    symmlun = "0"

    # Optional Volume ids that contain the specified volume status
    status = "Ready"

    # Optional Volume ids that contain the specified volume physical_name
    physical_name = "physical_name"

    # Optional Volume ids that contain the specified volume volume_identifier
    volume_identifier = "test_acc_create_volume"

    # Optional Volume ids that contain greater than(">1"), Less than("<1") or equal to the specified cap_tb
    cap_tb = "0"

    # Optional Volume ids that contain greater than(">1"), Less than("<1") or equal to the specified cap_gb
    cap_gb = "0"

    # Optional Volume ids that contain greater than(">1"), Less than("<1") or equal to the specified cap_mb
    cap_mb = "0"

    # Optional Volume ids that contain greater than(">1"), Less than("<1") or equal to the specified cap_cyl
    cap_cyl = "0"

    # Optional Volume ids that contain greater than(">1"), Less than("<1") or equal to the specified allocated_percent
    allocated_percent = "0"

    # Optional Volume ids that contain greater than(">1"), Less than("<1") or equal to the specified num_of_storage_groups
    num_of_storage_groups = "1"

    # Optional Volume ids that contain greater than(">1"), Less than("<1") or equal to the specified num_of_masking_views
    num_of_masking_views = "0"

    # Optional Volume ids that contain greater than(">1"), Less than("<1") or equal to the specified num_of_front_end_paths
    num_of_front_end_paths = "0"

    # Optional Volume ids that are mobility ID enabled (true/false)
    mobility_id_enabled = false

    # Optional Volume ids that are virtual_volumes (true/false)
    virtual_volumes = true

    # Optional Volume ids that are private_volumes (true/false)
    private_volumes = false

    # Optional Volume ids that are tdev (true/false)
    tdev = true

    # Optional Volume ids that are vdev (true/false)
    vdev = false

    # Optional Volume ids that are available_thin_volumes (true/false)
    available_thin_volumes = false

    # Optional Volume ids that are gatekeeper (true/false)
    gatekeeper = false

    # Optional Volume ids that are data_volume (true/false)
    data_volume = false

    # Optional Volume ids that are dld (true/false)
    dld = false

    # Optional Volume ids that are drv (true/false)
    drv = false

    # Optional Volume ids that are encapsulated (true/false)
    encapsulated = false

    # Optional Volume ids that are associated (true/false)
    associated = false

    # Optional Volume ids that are reserved (true/false)
    reserved = false

    # Optional	Volume ids that are pinned (true/false)
    pinned = false

    # Optional Volume ids that are mapped (true/false)
    mapped = false

    # Optional Volume ids that are bound_tdev (true/false)
    bound_tdev = true

    # Optional Volume ids that are of the specified emulation
    emulation = "FBA"

    # Optional Volume ids that are of the specified emulation.
    has_effective_wwn = false

    # Optional Volume ids that contain the specified effective_wwn
    effective_wwn = "effective_wwn"

    # Optional Volume ids that are mapped to CU images associated to the specified FICON split
    split_name = "split_name"

    # Optional Volume ids that contain the specified volume type
    type = "TDEV"

    # Optional Volume ids that contain greater than("unreducible_data_gb=>1"),Less than("unreducible_data_gb=<1") or equal to the unreducible_data_gb
    unreducible_data_gb = "0"

    # Optional Volume ids that are mapped to a CU image with the specified CU image number
    cu_image_num = "0"

    # Optional Volume ids that are mapped to a CU image with the specified CU SSID
    cu_image_ssid = "cu_image_ssid"

    # Optional Volume ids that are part of the specified rdf group
    rdf_group_number = "0"

    # Optional Volume ids that contain the specified Oracle Instance Name
    oracle_instance_name = "oracle_instance_name"

    # Optional Volumes Ids that correspond to Namespace Globally Unique Identifier that uses the EUI64 16-byte designator format. Used in conjunction with NVMe volumes
    nguid = "nguid"
  }
}

output "volume_datasource_output" {
  value = data.powermax_volume.volume_datasource_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_volume.example

Schema

Optional

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

Read-Only

id (String) Placeholder for acc testing
volumes (Attributes List) List of volumes. (see below for nested schema)

Nested Schema for `filter`

Optional:

allocated_percent (String) Greater than, Less than or equal to the allocated percent.
associated (Boolean) Volumes that are associated (true/false).
available_thin_volumes (Boolean) Volumes that are available thin volumes (true/false).
bound_tdev (Boolean) Volumes that are bound tdev (true/false).
cap_cyl (String) Greater than, Less than or equal to the cap CYL.
cap_gb (String) Greater than, Less than or equal to the cap gb.
cap_mb (String) Greater than, Less than or equal to the cap mb.
cap_tb (String) Greater than, Less than or equal to the cap tb.
cu_image_num (String) Volumes that are mapped to a CU image with the specified CU image number.
cu_image_ssid (String) Volumes that are mapped to a CU image with the specified CU SSID.
data_volume (Boolean) Volumes that are data volume (true/false).
dld (Boolean) Volumes that are dld (true/false).
drv (Boolean) Volumes that are drv (true/false).
effective_wwn (String) Volumes that contain the specified effective_wwn.
emulation (String) Volumes that are of the specified emulation.
encapsulated (Boolean) Volumes that are encapsulated (true/false).
encapsulated_wwn (String) The specified volume encapsulated_wwn.
gatekeeper (Boolean) Volumes that are gatekeeper (true/false).
has_effective_wwn (Boolean) Volumes that have effective wwns (true/false)
mapped (Boolean) Volumes that are mapped (true/false).
mobility_id_enabled (Boolean) Volumes that are mobility ID enabled (true/false).
nguid (String) Volumes that correspond to Namespace Globally Unique Identifier that uses the EUI64 16-byte designator format.
num_of_front_end_paths (String) Greater than, Less than or equal to the number of front end paths.
num_of_masking_views (String) Greater than, Less than or equal to the number of masking views.
num_of_storage_groups (String) Greater than, Less than or equal to the number of storage groups.
oracle_instance_name (String) Volumes that contain the specified Oracle Instance Name.
physical_name (String) The specified volume physical name.
pinned (Boolean) Volumes that are pinned (true/false).
private_volumes (Boolean) Volumes that are private (true/false).
rdf_group_number (String) Volumes that are part of the specified rdf group.
reserved (Boolean) Volumes that are reserved (true/false).
split_name (String) Volumes that are mapped to CU images associated to the specified FICON split.
status (String) The specified volume status.
storage_group_name (String) The name of the storage group.
symmlun (String) Greater than, Less than or equal to the specified symmlun.
tdev (Boolean) Volumes that are tdev (true/false).
thin_bcv (Boolean) Volumes that are thin bcv (true/false).
type (String) Volumes that contain the specified volume type.
unreducible_data_gb (String) Greater than,Less than or equal to the unreducible data gb.
vdev (Boolean) Volumes that are vdev (true/false).
virtual_volumes (Boolean) Volumes that are virtual volumes (true/false).
volume_identifier (String) The specified volume volume identifier.
wwn (String) The specified volume wwn.

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 `volumes`

Optional:

mobility_id_enabled (Boolean) States whether mobility ID is enabled on the volume.
volume_identifier (String) The identifier of the volume.

Read-Only:

allocated_percent (Number) The allocated percentage of the volume.
cap_cyl (Number) The capability of volume in the unit of CYL.
cap_gb (Number) The capability of volume in the unit of GB.
cap_mb (Number) The capability of volume in the unit of MB.
effective_wwn (String) Effective WWN of the volume.
emulation (String) The emulation of the volume Enumeration values.
encapsulated (Boolean) States whether the volume is encapsulated.
encapsulated_wwn (String) Encapsulated WWN of the volume.
has_effective_wwn (Boolean) States whether volume has effective WWN.
id (String) The ID of the volume.
nguid (String) The NGUID of the volume.
num_of_front_end_paths (Number) The number of front end paths of the volume.
num_of_storage_groups (Number) The number of storage groups associated with the volume.
oracle_instance_name (String) Oracle instance name associated with the volume.
physical_name (String) The physical name of the volume.
pinned (Boolean) States whether the volume is pinned.
rdf_group_ids (Attributes List) The RDF groups associated with the volume. (see below for nested schema)
reserved (Boolean) States whether the volume is reserved.
snapvx_source (Boolean) States whether the volume is a snapvx source.
snapvx_target (Boolean) States whether the volume is a snapvx target.
ssid (String) The ssid of the volume.
status (String) The status of the volume.
storage_groups (Attributes List) List of storage groups which are associated with the volume. (see below for nested schema)
symmetrix_port_key (Attributes List) The symmetrix ports associated with the volume. (see below for nested schema)
type (String) The type of the volume.
unreducible_data_gb (Number) The amount of unreducible data in Gb.
wwn (String) The WWN of the volume.

Nested Schema for `volumes.rdf_group_ids`

Read-Only:

label (String) The label of the rdf group.
rdf_group_number (Number) The number of rdf group.

Nested Schema for `volumes.storage_groups`

Read-Only:

parent_storage_group_name (String) The ID of the storage group parents.
storage_group_name (String) The ID of the storage group.

Nested Schema for `volumes.symmetrix_port_key`

Read-Only:

director_id (String) The ID of the director.
port_id (String) The ID of the symmetrix port.

V1.0.4: powermax_volume resource

Mon, 01 Jan 0001 00:00:00 +0000

powermax_volume (Resource)

Resource for managing Volumes in PowerMax array. PowerMax volumes is an identifiable unit of data storage. Storage groups are sets of volumes.

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.
*/

# Available actions: Create, Update (vol_name, mobility_id_enabled, size, cap_unit), Delete and Import an existing volume from the PowerMax Array.
# After `terraform apply` of this example file it will create a new volume with the name set in `vol_name` attribute on the PowerMax

# PowerMax volumes is an identifiable unit of data storage. Storage groups are sets of volumes.
resource "powermax_volume" "test" {

  # Attributes which are able to be modified after create (vol_name, mobility_id_enabled, size, cap_unit)

  # Required name of the volume to be created
  vol_name = "terraform_volume"

  # Required size of the volume
  size = 2.45

  # Required name of the storage group which the volume will be created with
  sg_name = "terraform_sg"

  # Optional Default Unit is GB
  # Possible units are MB, GB, TB, and CYL
  cap_unit = "GB"

  # Optional enable the mobility id 
  mobility_id_enabled = false

}

# After the execution of above resource block, a PowerMax volume has been created at PowerMax array.
# For more information about the newly created resource use the `terraform show` command to review the current state

Schema

Required

sg_name (String) The name of the storage group. sg_name is required while creating the volume.
size (Number) The size of the volume. (Update Supported)
vol_name (String) The name of the volume. Only alphanumeric characters, underscores ( _ ). (Update Supported)

Optional

cap_unit (String) The Capacity Unit corresponding to the size. (Update Supported)
mobility_id_enabled (Boolean) States whether mobility ID is enabled on the volume. (Update Supported)

Read-Only

allocated_percent (Number) The allocated percentage of the volume.
effective_wwn (String) Effective WWN of the volume.
emulation (String) The emulation of the volume Enumeration values.
encapsulated (Boolean) States whether the volume is encapsulated.
encapsulated_wwn (String) Encapsulated WWN of the volume.
has_effective_wwn (Boolean) States whether volume has effective WWN.
id (String) The ID of the volume.
nguid (String) The NGUID of the volume.
num_of_front_end_paths (Number) The number of front end paths of the volume.
num_of_storage_groups (Number) The number of storage groups associated with the volume.
oracle_instance_name (String) Oracle instance name associated with the volume.
pinned (Boolean) States whether the volume is pinned.
rdf_group_ids (Attributes List) The RDF groups associated with the volume. (see below for nested schema)
reserved (Boolean) States whether the volume is reserved.
snapvx_source (Boolean) States whether the volume is a snapvx source.
snapvx_target (Boolean) States whether the volume is a snapvx target.
ssid (String) The ssid of the volume.
status (String) The status of the volume.
storage_groups (Attributes List) List of storage groups which are associated with the volume. (see below for nested schema)
symmetrix_port_key (Attributes List) The symmetrix ports associated with the volume. (see below for nested schema)
type (String) The type of the volume.
unreducible_data_gb (Number) The amount of unreducible data in Gb.
wwn (String) The WWN of the volume.

Nested Schema for `rdf_group_ids`

Read-Only:

label (String) The label of the rdf group.
rdf_group_number (Number) The number of rdf group.

Nested Schema for `storage_groups`

Read-Only:

parent_storage_group_name (String) The ID of the storage group parents.
storage_group_name (String) The ID of the storage group.

Nested Schema for `symmetrix_port_key`

Read-Only:

director_id (String) The ID of the director.
port_id (String) The ID of the symmetrix port.

Import

Import is supported using the following syntax:

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

# The command is
# terraform import powermax_volume.test <id>
# Example:
terraform import powermax_volume.test terraform_volume
# after running this command, populate the name field in the config file to start managing this resource

Dell Technologies – Terraform Providers

V1.0.4: Support

V1.0.4: ReadMe

Terraform Provider for Dell Technologies PowerMax

Table of Contents

Support

License

Prerequisites

List of DataSources in Terraform Provider for Dell PowerMax

List of Resources in Terraform Provider for Dell PowerMax

Installation and execution of Terraform Provider for Dell PowerMax

Releasing, Maintenance and Deprecation

V1.0.4: Installation Guide

Installation of Terraform Provider for Dell PowerMax

Installation from public repository

Installation from source code

Usage

SSL Certificate Verification

V1.0.4: Release Notes

Terraform Provider for Dell PowerMax

Release Notes 1.0.4

Content

Revision history

Product Description

New features & enhancement

Limitations

Distribution

Documentation

V1.0.4: Licensing

V1.0.4: Creating Multiple Volumes

Example

Example

V1.0.4: Environment Variables

Environment Variables Overview

Export or Directly Set During Terraform Command

Using the External Terraform Provider

V1.0.4: How to use our Provider

Example

Argument Reference

Required

Optional

Bug Reports and Contributing

V1.0.4: powermax_host data source

powermax_host (Data Source)

Example Usage

Schema

Optional

Read-Only

Nested Schema for filter

Nested Schema for timeouts

Nested Schema for hosts

Nested Schema for hosts.host_flags

Nested Schema for hosts.host_flags.avoid_reset_broadcast

Nested Schema for hosts.host_flags.disable_q_reset_on_ua

Nested Schema for hosts.host_flags.environ_set

Nested Schema for hosts.host_flags.openvms

Nested Schema for hosts.host_flags.scsi_3

Nested Schema for hosts.host_flags.scsi_support1

Nested Schema for hosts.host_flags.spc2_protocol_version

Nested Schema for hosts.host_flags.volume_set_addressing

V1.0.4: powermax_host resource

powermax_host (Resource)

Example Usage

Schema

Required

Optional

Read-Only

Nested Schema for host_flags

Nested Schema for host_flags.avoid_reset_broadcast

Nested Schema for host_flags.disable_q_reset_on_ua

Nested Schema for host_flags.environ_set

Nested Schema for host_flags.openvms

Nested Schema for host_flags.scsi_3

Nested Schema for host_flags.scsi_support1

Nested Schema for host_flags.spc2_protocol_version

Nested Schema for host_flags.volume_set_addressing

Import

V1.0.4: powermax_hostgroup data source

powermax_hostgroup (Data Source)

Example Usage

Nested Schema for `filter`

Nested Schema for `timeouts`

Nested Schema for `hosts`

Nested Schema for `hosts.host_flags`

Nested Schema for `hosts.host_flags.avoid_reset_broadcast`

Nested Schema for `hosts.host_flags.disable_q_reset_on_ua`

Nested Schema for `hosts.host_flags.environ_set`

Nested Schema for `hosts.host_flags.openvms`

Nested Schema for `hosts.host_flags.scsi_3`

Nested Schema for `hosts.host_flags.scsi_support1`

Nested Schema for `hosts.host_flags.spc2_protocol_version`

Nested Schema for `hosts.host_flags.volume_set_addressing`

Nested Schema for `host_flags`

Nested Schema for `host_flags.avoid_reset_broadcast`

Nested Schema for `host_flags.disable_q_reset_on_ua`

Nested Schema for `host_flags.environ_set`

Nested Schema for `host_flags.openvms`

Nested Schema for `host_flags.scsi_3`

Nested Schema for `host_flags.scsi_support1`

Nested Schema for `host_flags.spc2_protocol_version`

Nested Schema for `host_flags.volume_set_addressing`

Nested Schema for `filter`

Nested Schema for `timeouts`

Nested Schema for `host_group_details`

Nested Schema for `host_group_details.host`

Nested Schema for `host_flags`

Nested Schema for `host_flags.avoid_reset_broadcast`

Nested Schema for `host_flags.disable_q_reset_on_ua`

Nested Schema for `host_flags.environ_set`

Nested Schema for `host_flags.openvms`

Nested Schema for `host_flags.scsi_3`

Nested Schema for `host_flags.scsi_support1`

Nested Schema for `host_flags.spc2_protocol_version`

Nested Schema for `host_flags.volume_set_addressing`

Nested Schema for `filter`

Nested Schema for `timeouts`

Nested Schema for `masking_views`

Nested Schema for `filter`

Nested Schema for `timeouts`

Nested Schema for `port_details`

Nested Schema for `ports`

Nested Schema for `filter`

Nested Schema for `timeouts`

Nested Schema for `port_groups`

Nested Schema for `port_groups.ports`