UpdateFileSystemLustreMetadataConfiguration - Amazon FSx
ContentsSee Also
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

UpdateFileSystemLustreMetadataConfiguration

The Lustre metadata performance configuration update for an Amazon FSx for Lustre file system using a PERSISTENT_2 deployment type. You can request an increase in your file system's Metadata IOPS and/or switch your file system's metadata configuration mode. For more information, see Managing metadata performance in the Amazon FSx for Lustre User Guide.

Contents

Iops

(USER_PROVISIONED mode only) Specifies the number of Metadata IOPS to provision for your file system.

  • For SSD file systems, valid values are 1500, 3000, 6000, 12000, and multiples of 12000 up to a maximum of 192000.

  • For Intelligent-Tiering file systems, valid values are 6000, 12000, and multiples of 12000 up to a maximum of 192000.

The value you provide must be greater than or equal to the current number of Metadata IOPS provisioned for the file system. You can't provision fewer Metadata IOPS than AUTOMATIC mode provisions for your file system.

Type: Integer

Valid Range: Minimum value of 1500. Maximum value of 192000.

Required: No

Mode

The metadata configuration mode for provisioning Metadata IOPS for an FSx for Lustre file system using a PERSISTENT_2 deployment type.

  • To increase the Metadata IOPS or to switch from AUTOMATIC mode, specify USER_PROVISIONED as the value for this parameter. Then use the Iops parameter to provide a Metadata IOPS value that is greater than or equal to the current number of Metadata IOPS provisioned for the file system.

  • To switch from USER_PROVISIONED mode, specify AUTOMATIC as the value for this parameter, but do not input a value for Iops.

    Note

    • FSx for Lustre rejects a switch to AUTOMATIC mode when your current Metadata IOPS value is greater than what AUTOMATIC mode provisions, because decreasing Metadata IOPS is not supported. To unblock the switch, increase storage capacity for SSD file systems, or throughput capacity for Intelligent-Tiering file systems, until AUTOMATIC mode provisions at least your current Metadata IOPS.

Type: String

Valid Values: AUTOMATIC | USER_PROVISIONED

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: