Configuring Cross-Region Replication for a Bucket
Functions
Cross-region replication refers to the automatic and asynchronous replication of objects across buckets in different regions. By activating cross-region replication, OBS can copy new objects and modified objects from a source bucket in one region to a destination bucket in a different region.
An IAM agency is required for configuring cross-region replication. For details, see Creating an Agency for Cross-Region Replication.
To configure cross-region replication for a bucket, the following two requirements must be met:
- The versioning statuses of the source and destination buckets are the same. For details, see Configuring Versioning for a Bucket.
- The source bucket's owner and agency (OBS) have the write permission for the destination bucket (with a bucket policy configured), and the agency (OBS) also has the read permission for the source bucket. This permission delegation needs to be implemented by using a bucket policy.
For details about how to configure the bucket policy, see Configuring a Bucket Policy. After the bucket policy is set, the agency (OBS) can read objects from the source bucket and copy objects to the destination bucket.
Request Syntax
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
PUT /?replication HTTP/1.1 Host: bucketname.obs.region.myhuaweicloud.com x-obs-date: date Content-SHA256: SHA256 Authorization: authorization string Content-Length: contentlength <ReplicationConfiguration> <Agency>testAcy</Agency> <Rule> <ID>rule1</ID> <Prefix>key-prefix</Prefix> <Status>rule-status</Status> <Destination> <Bucket>targetbucketname</Bucket> <StorageClass>STANDARD</StorageClass> <DeleteData>Enabled</DeleteData> </Destination> <HistoricalObjectReplication>Enabled</HistoricalObjectReplication> </Rule> </ReplicationConfiguration> |
Request Parameters
This request contains no message parameters.
Request Headers
The request uses one header, as described in the following table.
Element |
Description |
Mandatory |
---|---|---|
Content-SHA256 |
Base64-encoded 256-bit SHA256 digest of the message according to SHA. |
Yes |
Request Elements
This request contains elements to specify the replication configuration for the bucket in XML format. The following table lists request elements:
Element |
Description |
Mandatory |
---|---|---|
ReplicationConfiguration |
Container for the replication rules. A maximum of 100 rules can be configured. The size of the XML file can reach 50 KB. Type: container Child: Rule Parent: none |
Yes |
Agency |
Name of the agency, which can have a maximum of 64 characters. Type: string Parent: ReplicationConfiguration |
Yes |
Rule |
Container of a specified replication rule. The replication configuration must contain at least one rule. The maximum number of rules is 100. Type: container Parent: ReplicationConfiguration |
Yes |
ID |
Unique identifier of a rule, with a maximum length of 255 characters. Type: string Parent: Rule |
No |
Status |
If the value of this element is Disabled, this rule will be ignored. Type: string Parent: Rule Value options: Enabled, Disabled |
Yes |
Prefix |
Prefix of an object key name, applicable to one or more objects. If the Prefix is left blank, the cross-region replication rule is applied to the whole bucket. The prefix should be a UTF-8-encoded character sequence of 1 to 1,024 characters. Duplicate prefixes are not supported. Type: string Parent: Rule |
Yes |
Destination |
Container for the destination bucket information. Type: container Parent: Rule |
Yes |
Bucket |
Bucket used to store object copies that are marked by rules. If the replication configuration contains multiple rules, the rules must specify the same bucket as the destination bucket. Type: string Parent: Destination |
Yes |
StorageClass |
Storage class of an object Type: string Parent: Destination Value options: STANDARD, WARM, COLD |
No |
DeleteData |
Keyword for synchronizing object deletion operations. If the value is Enabled, the object deletion for the source bucket will be replicated to the destination bucket. Type: string Parent: Destination Value options: Enabled and Disabled (If this element is absent from the request, Disabled is applied by default.) |
No |
HistoricalObjectReplication |
Keyword for copying a historical object. If the value is Enabled, historical objects meeting this rule are copied. Type: string Parent: Rule Value options: Enabled and Disabled (If this element is absent from the request, Disabled is applied by default.) |
No |
Response Syntax
1 2 3 4 |
HTTP/1.1 status_code Server: OBS Date:date Content-Length: contentlength |
Response Headers
The response to the request uses common headers. For details, see Table 1.
Response Elements
This response contains no elements.
Error Responses
No special error responses are returned for this request.
Sample Request
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
PUT /?replication HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.myhuaweicloud.com Accept: */* Date: Wed, 27 Jun 2018 13:39:15 +0000 Authorization: OBS H4IPJX0TQTHTHEBQQCEC:CdeqU0Vg9xNdJMZ0PGPgh5EnkO0= Content-SHA256: ogX9qClMrVJUBiUSIKDFM0qO41jJM0I5SCN55/OtMyI= Content-Length: 330 <ReplicationConfiguration> <Agency>testAcy</Agency> <Rule> <ID>Rule-1</ID> <Status>Enabled</Status> <Prefix></Prefix> <Destination> <Bucket>dstbucket</Bucket> <StorageClass>STANDARD</StorageClass> <DeleteData>Enabled</DeleteData> </Destination> <HistoricalObjectReplication>Enabled</HistoricalObjectReplication> </Rule> </ReplicationConfiguration> |
Sample Response
1 2 3 4 5 6 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: B59500000164417839932E5A2295674C x-obs-id-2: 32AAAQAAEAABKAAQAAEAABAAAQAAEAABCStv51t2NMMx+Ou+ow7IWV4Sxo231fKe Date: Wed, 27 Jun 2018 13:39:15 GMT Content-Length: 0 |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot