When cross-region replication is enabled, new objects in the source bucket can be automatically and asynchronously replicated to the destination bucket in another region. When you manage the objects in the source bucket (such as adding or deleting objects), COS will automatically replicate those operations to the objects in the destination bucket. To enable cross-region replication, you need to make sure that the source and destination buckets are in different regions and both have versioning enabled. You can enable or disable cross-region replication as needed. For more information, please see Cross-region Replication Overview.
Enabling Cross-Region Replication
- Log in to the COS Console, click Bucket List in the left sidebar to enter the bucket list page, and click the source bucket to be configured to enter the bucket details page.
- Click Advanced Configuration on the left to enter the advanced configuration page, scroll down to Cross-region Replication, and click Add Rule to configure a cross-region replication rule.
- To configure a cross-region replication rule, you need to enable versioning for both the source and destination buckets. If it is disabled in the source bucket, please enable it before configuring the rule. After completing the configuration, click OK.
The options in the cross-region replication rule configuration box are as follows:
- Source Region: the region where your source bucket resides.
- Applied to: the objects in the source bucket that need to be replicated. If you leave it blank, all the objects in the source bucket will be replicated by default. If a prefix is specified, only objects with this prefix will be replicated. For example, to replicate objects prefixed with
- Resource Path: the path to your source bucket.
- Destination Bucket: Refers to the bucket to which the objects are replicated. The bucket should be in a different region from the source bucket and should be one under the current account in the selected region.
- Destination Storage Class: the storage class of the objects after they are replicated to the destination bucket, which is by default the same as that in the source bucket. You can also change the destination storage class. Currently, Standard and IA storage classes are available.
- When you finish configuring a rule, you can manage the rule. You can click the button to enable or disable the current rule and click the Edit button to modify the current rule.
- If you set to apply the cross-region replication rule to all the objects in the source bucket during configuration, you will not be able to add any other rules; you can modify it by editing the current rule or by adding it again after deleting the current rule.
- If you set to apply the cross-region replication rule only to objects with a particular prefix during configuration, you can still modify the scope of the application to all of the contents of the bucket by editing the current rule.
Disabling Cross-Region Replication
You can disable cross-region replication by clicking the Disable button or deleting the rule.
- Click the Disable button: you can suspend a rule by clicking its Disable button. By doing so, the cross region replication feature will be suspended. The replicated data will be retained in the destination bucket, and new data added to the source bucket will not be replicated.
- Delete the rule: after you delete a rule in Cross-region Replication, the rule will be invalid. The replicated data will be retained in the destination bucket, and new data added to the source bucket will not be replicated. To enable cross-region replication again, you need to configure a rule again.
- Ongoing cross-region replication will be stopped when cross-region replication is disabled.
- When cross-region replication is enabled again, it will be only applied to objects added after that.