From 69249f728379180cbf05fdbf4014a43398cf594c Mon Sep 17 00:00:00 2001 From: AWS <> Date: Thu, 27 May 2021 18:04:34 +0000 Subject: [PATCH] Amazon FSx Update: This release adds LZ4 data compression support to FSx for Lustre to reduce storage consumption of both file system storage and file system backups. --- .../feature-AmazonFSx-66e0101.json | 6 +++++ .../codegen-resources/service-2.json | 23 +++++++++++++++++-- 2 files changed, 27 insertions(+), 2 deletions(-) create mode 100644 .changes/next-release/feature-AmazonFSx-66e0101.json diff --git a/.changes/next-release/feature-AmazonFSx-66e0101.json b/.changes/next-release/feature-AmazonFSx-66e0101.json new file mode 100644 index 000000000000..e20d6b758174 --- /dev/null +++ b/.changes/next-release/feature-AmazonFSx-66e0101.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "Amazon FSx", + "contributor": "", + "description": "This release adds LZ4 data compression support to FSx for Lustre to reduce storage consumption of both file system storage and file system backups." +} diff --git a/services/fsx/src/main/resources/codegen-resources/service-2.json b/services/fsx/src/main/resources/codegen-resources/service-2.json index b00114e4b4cb..78bfb488c41d 100644 --- a/services/fsx/src/main/resources/codegen-resources/service-2.json +++ b/services/fsx/src/main/resources/codegen-resources/service-2.json @@ -67,7 +67,7 @@ {"shape":"SourceBackupUnavailable"}, {"shape":"IncompatibleRegionForMultiAZ"} ], - "documentation":"
Copies an existing backup within the same AWS account to another Region (cross-Region copy) or within the same Region (in-Region copy). You can have up to five backup copy requests in progress to a single destination Region per account.
You can use cross-Region backup copies for cross-region disaster recovery. You periodically take backups and copy them to another Region so that in the event of a disaster in the primary Region, you can restore from backup and recover availability quickly in the other Region. You can make cross-Region copies only within your AWS partition.
You can also use backup copies to clone your file data set to another Region or within the same Region.
You can use the SourceRegion
parameter to specify the AWS Region from which the backup will be copied. For example, if you make the call from the us-west-1
Region and want to copy a backup from the us-east-2
Region, you specify us-east-2
in the SourceRegion
parameter to make a cross-Region copy. If you don't specify a Region, the backup copy is created in the same Region where the request is sent from (in-Region copy).
For more information on creating backup copies, see Copying backups in the Amazon FSx for Windows User Guide and Copying backups in the Amazon FSx for Lustre User Guide.
", + "documentation":"Copies an existing backup within the same AWS account to another Region (cross-Region copy) or within the same Region (in-Region copy). You can have up to five backup copy requests in progress to a single destination Region per account.
You can use cross-Region backup copies for cross-region disaster recovery. You periodically take backups and copy them to another Region so that in the event of a disaster in the primary Region, you can restore from backup and recover availability quickly in the other Region. You can make cross-Region copies only within your AWS partition.
You can also use backup copies to clone your file data set to another Region or within the same Region.
You can use the SourceRegion
parameter to specify the AWS Region from which the backup will be copied. For example, if you make the call from the us-west-1
Region and want to copy a backup from the us-east-2
Region, you specify us-east-2
in the SourceRegion
parameter to make a cross-Region copy. If you don't specify a Region, the backup copy is created in the same Region where the request is sent from (in-Region copy).
For more information on creating backup copies, see Copying backups in the Amazon FSx for Windows User Guide and Copying backups in the Amazon FSx for Lustre User Guide.
", "idempotent":true }, "CreateBackup":{ @@ -338,7 +338,7 @@ {"shape":"MissingFileSystemConfiguration"}, {"shape":"ServiceLimitExceeded"} ], - "documentation":"Use this operation to update the configuration of an existing Amazon FSx file system. You can update multiple properties in a single request.
For Amazon FSx for Windows File Server file systems, you can update the following properties:
AutomaticBackupRetentionDays
DailyAutomaticBackupStartTime
SelfManagedActiveDirectoryConfiguration
StorageCapacity
ThroughputCapacity
WeeklyMaintenanceStartTime
For Amazon FSx for Lustre file systems, you can update the following properties:
AutoImportPolicy
AutomaticBackupRetentionDays
DailyAutomaticBackupStartTime
StorageCapacity
WeeklyMaintenanceStartTime
Use this operation to update the configuration of an existing Amazon FSx file system. You can update multiple properties in a single request.
For Amazon FSx for Windows File Server file systems, you can update the following properties:
AutomaticBackupRetentionDays
DailyAutomaticBackupStartTime
SelfManagedActiveDirectoryConfiguration
StorageCapacity
ThroughputCapacity
WeeklyMaintenanceStartTime
For Amazon FSx for Lustre file systems, you can update the following properties:
AutoImportPolicy
AutomaticBackupRetentionDays
DailyAutomaticBackupStartTime
DataCompressionType
StorageCapacity
WeeklyMaintenanceStartTime
The type of drive cache used by PERSISTENT_1 file systems that are provisioned with HDD storage devices. This parameter is required when storage type is HDD. Set to READ
, improve the performance for frequently accessed files and allows 20% of the total storage capacity of the file system to be cached.
This parameter is required when StorageType
is set to HDD.
Sets the data compression configuration for the file system. DataCompressionType
can have the following values:
NONE
- (Default) Data compression is turned off when the file system is created.
LZ4
- Data compression is turned on with the LZ4 algorithm.
For more information, see Lustre data compression.
" } }, "documentation":"The Lustre configuration for the file system being created.
" @@ -1056,6 +1060,13 @@ "min":5, "pattern":"^([01]\\d|2[0-3]):?([0-5]\\d)$" }, + "DataCompressionType":{ + "type":"string", + "enum":[ + "NONE", + "LZ4" + ] + }, "DataRepositoryConfiguration":{ "type":"structure", "members":{ @@ -1957,6 +1968,10 @@ "DriveCacheType":{ "shape":"DriveCacheType", "documentation":"The type of drive cache used by PERSISTENT_1 file systems that are provisioned with HDD storage devices. This parameter is required when storage type is HDD. Set to READ
, improve the performance for frequently accessed files and allows 20% of the total storage capacity of the file system to be cached.
This parameter is required when StorageType
is set to HDD.
The data compression configuration for the file system. DataCompressionType
can have the following values:
NONE
- Data compression is turned off for the file system.
LZ4
- Data compression is turned on with the LZ4 algorithm.
For more information, see Lustre data compression.
" } }, "documentation":"The configuration for the Amazon FSx for Lustre file system.
" @@ -2393,6 +2408,10 @@ "AutoImportPolicy":{ "shape":"AutoImportPolicyType", "documentation":" (Optional) When you create your file system, your existing S3 objects appear as file and directory listings. Use this property to choose how Amazon FSx keeps your file and directory listing up to date as you add or modify objects in your linked S3 bucket. AutoImportPolicy
can have the following values:
NONE
- (Default) AutoImport is off. Amazon FSx only updates file and directory listings from the linked S3 bucket when the file system is created. FSx does not update the file and directory listing for any new or changed objects after choosing this option.
NEW
- AutoImport is on. Amazon FSx automatically imports directory listings of any new objects added to the linked S3 bucket that do not currently exist in the FSx file system.
NEW_CHANGED
- AutoImport is on. Amazon FSx automatically imports file and directory listings of any new objects added to the S3 bucket and any existing objects that are changed in the S3 bucket after you choose this option.
For more information, see Automatically import updates from your S3 bucket.
" + }, + "DataCompressionType":{ + "shape":"DataCompressionType", + "documentation":"Sets the data compression configuration for the file system. DataCompressionType
can have the following values:
NONE
- Data compression is turned off for the file system.
LZ4
- Data compression is turned on with the LZ4 algorithm.
If you don't use DataCompressionType
, the file system retains its current data compression configuration.
For more information, see Lustre data compression.
" } }, "documentation":"The configuration object for Amazon FSx for Lustre file systems used in the UpdateFileSystem
operation.