All Products
Search

This Product

    Cloud Storage Gateway:Configure express synchronization

    Document Center

    Cloud Storage Gateway:Configure express synchronization

    Last Updated:Sep 21, 2026

    The express synchronization feature of a file gateway in Cloud Storage Gateway (CSG) allows you to efficiently synchronize changes in an Object Storage Service (OSS) bucket to all local clients that are connected to the bucket.

    Prerequisites

    • A file gateway is created and a cache is added.

    • An OSS Bucket is created.

      Important

      • A file gateway supports only OSS Buckets of the Standard, Infrequent Access (IA), and Archive storage classes. OSS Buckets with the back-to-source feature enabled are not supported.

      • Avoid connecting a gateway directly to an Archive OSS Bucket. If files will not be modified for a long time after being written, consider using a Standard or IA bucket. You can then use lifecycle rules to transition the storage class of the objects to Archive or Cold Archive. This approach is more cost-effective and efficient because it avoids unnecessary restore operations.

      • When a client writes a file to the gateway, the gateway records at least two actions: writing the file and setting the file's modification time. The gateway attempts to merge these actions, but may still initiate multiple operations on the OSS Bucket for a single file. Setting the modification time translates to modifying the object's metadata in the OSS Bucket by using the CopyObject API. For Archive or Cold Archive objects, this requires a time-consuming restore operation, which can slow down uploads and even cause write failures if the cache disk does not have enough space to upload the data in time.

    • An NFS or SMB share is created and configured on the file gateway.

    • The Message Service (MNS) is activated.

    Background information

    When you configure the express synchronization feature, you can add one or more shares that are connected to the same OSS bucket to an express synchronization group. All data changes in the bucket are synchronized to local clients that are associated with shares in the express synchronization group. You do not need to separately synchronize data changes from the bucket. This improves the efficiency and accuracy of synchronization.

    The Express Sync feature relies on Simple Message Queue (formerly MNS) and therefore incurs usage fees. For more information, see Billing.

    Create a synchronization group

    Important

    If you delete an object from a versioning-enabled bucket without specifying a version ID, the DeleteObject and DeleteObjects event notifications are not triggered. This is because a request to delete an object from a versioning-enabled bucket without a version ID specified does not actually delete any object version. Instead, the current version of the object is made a previous version and a delete marker is added as the current version of the object. As a result, CSG detects no deletion operation on the object.

    To enable express synchronization, you must create a synchronization group and add shares to the group. To create a synchronization group, perform the following steps:

    1. Navigate to the Express Sync page in the CSG console. On the Sync Groups page, click Create.

    2. On the Basic Information tab of the Create Sync Group page, configure the following parameters, and then click Next.

      Parameter

      Description

      Sync Group Name

      Enter the name of the synchronization group.

      Note

      The name must be 1 to 128 characters in length, and can contain letters, digits, periods (.), underscores (_), and hyphens (-). It must start with a letter.

      OSS Region

      Specify the region where the OSS bucket resides.

      Bucket Name

      Select the name of the OSS bucket. You can select only one OSS bucket for an express synchronization group. All data changes in the bucket are synchronized to the local clients that are associated with shares in the group.

      Note

      If no share is connected to the OSS bucket, no OSS bucket is available in the drop-down list. In this case, you must create a share that connects to the OSS bucket. For more information, see Manage shares.

      Bucket Subdirectory

      Select a specific subdirectory of the bucket from which you want to synchronize data.

    3. On the Create Sync Group page, in the Sync Group Settings section, select the shares that you want to add to the synchronization group from the Available Shares area on the left, and click the > icon. The selected shares are added to the Selected Shares area. Then, click Next.

      You can also select a share from the Selected Shares list and click the < icon to remove it from the synchronization group.

      Note

      After you add an NFS share to a synchronization group, you can specify the noac parameter when you mount the share to a local directory. This allows you to view the synchronization result at the earliest opportunity. For more information, see Access an NFS share.

    Manage a synchronization group

    After you create a synchronization group, all data changes in the OSS bucket are automatically synchronized to local clients that are associated with the shares in the synchronization group. You can perform the following operations to manage a synchronization group:

    • View the details of the synchronization group

      1. On the Sync Groups page, click the name of a synchronization group in the Sync Group Name column, or click Details in the Actions column for the group.

      2. In the Sync Group Details dialog box, you can view the details of a synchronization group. You can also view the details in a list format by selecting the icon or in a map format by selecting the icon in the upper-right corner. In addition to the basic information about the synchronization group and the shares added to it, the list page of the Sync Group Details dialog box also contains the following information.

        Parameter

        Description

        Message Topic Name

        The name of the SMQ topic for the synchronization group.

        Shared Status

        The status of the share in the synchronization group. The share can be in one of the following states:

        • Full Data Sync Awaiting: The share has just been added to the group and is waiting for the initial full data sync.

        • Full Data Sync in Progress: The initial full data sync for the share is in progress.

        • Sync Normal: The share is synchronizing normally.

        • Express Sync Disabled: The Express Sync feature is not enabled for the share.

        • Message Queue Inaccessible: The message queue corresponding to the share is inaccessible.

        • Message Topic Inaccessible: The message topic corresponding to the share is inaccessible.

        • Message Queue and Topic Inaccessible: Both the message queue and topic corresponding to the share are inaccessible.

        Message Queue Name

        The name of the queue that is used by the synchronization group.

    • Add a share to or remove a share from a synchronization group

      In the Actions column for the synchronization group, click Settings. In the Set Sync Group dialog box, add or remove shares. The method is the same as in Step 3 of creating a synchronization group.

    • Delete a synchronization group

      To delete a synchronization group, click Delete in the Actions column for the group. Then, in the confirmation dialog box, click OK.