Aggregate multiple buckets in a single share with a file gateway - Cloud Storage Gateway

You can aggregate multiple OSS buckets from the same region into a single share, creating a unified namespace within a single file system. When you mount the share on a client, each attached bucket is mapped to a separate folder in the local file system. This topic describes how to aggregate multiple buckets in 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 Attach a cache disk.
An OSS bucket is created. For more information, see Get started by using the OSS console.

Usage notes

When you aggregate multiple buckets in a single share, note the following:

The multi-bucket aggregation feature is available only for users on the whitelist. To use this feature, submit a ticket to request access.
Only enhanced and compute-optimized Cloud Storage Gateway instances support multi-bucket aggregation.
Shares with multi-bucket aggregation do not support specifying bucket subdirectories. These shares also cannot be added to express synchronization groups.
Shares with multi-bucket aggregation do not support OSS buckets of the Cold Archive storage class or buckets with the back-to-origin attribute.

Create a share for multi-bucket aggregation

Follow these steps to create a new share and aggregate multiple buckets in it.

Go to the Cloud Storage Gateway console. On the Gateway List page, find and click the target file gateway. Click Share List > Create.
On the Bucket Settings page, set Enable Multi-Bucket Support to Yes.
From the Bucket Name drop-down list, select the buckets to attach to the share.
On the share configuration page, complete the other settings.
Note
For more information about the configurations, see Create a share.

After the share is created, you can view the buckets attached to the share in the OSS Bucket Name column of the share list.

When the share is mounted on a local client, the attached buckets are mapped to separate folders in the local file system. For more information about how to mount a share on a local client, see Access an NFS share or Access an SMB share.

Manage a share for multi-bucket aggregation

After you create a share for multi-bucket aggregation, you can also add or remove attached buckets on the advanced settings page for the share.

Go to the Cloud Storage Gateway console. On the Gateway List page, find and click the target file gateway.
In the Share List, find the share that you want to modify, and click Advanced Settings on the right.
On the NFS Share Advanced Settings or SMB Share Advanced Settings page, add a bucket from the Bucket drop-down list, or click the x icon next to a bucket to remove it.