调用PutBucketRTC接口开启或关闭数据复制时间控制功能

调用PutBucketRTC接口为已有的跨区域复制规则开启或关闭数据复制时间控制（RTC）功能。

请求语法

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>

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

名称	类型	是否必选	示例值	描述
ReplicationRule	容器	是	不涉及	保存RTC配置规则的容器。父节点：无子节点：RTC、RuleID
RTC	容器	是	不涉及	保存RTC状态规则的容器。父节点：ReplicationRule 子节点：Status
Status	字符串	是	enabled	RTC功能所处状态。取值： enabled：开启RTC功能。重要开启RTC功能时，如果历史数据未复制完成或者复制规则未生效，则RTC状态显示为enabling。如果历史数据复制完成或者未选择历史数据复制，并且复制规则生效后，则RTC状态显示为enabled。 disabled（默认值）：关闭RTC功能。父节点：RTC 子节点：无
ID	字符串	是	test_replication_rule_1	需要设置RTC状态的复制规则ID。复制规则ID可从GetBucketReplication中获取。父节点：ReplicationRule 子节点：Status

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

请求示例

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 qn6qrrqxo2oawuk53otf****:CTkuxpLAi4XZ+WwIfNm0Fmgb****


<?xml version="1.0" encoding="UTF-8"?>
<ReplicationRule>
    <RTC>
        <Status>enabled</Status>
    </RTC>
    <ID>test_replication_rule_1</ID>
</ReplicationRule>

返回示例

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

错误码

错误码	HTTP状态	描述
ReplicationLocationNotSupportRtc	400 BadRequest	不支持在该地域开启RTC功能。关于支持开启RTC功能的地域信息，请参见RTC地域限制。
BucketReplicationInClosingStatus	400 BadRequest	当跨区域复制规则处于关闭状态时，不支持开启或关闭RTC功能。
BucketReplicationNotSupportRtc	400 BadRequest	当前跨区域复制规则不支持开启RTC功能。请联系技术支持排查并解决问题。