powerstore_io_limit_rule (Resource)

This resource is used to manage the I/O limit rule entity of PowerStore Array. We can Create, Update and Delete the I/O limit rule using this resource. We can also import an existing I/O limit rule from PowerStore array.

Example Usage

/*
Copyright (c) 2024 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.
*/

# Commands to run this tf file : terraform init && terraform plan && terraform apply
# Create, Update, Delete is supported for this resource
# To import, check import.sh for more info
# name is required attribute to create
# type, max_iops, max_bw, and burst_percentage are optional attributes

resource "powerstore_io_limit_rule" "terraform-provider-test1" {
  name             = "test_io_limit_rule1"
  type             = "Volume"
  max_iops         = 1000
  max_bw           = 100
  burst_percentage = 100
}

Schema

Required

name (String) Name of the I/O limit rule.
type (String) Type of bandwidth limit (Absolute or Density). Absolute limits are absolute values specified in I/O operations per second or bandwidth. Density limits are per GB, e.g., I/O operations per second per GB.

Optional

burst_percentage (Number) Percentage indicating by how much the limit may be exceeded. If I/O normally runs below the specified limit, then the volume or volume group will accumulate burst credits that can be used to exceed the limit for a short period.
max_bw (Number) Maximum I/O bandwidth measured in either Kilobytes per second or Kilobytes per second / per GB. If type is set to Absolute, max_bw is specified in Kilobytes per second. If type is set to Density, max_bw is specified in Kilobytes per second / per GB.
max_iops (Number) Maximum I/O operations in either I/O operations per second (IOPS) or I/O operations per second per GB. If type is set to Absolute, max_iops is specified in IOPS. If type is set to Density, max_iops is specified in IOPS per GB.

Read-Only

id (String) Unique identifier of the I/O limit rule.

Import

Import is supported using the following syntax:

#!/bin/bash
# Copyright (c) 2024-2025 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.

# Script to import an existing IO limit rule into Terraform
# Usage: ./import.sh <io_limit_rule_id>

if [ -z "$1" ]; then
  echo "Usage: $0 <io_limit_rule_id>"
  echo "Example: $0 643d8f3c-7b8c-4d1e-9f2a-1b3c4d5e6f7g"
  exit 1
fi

terraform import powerstore_io_limit_rule.terraform-provider-test1 "$1"