調用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功能所處狀態。 取值:
父節點: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功能。請聯絡支援人員排查並解決問題。 |