How do I use an Amazon S3 prefix to create a Storage Gateway file share?

Resolution

To create a new file share with an Amazon S3 prefix, see the following documentation for your file share type:

• Create an NFS file share with a custom configuration
• Create an SMB file share with a custom configuration

To specify a prefix, enter a bucket name for Amazon S3 bucket name, and enter a prefix for S3 prefix name. For example, name your bucket examplebucket and specify the prefix as exampleprefix/. The prefix must end with "/".

Note: After you create a file share with a prefix, you can't modify or delete the prefix on the file share's settings.

When you use prefixes, all the objects that you create in the root of the file share are organized inside the prefix of the Amazon S3 bucket. For more information, see Organizing objects using prefixes.

Prefixes that overlap cause read and write conflicts, even across different S3 File Gateways.

Confirm that the new file share doesn't overlap with the prefix of an existing file share for the same S3 File Gateway. For example, an existing file share points to a bucket's root, and you want to create a file share that points to the same bucket's prefix. You must first remove the existing file share that points to the bucket's root. Then, create a new file share that points to unique prefixes that don't overlap.

Otherwise, the file share creation fails, and you receive the following OverlappingLocations error message on the Storage Gateway console:

"The file share you are creating on the gateway contains an S3 prefix that overlaps with the prefix used by another file share on the same gateway."