---
name: FileStorage-adjustable-iops
title: Adjusting IOPS for File Storage for Classic volumes
description: Adjust the input/output operations per second (IOPS) value for your file storage volume immediately without outage or disruption.
last-updated: 2026-06-09
---
> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/FileStorage?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.
# Adjusting IOPS for File Storage for Classic volumes
{: #adjustingIOPS}
Adjust the input/output operations per second (IOPS) value for your file storage volume immediately without outage or disruption.
{: shortdesc}
Billing for the storage is updated to add the prorated difference of the new price to the current billing cycle. The full new amount is billed in the next billing cycle.
## Advantages of adjustable IOPS
{: #advantagesadjustableIOPS}
- Cost management: Clients can adjust IOPS based on usage patterns. For example, a large retail store experiences peak usage during the holidays and requires higher IOPS on the storage during that peak than in the middle of the summer. With this feature, you can manage your costs and pay for higher IOPS only when you need it.
## Limitations
{: #limitsofadjustIOPS}
You can’t switch between Endurance and Performance when you adjust your IOPS. You can specify a new IOPS value for your storage based on the following criteria:
| Volume size (GB) | IOPS range |
|-------------|-----------------|
| 10 - 39 | 100 - 1,000 |
| 40 - 79 | 100 - 2,000 |
| 80 - 99 | 100 - 4,000 |
| 100 - 499 | 100 - 6,000 |
| 500 - 999 | 100 - 10,000|
| 1,000 - 1,999 | 100 - 20,000|
| 2,000 - 2,999 | 200 - 40,000|
| 3,000 - 3,999 | 200 - 48,000|
| 4,000 - 7,999 | 300 - 48,000|
| 8,000 - 9,999 | 500 - 48,000 |
| 10,000 - 12,000 | 1,000 - 48,000 |
{: caption="Available IOPS based on volume size." caption-side="bottom"}
Maximum IOPS for file storage share varies based on volume size. The maximum IOPS for a file share is 48,000 IOPS.
## Effect of IOPS adjustment on replication
{: #IOPSchangereplica}
If the volume has replication in place, the replica is automatically updated to match the IOPS selection of the primary.
## Adjusting the IOPS on your Storage in the console
{: #adjustingstepsUI}
{: ui}
1. Go to your list of File Storage for Classic. From the IBM Cloud® console, click**Infrastructure**  > **Classic Infrastructure** > **Storage** > **File Storage for Classic**.
2. Select the volume from the list and click the ellipsis  > **Modify File Share**.
3. In the **Adjust Storage IOPS** section, make a new selection:
- For Endurance (Tiered IOPS), select a different IOPS tier for your storage. You can increase the IOPS tier at any time. However, decreasing is available only once a month.
- For Performance (Allocated IOPS), specify a new IOPS option for your storage by entering a value in the range 100-48,000 IOPS.
4. Review your selection and the new pricing. Click **Modify**.
5. Your new storage allocation is going to be available in a few minutes.
## Adjusting the IOPS on your Storage from the CLI
{: #adjustingstepsCLI}
{: cli}
Before you can begin the process, decide on the command-line interface (CLI) client that you want to use.
* You can either install the [IBM Cloud CLI](https://cloud.ibm.com/docs/cli?format=markdown){: external} and install the SL plug-in with `ibmcloud plugin install sl`. For more information, see [Extending IBM Cloud CLI with plug-ins](https://cloud.ibm.com/docs/cli?topic=cli-plug-ins&format=markdown).
* Or, you can install the [SLCLI](https://softlayer-python.readthedocs.io/en/latest/cli/){: external}.
### Adjusting the IOPS from the IBMCLOUD CLI
{: #adjustIOPSICCLI}
You can update the IOPS by using the `ibmcloud sl file volume-modify` command. The following example modifies a Performance file share by specifying a new IOPS value.
```sh
ibmcloud sl file volume-modify 12345678 --new-iops 4000
```
{: pre}
The following example modifies an Endurance file share by specifying a new IOPS tier.
```sh
ibmcloud sl file volume-modify 12345678 --new-tier 4
```
{: pre}
For more information about all of the parameters that are available for this command, see [ibmcloud sl file volume-modify](https://cloud.ibm.com/docs/cli?topic=cli-sl-file-storage-service&format=markdown#sl_file_volume_modify){: external}.
### Adjusting the IOPS from the SLCLI
{: #adjustIOPSSLCLI}
You can update the IOPS by using the following command.
```sh
$ slcli file volume-modify --help
Usage: slcli file volume-modify [OPTIONS] VOLUME_ID
Options:
-c, --new-size INTEGER New Size of file volume in GB. ***If no size
is given, the original size of volume is
used.***
Potential Sizes: [20, 40, 80, 100,
250, 500, 1000, 2000, 4000, 8000, 12000]
Minimum: [the original size of the volume]
-i, --new-iops INTEGER Performance Storage IOPS, between 100 and 6000
in multiples of 100 [only for performance
volumes] ***If no IOPS value is specified, the
original IOPS value of the volume will be
used.***
-t, --new-tier [0.25|2|4|10] Endurance Storage Tier (IOPS per GB) [only for
endurance volumes] ***If no tier is specified,
the original tier of the volume will be
used.***
-h, --help Show this message and exit.
```
{: codeblock}
## Adjusting the IOPS on your Storage with the API
{: #adjustingstepsAPI}
{: api}
You can adjust the IOPS by using an application programming interface (API) call to the SOAP web service. The following sample API calls can be made from the scripting language of your choice.
For more information about the SLAPI, see the [SLDN](http://sldn.softlayer.com/reference/softlayerapi){: external}.
{: tip}
* The following example shows how to request an IOPS change on a Performance storage volume. `XXXXXXXXX` is the ID of the volume that you want to modify. `3000` is the new IOPS value that you want your volume to have. `189433` is the ID of the max level price. `190233` is the ID of 2000-2999 GB capacity range. `190293` is the ID for the 200-40000 IOPS range.
```python
XXXXXXXXX
3000
759
-
189433
-
190233
-
190293
```
{: codeblock}
* The following example shows how to adjust IOPS on Endurance storage volume. `XXXXXXXXX` is the ID of the volume that you want to modify. `4` is the new IOPS tier value that you want your volume to have. `189433` is the ID of the max level price. `193373` and `193433` are the IDs for the price ranges for the capacity and IOPS that the volume has.
```python
XXXXXXXX
759
4
-
189433
-
193373
-
193433
```
{: codeblock}
## Adjusting the IOPS on your Storage with Terraform
{: #adjustingstepsTerraform}
{: terraform}
You can adjust the IOPS by using the `ibm_storage_file` resource, and specifying a different number in the `iops` argument. The following example increases the performance tier of an Endurance share to the 4 IOPS/GB tier.
```terraform
resource "ibm_storage_file" "fs_endurance" {
type = "Endurance"
datacenter = "dal09"
capacity = 20
iops = 4
}
```
{: codeblock}
The following example changes the performance level of a Performance share to 150 IOPS.
```terraform
resource "ibm_storage_file" "fs_performance" {
type = "Performance"
datacenter = "dal09"
capacity = 20
iops = 150
}
```
{: codeblock}
For more information about the arguments and attributes, see [ibm_storage_file](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/storage_file){: external}.