调用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

子节点：无

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（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 qn6qrrqxo2oawuk53otf****:CTkuxpLAi4XZ+WwIfNm0Fmgb****


<?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功能。请联系技术支持排查并解决问题。