Managing SSD IOPS - Amazon FSx for Windows File Server
Important points to know when updating SSD IOPSHow to update SSD IOPSMonitoring provisioned SSD IOPS updates
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).

Managing SSD IOPS

For SSD storage volumes, you can select and scale IOPS independently of storage capacity. The maximum SSD IOPS that you can provision is dependent on the amount of storage capacity and throughput capacity you select for your file system. If you attempt to increase your SSD IOPS above the limit that's supported by your throughput capacity, you might need to increase your throughput capacity to support the requested SSD IOPS level. For more information, see FSx for Windows File Server performance and Managing throughput capacity.

Important points to know when updating SSD IOPS

Here are a few important items to consider when updating SSD IOPS:

  • To specify the amount of provisioned SSD IOPS for your file system, you must choose one of two IOPS modes:

    • Automatic – Amazon FSx automatically scales your SSD IOPS to maintain 3 SSD IOPS per GiB of storage capacity, up to 400,000 SSD IOPS per file system.

    • User-provisioned – You specify the number of SSD IOPS within the range of 96–400,000. Specify a number between 3–50 IOPS per GiB of storage capacity for all Amazon Web Services Regions where Amazon FSx is available, or between 3–500 IOPS per GiB of storage capacity in US East (N. Virginia), US West (Oregon), US East (Ohio), Europe (Ireland), Asia Pacific (Tokyo), and Asia Pacific (Singapore). If the amount of SSD IOPS is not at least 3 IOPS per GiB, the request fails. For higher levels of provisioned SSD IOPS, you pay for the average IOPS above 3 IOPS per GiB per file system.

  • Storage capacity updates – If you increase your storage capacity, and the new capacity requires a higher level of SSD IOPS than your user-provisioned SSD IOPS level, Amazon FSx automatically switches your file system to Automatic mode.

  • Throughput capacity updates – If you increase your throughput capacity, and the maximum SSD IOPS supported by your new throughput capacity is higher than your user-provisioned SSD IOPS level, Amazon FSx automatically switches your file system to Automatic mode.

  • Time between increases – You can't make further SSD IOPS increases, throughput capacity increases, or storage type updates on a file system until 6 hours after the last increase was requested, or until the storage optimization process has completed—whichever time is longer. Storage optimization can take from a few hours up to a few days to complete. To minimize the time it takes for storage optimization to complete, we recommend scaling SSD IOPS when there is minimal traffic on the file system.

Note

Note that throughput capacity levels of 4,608 MBps and higher are supported only in the following Amazon Web Services Regions: US East (N. Virginia), US West (Oregon), US East (Ohio), Europe (Ireland), Asia Pacific (Tokyo), and Asia Pacific (Singapore).

How to update SSD IOPS

You can update SSD IOPS for a file system using the Amazon FSx console, the Amazon CLI, or the Amazon FSx API.

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

  2. Navigate to File systems and choose the Windows file system that you want to update SSD IOPS for.

  3. Under Actions, choose Update SSD IOPS. Or, in the Summary panel, select the Update button next to Provisioned SSD IOPS. The Update IOPS provisioning window opens.

    Console screenshot of the Update provisioned SSD IOPS panel.

  4. For Mode, choose Automatic or User-provisioned. If you choose Automatic, Amazon FSx automatically provisions 3 SSD IOPS per GiB of storage capacity for your file system. If you choose User-provisioned, enter any whole number in the range of 96–400,000.

  5. Choose Update to initiate the provisioned SSD IOPS update.

  6. You can monitor the update progress on the File systems detail page, on the Updates tab.

To update SSD IOPS for an FSx for Windows File Server file system, use the --windows-configuration DiskIopsConfiguration property. This property has two parameters, Iops and Mode:

  • If you want to specify the number of SSD IOPS, use Iops=number_of_IOPS, up to a maximum of 400,000 in supported Amazon Regions and Mode=USER_PROVISIONED.

  • If you want Amazon FSx to increase your SSD IOPS automatically, use Mode=AUTOMATIC and don't use the Iops parameter. Amazon FSx automatically maintains 3 SSD IOPS per GiB of storage capacity on your file system, up to a maximum of 400,000 in supported Amazon Regions.

You can monitor the progress of the update by using the Amazon CLI command describe-file-systems. Look for the administrative-actions in the output.

For more information, see AdministrativeAction.

Monitoring provisioned SSD IOPS updates

You can monitor the progress of a provisioned SSD IOPS update using the Amazon FSx console, the API, or the Amazon CLI.

Monitoring updates in the console

In the Updates tab in the File system details window, you can view the 10 most recent updates for each update type.

Console screen shot showing recent updates list.

For provisioned SSD IOPS updates, you can view the following information.

Update type

Possible values are IOPS Mode and SSD IOPS.

Target value

The desired value to update the file system's IOPS mode and SSD IOPS to.

Status

The current status of the update. For SSD IOPS updates, the possible values are as follows:

  • Pending – Amazon FSx has received the update request, but has not started processing it.

  • In progress – Amazon FSx is processing the update request.

  • Updated optimizing – The new IOPS level is available for your workload's write operations. Your update enters an Updated optimizing state, which typically lasts a few hours, during which your workload's read operations have IOPS performance between the previous level and the new level. After your update action is complete, your new IOPS level is available for both reads and writes.

  • Completed – The SSD IOPS update completed successfully.

  • Failed – The SSD IOPS update failed. Choose the question mark (?) to see details on why the storage update failed.

Progress %

Displays the progress of the storage optimization process as percent complete.

Request time

The time that Amazon FSx received the update action request.

Monitoring updates with the Amazon CLI and API

You can view and monitor file system SSD IOPS update requests using the describe-file-systems Amazon CLI command and the DescribeFileSystems API action. The AdministrativeActions array lists the 10 most recent update actions for each administrative action type. When you increase a file system's SSD IOPS, two AdministrativeActions are generated: a FILE_SYSTEM_UPDATE and an IOPS_OPTIMIZATION action.