Cloud Storage Gateway:Multi-bucket aggregation

Limitations

Before you use multi-bucket aggregation, note the following limitations.

• The multi-bucket aggregation feature is available only to allowlisted users. To request access, submit a ticket.

• Only Enhanced and Performance Optimized Cloud Storage Gateway (CSG) instances support multi-bucket aggregation.

• Shares that use multi-bucket aggregation do not support specifying subdirectories of an OSS bucket and cannot be added to an Express Sync group.

• Shares that use multi-bucket aggregation do not support OSS buckets that use Cold Archive Storage or the Back-to-Source Feature.

• Do not delete an associated bucket directly from the OSS console. Instead, you must first remove it from the share in the CSG console. After the share's status changes to Upload Complete, you can safely delete the bucket from the OSS console.

Prerequisites

• A file gateway is created, and a cache disk is attached to it. For more information, see Manage file gateways and Add a cache.

  An OSS bucket is created. For more information, see Get started by using the OSS console.

Create a multi-bucket share

1. Log on to the Cloud Storage Gateway console. On the Gateways page, click the target file gateway. On the Shares.

2. On the Bucket Settings page, configure the parameters and set Enable Multi-bucket Aggregation to Yes.

3. From the Bucket Name drop-down list, select the buckets to associate.

4. Configure the remaining settings for the share.

   Note

   For more information about the settings on this page, see Create a share.

After the share is created, you can view all its associated buckets in the OSS Bucket Name column.

When you mount the share on a client, each associated bucket is mapped to a separate directory under the mount point. For example, if the mount point is /mnt/myshare, the associated buckets bucket-a and bucket-b are mapped to /mnt/myshare/bucket-a and /mnt/myshare/bucket-b respectively. For information about how to mount a share, see Access an NFS share or Access an SMB share.

Manage a multi-bucket share

After the share is created, you can add or remove associated buckets in the share's Advanced Settings.

1. Log on to the Cloud Storage Gateway console. On the Gateways page, click the target file gateway.

2. On the Shares tab, find the target share and click Advanced Settings in the Actions column.

3. In the NFS Share Advanced Settings or SMB Share Advanced Settings dialog box, select a bucket to add from the Bucket drop-down list, or click the x icon next to an associated bucket to remove it.