How can I create a Storage Gateway file share using an Amazon S3 prefix?

Last updated: 2020-09-18

I want to create an AWS Storage Gateway file share that maps to a single Amazon Simple Storage Service (Amazon S3) prefix. How can I do that?

Resolution

Before you create a file share that maps to an Amazon S3 prefix, you must confirm that the prefix doesn't overlap with the prefix of another file share. You can't create file shares with overlapping prefixes. If you already created a file share that maps to the root of the bucket, then you must first update the existing file share to point to another prefix within the bucket.

After you confirm that no other file shares point to the Amazon S3 prefix that you want to map your new file share to, follow the steps to create a Network File System (NFS) file share or Server Message Block (SMB) file share. For Amazon S3 bucket name, enter the name of the relevant bucket. For Prefix name, enter the prefix that you want to map the file share to.

Note the following requirements for mapping a file share to an Amazon S3 prefix:

  • The prefix must end with "/".
  • If you specify a prefix, then you must enter a file share name.
  • After you create a file share with a specified prefix, you can't modify or delete the prefix on the file share's settings.

Did this article help?


Do you need billing or technical support?