PutBucketRTC - Object Storage Service

調用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 qn6q**************:77Dv****************


<?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功能。請聯絡支援人員排查並解決問題。