Document history for the Amazon S3 File Gateway User Guide - Amazon Storage Gateway
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).

Document history for the Amazon S3 File Gateway User Guide

  • API version: 2013-06-30

  • Latest documentation update: June 06, 2024

The following table describes important changes in each release of this user guide after April 2018. For notification about updates to this documentation, you can subscribe to an RSS feed.

ChangeDescriptionDate

Notice of availability change for FSx File Gateway

Amazon FSx File Gateway is no longer available to new customers. Existing customers of FSx File Gateway can continue to use the service normally. For capabilities similar to FSx File Gateway, visit this blog post.

October 28, 2024

Notice of availability change for FSx File Gateway

Amazon Storage Gateway’s FSx File Gateway will no longer be available to new customers starting 10/28/24. To use the service, you must sign up prior to that date. Existing customers of FSx File Gateway can continue to use the service normally. For capabilities similar to FSx File Gateway, visit this blog post.

September 26, 2024

Added support for Dual-layer Server-Side Encryption with Amazon KMS keys (DSSE-KMS)

You can now use dual-layer server-side encryption with Amazon KMS keys to encrypt the files that S3 File Gateway uploads to Amazon S3. For more information about DSSE-KMS, see Encrypt objects stored by File Gateway in Amazon S3.

September 13, 2024

Added option to turn maintenance updates on or off

Storage Gateway receives regular maintenance updates that can include operating system and software upgrades, fixes to address stability, performance, and security, and access to new features. You can now configure a setting to turn these updates on or off for each individual gateway in your deployment. For more information, see Managing gateway updates using the Amazon Storage Gateway console.

June 6, 2024

Added new SMB security level

S3 File Gateway now supports an additional security level that you can use to enforce 256-bit AES encryption for SMB client connections. For more information, see Set a security level for your gateway.

May 23, 2024

Gateway appliance software version reporting and release notes for S3 File Gateway

Added release notes to describe the new and updated features, improvements, and fixes that are included with each version of the Amazon S3 File Gateway appliance. You can determine a gateway's software version number from the Storage Gateway console or by using the Amazon CLI. For more information, see Release Notes — Gateway Appliance Software.

October 5, 2023

Updated recommended CloudWatch alarms

The CloudWatch HealthNotifications alarm now applies to and is recommended for all gateway types and host platforms. Recommended configuration settings have also been updated for HealthNotifications and AvailabilityNotifications. For more information see Understanding CloudWatch alarms.

October 2, 2023

Added GatewayClockOutOfSync troubleshooting tips

The Troubleshooting: File Gateway issues section now includes troubleshooting guidelines to help diagnose problems you may encounter if your gateway system clock is not synchronized with the Amazon Storage Gateway server time. For more information, see Error: GatewayClockOutOfSync.

October 19, 2022

Updated gateway creation procedures

The procedure for creating a new gateway has been updated to reflect changes in the Storage Gateway console. For more information, see Create and activate an Amazon S3 File Gateway.

October 12, 2021

Support for force-closing files on SMB file shares

You can now use Local Group settings to assign Gateway Admin permissions. Gateway Admins can use the Shared Folders Microsoft Management Console snap-in to force-close files that are open and locked on SMB file shares. For more information, see Configure Local Groups for your gateway.

October 12, 2021

Audit log support for NFS file shares

You can now configure NFS file shares to generate audit logs that provide details about user access to files and folders within a file share. You can use these logs to monitor user activities and take action if inappropriate activity patterns are identified. For more information, see Understanding File Gateway audit logs.

October 12, 2021

Access point alias support

File Gateway file shares can now connect to Amazon S3 storage using bucket-style access point aliases. For more information, see Create a file share.

October 12, 2021

VPC endpoint and access point support

File Gateway file shares can now connect to S3 buckets through access points or interface endpoints in your VPC powered by Amazon PrivateLink. For more information, see Create a file share.

July 7, 2021

Opportunistic locking support

File Gateway file shares can now use opportunistic locking to optimize their file buffering strategy, which improves performance in most cases, particularly with regard to Windows context menus. For more information, see Create an SMB file share.

July 7, 2021

FedRAMP compliance

Storage Gateway is now FedRAMP compliant. For more information, see Compliance validation for Storage Gateway.

November 24, 2020

File upload notification for File Gateway

File Gateway now provides file upload notification, which notifies you when a file has been fully uploaded to Amazon S3 by the File Gateway. For more information, see Getting file upload notification.

November 9, 2020

Access-based enumeration for File Gateway

File Gateway now provides access-based enumeration, which filters the enumeration of files and folders on an SMB file share based on the share's ACLs. For more information, see Creating an SMB file share.

November 9, 2020

File Gateway migration

File Gateway now provides a documented process for replacing an existing File Gateway with a new File Gateway. For more information, see Replacing a File Gateway with a new File Gateway.

October 30, 2020

File Gateway cold cache read performance 4x increase

Storage Gateway has increased cold cache read performance 4x. For more information, see Performance guidance for File Gateways.

August 31, 2020

Order the hardware appliance through the console

You can now order the hardware appliance through the Amazon Storage Gateway console. For more information, see Using the Amazon Storage Gateway Hardware Appliance.

August 12, 2020

Support for Federal Information Processing Standard (FIPS) endpoints in new Amazon Regions

You can now activate a gateway with FIPS endpoints in the US East (Ohio), US East (N. Virginia), US West (N. California), US West (Oregon), and Canada (Central) Regions. For more information, see Amazon Storage Gateway endpoints and quotas in the Amazon Web Services General Reference.

July 31, 2020

Support for multiple file shares attached to a single Amazon S3 bucket

File Gateway now supports creating multiple file shares for a single S3 bucket and synchronizing the File Gateway's local cache with a bucket based on frequency of directory access. You can limit the number of buckets necessary to manage the file shares that you create on your File Gateway. You can define multiple S3 prefixes for an S3 bucket and map a single S3 prefix to a single gateway file share. You can also define gateway file share names to be independent of the bucket name to fit the on-premises file share naming convention. For more information, see Creating an NFS file share or Creating an SMB file share.

July 7, 2020

File Gateway local cache storage 4x increase

Storage Gateway now supports a local cache of up to 64 TB for File Gateway, improving performance for on-premises applications by providing low-latency access to larger working datasets. For more information, see Recommended local disk sizes for your gateway in the Storage Gateway User Guide.

July 7, 2020

View Amazon CloudWatch alarms in the Storage Gateway console

You can now view CloudWatch alarms in the Storage Gateway console. For more information, see Understanding CloudWatch alarms.

May 29, 2020

Support for Federal Information Processing Standard (FIPS) endpoints

You can now activate a gateway with FIPS endpoints in the Amazon GovCloud (US) Regions. To choose a FIPS endpoint for a File Gateway, see Choosing a service endpoint.

May 22, 2020

New Amazon Regions

Storage Gateway is now available in the Africa (Cape Town) and Europe (Milan) Regions. For more information, see Amazon Storage Gateway endpoints and quotas in the Amazon Web Services General Reference.

May 7, 2020

Support for S3 Intelligent-Tiering storage class

Storage Gateway now supports S3 Intelligent-Tiering storage class. The S3 Intelligent-Tiering storage class optimizes storage costs by automatically moving data to the most cost-effective storage access tier, without performance impact or operational overhead. For more information, see Storage class for automatically optimizing frequently and infrequently accessed objects in the Amazon Simple Storage Service User Guide.

April 30, 2020

New Amazon Region

Storage Gateway is now available in the Amazon GovCloud (US-East) Region. For more information, see Amazon Storage Gateway Endpoints and Quotas in the Amazon Web Services General Reference.

March 12, 2020

Support for Linux Kernel-based Virtual Machine (KVM) hypervisor

Storage Gateway now provides the ability to deploy an on-premises gateway on the KVM virtualization platform. Gateways deployed on KVM have all the same functionality and features as the existing on-premises gateways. For more information, see Supported Hypervisors and Host Requirements in the Storage Gateway User Guide.

February 4, 2020

Support for VMware vSphere High Availability

Storage Gateway now provides support for high availability on VMware to help protect storage workloads against hardware, hypervisor, or network failures. For more information, see Using VMware vSphere High Availability with Storage Gateway in the Storage Gateway User Guide. This release also includes performance improvements. For more information, see Performance in the Storage Gateway User Guide.

November 20, 2019

Support for Amazon CloudWatch Logs

You can now configure File Gateways with Amazon CloudWatch Log Groups to get notified about errors and the health of your gateway and its resources. For more information, see Getting Notified About Gateway Health and Errors With Amazon CloudWatch Log Groups in the Storage Gateway User Guide.

September 4, 2019

New Amazon Web Services Region

Storage Gateway is now available in the Asia Pacific (Hong Kong) Region. For more information, see Amazon Storage Gateway Endpoints and Quotas in the Amazon Web Services General Reference.

August 14, 2019

New Amazon Web Services Region

Storage Gateway is now available in the Middle East (Bahrain) Region. For more information, see Amazon Storage Gateway Endpoints and Quotas in the Amazon Web Services General Reference.

July 29, 2019

Support for activating a gateway in a virtual private cloud (VPC)

You can now activate a gateway in a VPC. You can create a private connection between your on-premises software appliance and cloud-based storage infrastructure. For more information, see Activating a Gateway in a Virtual Private Cloud.

June 20, 2019

SMB file share support for Microsoft Windows ACLs

For File Gateways, you can now use Microsoft Windows access control lists (ACLs) to control access to Server Message Block (SMB) file shares. For more information, see Using Microsoft Windows ACLs to Control Access to an SMB File Share.

May 8, 2019

File Gateway support for tag-based authorization

File Gateway now supports tag-based authorization. You can control access to File Gateway resources based on the tags on those resources. You can also control access based on the tags that can be passed in an IAM request condition. For more information, see Controlling Access to File Gateway Resources.

March 4, 2019

Availability of Amazon Storage Gateway Hardware Appliance in Europe

The Amazon Storage Gateway Hardware Appliance is now available in Europe. For more information, see Amazon Storage Gateway Hardware Appliance Regions in the Amazon Web Services General Reference. In addition, you can now increase the useable storage on the Amazon Storage Gateway Hardware Appliance from 5 TB to 12 TB and replace the installed copper network card with a 10-gigabit fiber optic network card. For more information, see Setting Up Your Hardware Appliance.

February 25, 2019

Support for Amazon Storage Gateway Hardware Appliance

The Amazon Storage Gateway Hardware Appliance includes Storage Gateway software preinstalled on a third-party server. You can manage the appliance from the Amazon Web Services Management Console. The appliance can host file, tape, and Volume Gateways. For more information, see Using the Storage Gateway Hardware Appliance.

September 18, 2018

Support for Server Message Block (SMB) protocol

File Gateways added support for the Server Message Block (SMB) protocol to file shares. For more information, see Creating a File Share.

June 20, 2018

Earlier updates

The following table describes important changes in each release of the Amazon Storage Gateway User Guide before May 2018.

Change Description Date Changed

Support for S3 One Zone-IA storage class

For File Gateways, you can now choose S3 One Zone-IA as the default storage class for your file shares. Using this storage class, you can store your object data in a single Availability Zone in Amazon S3. For more information, see Creating a file share.

April 4, 2018

New Amazon Web Services Region

Tape Gateway is now available in the Asia Pacific (Singapore) Region. For detailed information, see Amazon Web Services Regions that support Storage Gateway.

April 3, 2018

Support for refresh cache notification, Requester Pays, and canned ACLs for Amazon S3 buckets

With File Gateways, you can now be notified when the gateway finishes refreshing the cache for your Amazon S3 bucket. For more information, see RefreshCache.html in the Storage Gateway API Reference.

For File Gateways, you can now specify that the requester or reader pays for access charges instead of the bucket owner.

File Gateway can now give full control of written files to the owner of the S3 bucket that maps to the NFS file share.

For more information, see Creating a file share.

March 1, 2018

New Amazon Web Services Region

Storage Gateway is now available in the Europe (Paris) Region. For detailed information, see Amazon Web Services Regions that support Storage Gateway.

December 18, 2017

Support for file upload notification and guessing of the Multipurpose Internet Mail Extension (MIME) type

File Gateway can now send notifications when all files written to your NFS file share have been uploaded to Amazon S3. For more information, see NotifyWhenUploaded in the Storage Gateway API Reference.

File Gateway can now guess the MIME type for uploaded objects based on file extensions. For more information, see Creating a file share.

November 21, 2017

Support for VMware ESXi Hypervisor version 6.5

Amazon Storage Gateway now supports VMware ESXi Hypervisor version 6.5. This is in addition to version 4.1, 5.0, 5.1, 5.5, and 6.0. For more information, see Supported hypervisors and host requirements.

September 13, 2017

File Gateway support for Microsoft Hyper-V hypervisor

You can now deploy a File Gateway on a Microsoft Hyper-V hypervisor. For information, see Supported hypervisors and host requirements.

June 22, 2017

New Amazon Web Services Region

Storage Gateway is now available in the Asia Pacific (Mumbai) Region. For detailed information, see Amazon Web Services Regions that support Storage Gateway.

May 02, 2017

Updates to file share settings

Support for cache refresh for file shares

File Gateways now add mount options to the file share settings. You can now set squash and read-only options for your file share. For more information, see Creating a file share.

File Gateways now can find objects in the Amazon S3 bucket that were added or removed since the gateway last listed the bucket's contents and cached the results. For more information, see RefreshCache in the API Reference.

March 28, 2017

Support for File Gateways on Amazon EC2

Amazon Storage Gateway now provides the ability to deploy a File Gateway in Amazon EC2. You can launch a File Gateway in Amazon EC2 using the Storage Gateway Amazon Machine Image (AMI) now available as a community AMI. For information about how to create a File Gateway and deploy it on an EC2 instance, see Create and activate an Amazon S3 File Gateway. For information about how to launch a File Gateway AMI, see Deploy a default Amazon EC2 host for S3 File Gateway.

In addition, File Gateway now supports HTTP proxy configuration. For more information, see Routing your gateway deployed on Amazon EC2 through an HTTP proxy.

February 08, 2017

New Amazon Web Services Region

Storage Gateway is now available in the Europe (London) Region. For detailed information, see Amazon Web Services Regions that support Storage Gateway.

December 13, 2016

New Amazon Web Services Region

Storage Gateway is now available in the Canada (Central) Region. For detailed information, see Amazon Web Services Regions that support Storage Gateway.

December 08, 2016

Support for File Gateway

In addition to Volume Gateways and Tape Gateway, Storage Gateway now provides File Gateway. File Gateway combines a service and virtual software appliance, allowing you to store and retrieve objects in Amazon S3 using industry-standard file protocols such as Network File System (NFS). The gateway provides access to objects in Amazon S3 as files on an NFS mount point.

November 29, 2016