PutBucketRTC
調(diào)用PutBucketRTC接口為已有的跨區(qū)域復(fù)制規(guī)則開(kāi)啟或關(guān)閉數(shù)據(jù)復(fù)制時(shí)間控制(RTC)功能。
請(qǐng)求語(yǔ)法
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>
請(qǐng)求頭
此接口僅涉及公共請(qǐng)求頭。更多信息,請(qǐng)參見(jiàn)公共請(qǐng)求頭(Common Request Headers)。
請(qǐng)求元素
名稱 | 類(lèi)型 | 是否必選 | 示例值 | 描述 |
ReplicationRule | 容器 | 是 | 不涉及 | 保存RTC配置規(guī)則的容器。 父節(jié)點(diǎn):無(wú) 子節(jié)點(diǎn):RTC、RuleID |
RTC | 容器 | 是 | 不涉及 | 保存RTC狀態(tài)規(guī)則的容器。 父節(jié)點(diǎn):ReplicationRule 子節(jié)點(diǎn):Status |
Status | 字符串 | 是 | enabled | RTC功能所處狀態(tài)。 取值:
父節(jié)點(diǎn):RTC 子節(jié)點(diǎn):無(wú) |
ID | 字符串 | 是 | test_replication_rule_1 | 需要設(shè)置RTC狀態(tài)的復(fù)制規(guī)則ID。復(fù)制規(guī)則ID可從GetBucketReplication中獲取。 父節(jié)點(diǎn):ReplicationRule 子節(jié)點(diǎn):Status |
響應(yīng)頭
此接口僅涉及公共響應(yīng)頭。更多信息,請(qǐng)參見(jiàn)公共響應(yīng)頭(Common Response Headers)。
示例
請(qǐng)求示例
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
錯(cuò)誤碼
錯(cuò)誤碼 | HTTP狀態(tài) | 描述 |
ReplicationLocationNotSupportRtc | 400 BadRequest | 不支持在該地域開(kāi)啟RTC功能。關(guān)于支持開(kāi)啟RTC功能的地域信息,請(qǐng)參見(jiàn)RTC地域限制。 |
BucketReplicationInClosingStatus | 400 BadRequest | 當(dāng)跨區(qū)域復(fù)制規(guī)則處于關(guān)閉狀態(tài)時(shí),不支持開(kāi)啟或關(guān)閉RTC功能。 |
BucketReplicationNotSupportRtc | 400 BadRequest | 當(dāng)前跨區(qū)域復(fù)制規(guī)則不支持開(kāi)啟RTC功能。請(qǐng)聯(lián)系技術(shù)支持排查并解決問(wèn)題。 |