Enables or disables the Replication Time Control (RTC) feature for existing cross-region replication (CRR) rules.
Request syntax
PUT /?rtc HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<ReplicationRule>
<RTC>
<Status>enabled or disabled</Status>
</RTC>
<ID>rule id</ID>
</ReplicationRule>Request headers
This request contains only common request headers. For more information, see Common HTTP headers.
Request parameters
Parameter | Type | Required | Example | Description |
ReplicationRule | Container | Yes | N/A | The container that stores the RTC configurations. Parent nodes: none Child nodes: RTC and RuleID |
RTC | Container | Yes | N/A | The container that stores the status of the RTC feature. Parent nodes: ReplicationRule Child nodes: Status |
Status | String | Yes | enabled | The status of the RTC feature. Default value: disabled. Valid values:
Parent nodes: RTC Child nodes: none |
ID | String | Yes | test_replication_rule_1 | The ID of the CRR rule for which you want to configure the status of the RTC feature. You can call the DeleteBucketReplication operation to obtain the ID of the CRR rule. Parent nodes: ReplicationRule Child nodes: Status |
Response headers
This request contains only common response headers. For more information, see Common HTTP headers.
Examples
Sample requests
PUT /?rtc HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Thu, 21 Jul 2022 15:39:18 GMT Content-Length: 46 Content-Type: application/xml Authorization: OSS qn6q**************:77Dv**************** <?xml version="1.0" encoding="UTF-8"?> <ReplicationRule> <RTC> <Status>enabled</Status> </RTC> <ID>test_replication_rule_1</ID> </ReplicationRule>Sample responses
HTTP/1.1 200 OK x-oss-request-id: 534B371674E88A4D8906**** Date: Thu, 21 Jul 2022 15:39:18 GMT Content-Length: 0 Connection: close Server: AliyunOSS
Error codes
Error code | HTTP status code | Description |
ReplicationLocationNotSupportRtc | 400 BadRequest | The RTC feature is unavailable in this region. For more information about the regions in which the RTC feature is available, see Overview. |
BucketReplicationInClosingStatus | 400 BadRequest | If the CRR rule is disabled, you cannot enable or disable the RTC feature. |
BucketReplicationNotSupportRtc | 400 BadRequest | The current CRR rule does not support the RTC feature. Contact technical support to troubleshoot and resolve the issues. |