赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 关于Bucket操作
  7. 数据复制(Replication)
  8. PutBucketRTC

PutBucketRTC

  • 数据复制(Replication)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

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

SDK

此接口所对应的各语言SDK如下:

  • Java

  • Python

  • Go V2

命令行工具ossutil

PutBucketRTC接口所对应的ossutil命令,请参见put-bucket-rtc。

错误码

错误码

HTTP状态

描述

ReplicationLocationNotSupportRtc

400 BadRequest

不支持在该地域开启RTC功能。关于支持开启RTC功能的地域信息,请参见RTC地域限制。

BucketReplicationInClosingStatus

400 BadRequest

当跨区域复制规则处于关闭状态时,不支持开启或关闭RTC功能。

BucketReplicationNotSupportRtc

400 BadRequest

当前跨区域复制规则不支持开启RTC功能。请联系技术支持排查并解决问题。

相关文章

PutBucketReplication 2025-04-21 18:15

PutBucketReplication接口用于为存储空间(Bucket)指定数据复制规则。OSS支持跨区域复制(Cross-Region Replication)和同区域复制(Same-Region Replication)。 注意事项 数据复制是以异步(近实时

PutBucketRTC 2025-04-21 18:15

调用PutBucketRTC接口为已有的跨区域复制规则开启或关闭数据复制时间控制(RTC)功能。

GetBucketReplication 2025-04-21 18:15

调用GetBucketReplication接口获取某个存储空间(Bucket)已设置的数据复制规则。 请求语法

GetBucketReplicationLocation 2025-04-21 18:15

GetBucketReplicationLocation接口用于获取可复制到的目标存储空间(Bucket)所在的地域。您可以根据返回结果决定将源Bucket的数据复制到哪个地域。 请求语法

GetBucketReplicationProgress 2025-04-21 18:15

GetBucketReplicationProgress用于获取某个存储空间(Bucket)的数据复制进度。 请求语法

DeleteBucketReplication 2025-04-21 18:15

DeleteBucketReplication接口用来停止某个存储空间(Bucket)的数据复制并删除Bucket的复制配置,此时源Bucket中的任何操作都不会被同步到目标Bucket。 注意事项

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号