Prerequisites

The source bucket version must be 3.0 or later, and cross-region replication is available in the region of the source bucket.

Procedure

1. In the navigation pane on the left of OBS Console, choose Object Storage.
2. In the bucket list, click a bucket name, and then the Overview page of the bucket is displayed.
3. In the navigation pane on the left, click Cross-Region Replication.
4. Click Create Rule. The Create Cross-Region Replication Rule dialog box is displayed. See Figure 1.
   Figure 1 Creating a cross-region replication rule
   
   

   • The versioning status of the source bucket must be the same as that of the destination bucket.
   • For a source bucket, only one destination bucket and IAM Agency can be configured for cross-region replication. The destination bucket and IAM Agency created in a later rule will overwrite those in the earlier rule.

5. Configure the cross-region replication rule according to your service needs. For details about parameters, see Table 1.

   Table 1 Cross-region replication parameters

   Parameter		Description
   Status		Indicates whether to enable or disable the replication rule. The versioning status of the source bucket must be the same as that of the destination bucket.
   Source bucket	Replicate	Indicates objects on which the rule takes effect. All objects: The rule applies to all objects in the bucket. Match by prefix: The rule applies only to objects with the preset prefixes.
   	Prefix	If you want to apply the rule to objects by prefix, the text box of Prefix cannot be left blank, and the value cannot exceed 1023 characters. When Match by prefix is selected and the specified prefix overlaps with the prefix of an existing rule, OBS regards the two rules as one and the new one cannot be configured successfully. For example, if a rule with prefix abc exists in the system, another rule whose prefix starts with abc cannot be configured. To copy a folder, end the prefix with a slash (/), for example, imgs/.
   	Synchronize Existing Objects	Indicates whether to synchronize existing objects in the bucket to the destination bucket. By default, the objects are not synchronized.
   Destination bucket	Region	Indicates the region of the destination bucket. The destination bucket cannot be in the region where the source bucket resides.
   	Bucket	Indicates the destination bucket.
   	Change storage class for replicated objects	By default, this option is not selected, indicating that the storage class of object copies is the same as that of objects in the source bucket. If you need to change the storage class of objects copies, select this parameter, then you can specify a storage class.
   Permission	Replicate KMS encrypted objects	OBS will try to copy KMS encrypted objects no matter whether this option is selected or not. If this option is selected, only the IAM agencies that have any permission on a global project and have the KMS Administrator or Tenant Administrator permissions on both the source and destination regions are displayed. If this option is not selected, only the IAM agencies that have any permission on a global project, but do not have the KMS Administrator or Tenant Administrator permissions on both the source and destination regions are displayed. If KMS is not available in the destination region or the agency does not have the KMS Administrator permissions in the source and destination regions, KMS encrypted objects in the source bucket will fail to be replicated to the destination bucket, and the object replication status will be FAILED. After a KMS encrypted object in the source bucket is replicated to the destination bucket, the key that encrypts the object changes to the default master key obs/default of the region where the destination bucket resides.
   	IAM Agency	Delegates the resource operation permissions to OBS, so that OBS uses this agency to perform the cross-region replication operation. An IAM agency is required to use the cross-region replication function. If you have already created IAM agencies, select one. NOTE: Requirements: The IAM agency is a cloud service agency of OBS. The OBS project must have the OBS Administrator permissions. If Replicate KMS encrypted objects is enabled, you also need the KMS Administrator permissions in the regions where the source and destination buckets reside.

6. (Optional) Create an IAM Agency. For details, see Creating an IAM Agency.
7. Click OK. The cross-region replication rule is created.