Aggregate multiple OSS buckets into a single file gateway share - Cloud Storage Gateway

You can aggregate multiple OSS buckets in the same Region into a single share to create a unified namespace. When the share is mounted on a client, each associated bucket is mapped to a separate directory on the local file system. This topic describes how to aggregate multiple buckets into a single share.

Prerequisites

A file gateway is created, and a cache disk is attached to it. For more information, see Manage file gateways and Manage cache disks.
An OSS bucket is created. For more information, see Get started by using the OSS console.

Limitations

Note the following when you aggregate multiple buckets in a single share:

The Multi-bucket Aggregation feature is available only to users on the whitelist. To use this feature, submit a ticket to apply.
Only Enhanced and Performance Optimized Cloud Storage Gateway (CSG) instances support the Multi-bucket Aggregation feature.
Shares with Multi-bucket Aggregation enabled do not support specifying subdirectories of an OSS bucket and cannot be added to an Express Synchronization Group.
Shares with Multi-bucket Aggregation enabled do not support OSS buckets that use Cold Archive Storage or the Back-to-Source Feature.
After you configure a multi-bucket share, do not delete an associated bucket directly from the OSS console. If you need to delete a bucket, you must first edit the share in the CSG console to remove it. After you confirm that the share status changes to Upload Complete, you can delete the bucket from the OSS console.

Create a multi-bucket share

Follow these steps to create a multi-bucket share:

Log on to the Cloud Storage Gateway Console. On the Gateways page, find and click the target File Gateway. On the Shares tab, click Create.
On the Bucket Settings page, configure the parameters and set Enable Multi-bucket Aggregation to Yes.
From the Bucket Name drop-down list, select the buckets that you want to associate with the share.
Configure the remaining share settings.
Note
For more information about the settings on this page, see Create a share.

After the share is created, you can view the associated buckets in the OSS Bucket Name column on the Shares tab.

When the share is mounted on a client, each associated bucket is mapped to a separate directory on the file system. For more information about how to mount a share, see Access an NFS share or Access an SMB share.

Manage a multi-bucket share

After you create a multi-bucket share, you can add or remove associated buckets from the share's Advanced Settings.

Log on to the Cloud Storage Gateway Console. On the Gateways page, find and click the target File Gateway.
On the Shares tab, find the target share and click Advanced Settings in the Actions column.
In the Advanced Settings for NFS Share or Advanced Settings for SMB Share dialog box, add a bucket from the Bucket drop-down list, or click the x icon next to a bucket to remove it.