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

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)