Modifying SSD storage capacity and provisioned IOPS - FSx for ONTAP
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Modifying SSD storage capacity and provisioned IOPS

You can increase a file system's SSD-based storage, and you increase or decrease the amount of provisioned SSD IOPS by using the Amazon FSx console, the Amazon CLI, and the API.

  1. Open the Amazon FSx console at https://console.amazonaws.cn/fsx/.

  2. In the left navigation pane, choose File systems. In the File systems list, select the FSx for ONTAP file system that you want to update SSD storage capacity and SSD IOPS for.

  3. Choose Actions > Update storage capacity. Or, in the Summary section, choose Update next to the file system's SSD storage capacity value.

    The Update SSD storage capacity and IOPS dialog box appears.

    Console image showing the Update SSD storage capacity and IOPS dialog box.

  4. To increase SSD storage capacity, choose Modify storage capacity.

  5. For Input type, choose one of the following:

    • To enter the new SSD storage capacity as a percentage change from the current value, choose Percentage.

    • To enter the new value in GiB, choose Absolute.

  6. Depending on the input type, enter a value for Desired % increase.

    • For Percentage, enter the percentage increase value. This value must be at least 10 percent greater than the current value.

    • For Absolute, enter the new value in GiB, up to the maximum allowed value of 196,608 GiB.

  7. For Provisioned SSD IOPS, you have two options to modify the number of provisioned SSD IOPS for your file system:

    • If you want Amazon FSx to automatically scale your SSD IOPS to maintain 3 provisioned SSD IOPS per GiB of SSD storage capacity (up to a maximum of 160,000), choose Automatic.

    • If you want to specify the number of SSD IOPS, choose User-provisioned. Enter an absolute number of IOPS that's at least three times the amount of GiB of your SSD storage tier, and less than or equal to 160,000.

    Note

    For more information about the maximum number of SSD IOPS that you can provision for your FSx for ONTAP file system, see Impact of throughput capacity on performance.

  8. Choose Update.

    Note

    At the bottom of the prompt, a configuration preview is shown for your new SSD storage capacity and SSD IOPS. For scale-out file systems, the per-HA-pair value is also shown.

To update the SSD storage capacity and provisioned IOPS for an FSx for ONTAP file system, use the Amazon CLI command update-file-system or the equivalent UpdateFileSystem API action. Set the following parameters with your values:

  • Set --file-system-id to the ID of the file system that you are updating.

  • To increase your SSD storage capacity, set --storage-capacity to the target storage capacity value, which must be at least 10 percent greater than the current value.

  • To modify your provisioned SSD IOPS, use the --ontap-configuration DiskIopsConfiguration property. This property has two parameters, Iops and Mode:

    • If you want to specify the number of provisioned IOPS, use Iops=number_of_IOPS (up to a maximum of 160,000) and Mode=USER_PROVISIONED. The IOPS value must be greater than or equal to three times the requested SSD storage capacity. If you're not increasing the storage capacity, the IOPs value must be greater than or equal to three times the current SSD storage capacity.

    • If you want Amazon FSx to automatically increase your SSD IOPS, use Mode=AUTOMATIC and don't use the Iops parameter. Amazon FSx will automatically maintain 3 SSD IOPS per GiB of the provisioned SSD storage capacity (up to a maximum of 160,000).

    Note

    For more information about the maximum number of SSD IOPS that you can provision for your FSx for ONTAP file system, see Impact of throughput capacity on performance.

The following example increases the file system’s SSD storage to 2000 GiB and sets amount of user provisioned SSD IOPS to 7000.

aws fsx update-file-system \
--file-system-id fs-0123456789abcdef0 \
--storage-capacity 2000 \
--ontap-configuration 'DiskIopsConfiguration={Iops=7000,Mode=USER_PROVISIONED}'

To monitor the progress of the update, use the describe-file-systems Amazon CLI command. Look for the AdministrativeActions section in the output.

For more information, see AdministrativeAction in the Amazon FSx for NetApp ONTAP API Reference.