全部產品
Search
文件中心

Object Storage Service:PutBucketRTC

更新時間:Jun 08, 2024

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