Create an NFS file share with a custom configuration

To create an NFS file share with customized settings

1. Open the Amazon Storage Gateway console at https://console.amazonaws.cn/storagegateway/home/ and choose File shares from the left navigation pane.

2. Choose Create file share.

3. Choose Customize configuration. You can ignore the other fields on this page for now. You will be prompted to configure gateway, protocol, and storage settings in subsequent steps.

4. For Gateway, choose the Amazon S3 File Gateway for your new file share for from the dropdown list.

5. For CloudWatch log group, choose one of the following from the dropdown list:

   • To turn off logging for this file share, choose Disable logging.

   • To automatically create a new log group for this file share, choose Created by Storage Gateway.

   • To send health and resource notifications for this file share to an existing log group, choose the desired group from the list.

   For more information about audit logs, see Understanding S3 File Gateway audit logs.

6. (Optional) Under Tags - Optional, choose Add new tag, then enter a Key and Value for your file share.

   A tag is a case-sensitive key-value pair that helps you categorize your Storage Gateway resources. Adding tags can make filtering and searching for your file share easier. You can repeat this step to add up to 50 tags.

   Choose Next when finished.

7. For S3 bucket, do one of the following to specify where your file share will store and retrieve files:

   • To connect the file share directly to an existing S3 bucket in your Amazon Web Services account, choose the bucket name from the dropdown list.

   • To connect the file share to an existing S3 bucket that is owned by an Amazon Web Services account other than the one that you use to create the file share, choose A bucket in another account from the dropdown list, then enter the Cross-account bucket name.

   • To connect the file share to a new S3 bucket, choose Create a new S3 bucket, then choose the Region where the Amazon S3 endpoint for your new bucket is located, and enter a unique S3 bucket name. Choose Create S3 bucket when finished. For more information about creating new buckets, see How do I create an S3 bucket? in the Amazon S3 User Guide.

   • To connect the file share to an S3 bucket using an access point name, choose Amazon S3 access point name from the dropdown list, then enter the Access point name. If you need to create a new access point, you can choose Create an S3 access point. For further instructions, see Creating an access point in the Amazon S3 User Guide. For more information about access points, see Managing data access with Amazon S3 access points and Delegating access control to access points in the Amazon S3 User Guide.

   • To connect the file share to an S3 bucket using an access point alias, choose Amazon S3 access point alias from the dropdown list, then enter the Access point alias. If you need to create a new access point, you can choose Create an S3 access point. For further instructions, see Creating an access point in the Amazon S3 User Guide. For more information about access point aliases, see Using a bucket-style alias for your access point in the Amazon S3 User Guide.

   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 S3 bucket prefix to prevent read/write conflicts.

   S3 File Gateway does not support support Amazon S3 buckets with periods (.) in the bucket name.

   Make sure your bucket name complies with the rules for bucket naming in Amazon S3. For more information, see Rules for bucket naming in the Amazon Simple Storage Service User Guide.

8. (Optional) For S3 bucket prefix, enter a prefix for your file share to apply to the objects it creates in Amazon S3. Prefixes are a way to organize your data in S3, similar to directories in traditional file structures. For more information, see Organizing objects using prefixes in the Amazon S3 User Guide.

   Note

   • 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 to prevent read/write conflicts.

   • The prefix must end with a forward slash (/).

   • After the file share is created, the prefix can't be modified or deleted.

9. For Region, choose the Amazon Web Services Region where the S3 endpoint for your bucket is located from the dropdown list. This field appears only when you specify an access point or a bucket in another account for S3 bucket.

10. For Storage class for new objects, choose a storage class from the dropdown list. For more information about storage classes, see Using storage classes with a File Gateway.

11. For IAM Role, do one of the following to configure an IAM role for your file share:

    • To automatically create a new IAM role with the necessary permissions for your file share to work properly, choose Created by Storage Gateway from the dropdown list.

    • To use an existing IAM role, choose the role name from the dropdown list.

    • To create a new IAM role, choose Create a role. For further instructions, see Creating a role to delegate permissions to an Amazon service in the Amazon Identity and Access Management User Guide.

    For more information about how IAM roles control access between your file share and S3 bucket, see Granting access to an Amazon S3 bucket.

12. For Private link, do the following only if you need to configure your file share to communicate with Amazon using a private endpoint in a Virtual Private Cloud (VPC). Otherwise, skip this step. For more information, see What is Amazon PrivateLink? in the Amazon PrivateLink Guide.

    1. Select Use VPC endpoint.

    2. For Identify VPC endpoint by, do one of the following:

       • Select VPC endpoint ID, then choose the endpoint that you want to use from the VPC endpoint dropdown list.

       • Select DNS name, then enter the DNS name for the endpoint that you want to use.

13. For Encryption, choose the type of server-side encryption that the file share will use for the data that it stores in Amazon S3:

    • To use server-side encryption managed with Amazon S3 (SSE-S3), choose S3-Managed Keys (SSE-S3).

      For more information, see Using server-side encryption with Amazon S3 managed keys in the Amazon Simple Storage Service User Guide.

    • To use server-side encryption managed with Amazon Key Management Service (SSE-KMS), choose KMS-Managed Keys (SSE-KMS). For Primary KMS key, choose an existing Amazon KMS key, or choose Create a new KMS key to create a new KMS key in the Amazon Key Management Service (Amazon KMS) console.

      For more information about Amazon KMS, see What is Amazon Key Management Service? in the Amazon Key Management Service Developer Guide.

    • To use dual-layer server-side encryption managed with Amazon Key Management Service (DSSE-KMS), choose Dual-layer server-side encryption with Amazon Key Management Service keys (DSSE-KMS). For Primary KMS key, choose an existing Amazon KMS key, or choose Create a new KMS key to create a new KMS key in the Amazon Key Management Service (Amazon KMS) console.

      For more information about DSSE-KMS, see Using dual-layer server-side encryption with Amazon KMS keys in the Amazon Simple Storage Service User Guide.

      Note

      There are additional charges for using DSSE-KMS and Amazon KMS keys. For more information, see Amazon KMS pricing.

      To specify an Amazon KMS key with an alias that is not listed or to use an Amazon KMS key from a different Amazon account, you must use the Amazon Command Line Interface. Asymmetric KMS keys are not supported. For more information, see CreateNFSFileShare in the Amazon Storage Gateway API Reference.

    Important

    Make sure that your file share uses the same encryption type as the Amazon S3 bucket where it stores your data.

14. For Guess MIME types, select Guess media MIME type to allow Storage Gateway to guess the media type for uploaded objects based on their file extensions.

15. For File share name, enter a name for your file share.

    Note

    A valid NFS file share name can only contain the following characters: a-z, A-Z, 0-9, -, ., and _.

16. For Upload events, select Log an event when a file is successfully uploaded by the gateway if you want your gateway to record CloudWatch log events when it successfully uploads files to Amazon S3. Notification delay controls the minimum delay between the most recent client write operation and generation of the ObjectUploaded log notification. Because clients can make many small writes to files in a short time, we recommend setting this parameter for as long as possible to avoid generating multiple notifications for the same file in rapid succession. For more information, see Getting file upload notification.

    Note

    This setting has no effect on the timing of the object uploading to S3, only on the timing of the notification.

    This setting is not meant to specify an exact time at which the notification will be sent. In some cases, the gateway might require more than the specified delay time to generate and send notifications.

    Choose Next when finished.

18. For File share protocol, choose NFS.

19. For Client access, do one of the following to specify which NFS clients can access your file share:

    • To accept all incoming client connections, select All NFS clients.

    • To accept incoming client connections only from specific IP addresses, select Specific NFS clients, then choose Add a client. For Allowed clients, specify a valid IP address or CIDR block from which to accept connections. If you need to specify additional IP addresses, choose Add another client.

    Note

    We recommend configuring limiting access to your file share using the Specific NFS clients option. If you don't, any client on your network can mount to the file share.

20. For Access type, select one of the following:

    • To allow clients to read and write files on the file share, select Read/Write.

    • To allow clients to read files but not write to the file share, select Read-only.

      Note

      For file shares that are mounted on a Microsoft Windows client, if you choose Read-only, you might see a message about an unexpected error keeping you from creating the folder. You can ignore this message.

21. For Access level, choose one of the following:

    • Root squash (default): Access for the remote superuser (root) is mapped to UID (65534) and GID (65534).

    • All squash: All user access is mapped to User ID (UID) (65534) and Group ID (GID) (65534).

    • No root squash: The remote superuser (root) receives access as root.

22. (Optional) For Automated cache refresh from S3, choose Set cache refresh interval, then set the time in Minutes or Days to refresh the file share's cache using Time To Live (TTL). TTL is the length of time since the last refresh. After the TTL interval has elapsed, accessing a directory causes the File Gateway to refresh that directory's contents from the Amazon S3 bucket.

    Note

    Setting this value shorter than 30 minutes can negatively impact gateway performance in situations where large numbers of Amazon S3 objects are frequently created or deleted.

23. For File metadata defaults, select Change default metadata for S3 objects that were not created or modified by your gateway if you want your gateway to apply file metadata (including Unix permissions) to preexisting objects that it discovers in your S3 bucket. Specify the Directory permissions, File permissions, User ID, and Group ID that you want to apply in the corresponding fields.

24. For File ownership and permissions, select Give the S3 bucket owner full ownership of files created by the gateway, including read, write, edit, and delete permissions if you want the Amazon account that owns the S3 bucket to have full control of all objects written to the bucket by your file share.

    Choose Next when finished.

25. Review the file share configuration. Choose Edit to modify the settings for any section that you want to change. When finished, choose Create.