調用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功能。請聯系技術支持排查并解決問題。 |