Limits and quotas for Amazon S3 File Gateway - Amazon Storage Gateway
Quotas for file sharesRecommended local disk sizes for your 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).

Amazon FSx File Gateway documentation has been moved to What is Amazon FSx File Gateway?

Volume Gateway documentation has been moved to What is Volume Gateway?

Tape Gateway documentation has been moved to What is Tape Gateway?

Limits and quotas for Amazon S3 File Gateway

Quotas for file shares

The following table lists quotas for file shares.

Description Limit
Maximum number of file shares per gateway
Note

Each file share can only connect to one S3 bucket, but multiple file shares can connect to the same bucket. If you connect more than one file share to the same bucket, you must configure each file share to use a unique, non-overlapping prefix name to prevent read/write conflicts.

The number of file shares managed by a gateway can impact the gateway's performance. For more information, see Performance guidance for gateways with multiple file shares.

 50
The maximum number of files for which a gateway can simultaneously cache metadata
Note

Because S3 File Gateway is backed by Amazon S3, there is no maximum folder size or limit to the number of files that you can store or access using a gateway.

Each gateway has a configurable limit that determines the number of files for which it can simultaneously cache metadata. You can use the UpdateGatewayInformation API action to set GatewayCapacity to Small, Medium, or Large. This setting impacts gateway performance and hardware recommendations. For more information, see Performance guidance for gateways with multiple file shares.

Gateway Capacity:

Small — 5M files

Medium — 10M files

Large — 20M files
The maximum size of an individual file, which is the maximum size of an individual object in Amazon S3
Note

If you write a file larger than 5 TB, you get a "file too large" error message and only the first 5 TB of the file is uploaded.

 5 TB

Maximum path length

Note

Clients are not allowed to create a path exceeding this length, and doing so results in an error. This limit applies to both protocols supported by File Gateways, NFS and SMB.

Path length in bytes is calculated from character bit values in UTF-8 encoding.

 1024 bytes

Recommended local disk sizes for your gateway

The following table recommends sizes for local disk storage for your deployed gateway.

Gateway Type Cache (Minimum) Cache (Maximum) Other Required Local Disks
S3 File Gateway 150 GiB 64 TiB —
Note

You can configure one or more local drives for your cache up to the maximum capacity.

When adding cache to an existing gateway, it's important to create new disks in your host (hypervisor or Amazon EC2 instance). Don't change the size of existing disks if the disks have been previously allocated as a cache.