Multi-bucket Aggregation - Cloud Storage Gateway - Alibaba Cloud Documentation Center

You can associate a share with multiple Object Storage Service (OSS) buckets in the same region to implement a unified namespace. After the share is mounted to a client, each associated bucket is mapped to a separate directory in the local file system. This topic describes how to associate a share with multiple OSS buckets.

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 associate a share with multiple OSS buckets, take note of the following limits:

Only the users in the whitelist can use this feature. If you are not in the whitelist and want to use this feature, submit a ticket.
Only Enhanced and Performance Optimized gateways allow you to associate a share with multiple OSS buckets.
When you associate a share with multiple OSS buckets, you cannot specify the subdirectories of OSS buckets, or add the share to an express synchronization group.

Create a share associated with multiple OSS buckets

To create a share that is associated with multiple OSS buckets, perform the following steps:

On the Gateways page of the Cloud Storage Gateway (CSG) console, click the ID of the gateway. On the Shares tab, click Create.
In the Bucket Settings step, set Enable Multi-bucket Aggregation to Yes, and configure other parameters.
In the Bucket Name drop-down list, select the buckets. Click Next.
Configure other share settings.
Note
For more information about share settings, see Create a share.

After the share is created, the OSS buckets associated with the share are displayed in the OSS Bucket Name column.

After the share is mounted on a local client, each OSS bucket associated with the share is mapped to an individual directory in the file system. For more information about how to mount a share to a local client, see Access an NFS share and Access an SMB share.

Manage a share associated with multiple OSS buckets

After you create a share that can be associated with more than one bucket, you can associate more buckets with the share or disassociate buckets from the share by using the following steps:

On the Gateways page of the CSG console, click the ID of the gateway.
On the Shares tab, find the share and click Advanced Settings in the Actions column.
In the dialog box that appears, select a bucket in the Bucket drop-down list to associate it with the share, or click the x icon next to an existing associated bucket to disassociate it from the share.