GET Bucket Replication

最近更新时间:2021-04-12 16:29:46

查看PDF

描述

此接口返回源存储空间的跨区域复制配置, 即描述规则的一个xml。

权限

如果要使用此接口,您需要对该存储空间具有GET BucketReplication权限。

请求

语法

GET /?crr HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}  

请求参数

该接口不使用请求参数。

请求头部

只使用常用请求头部。获取更多信息,请点击常用请求头部。

请求内容

不使用请求内容。

响应

响应头部

本接口只带有常用响应头部。获取更多信息,请点击常用响应头部。

响应内容

返回一个xml,可能有下列节点:

名称 描述 是否必须
Replication 包含跨区域复制规则的容器, 一个源存储空间只能有一条规则。
类型:Container
子节点: 无
父节点:无
prefix 前缀匹配,如果object匹配了前缀规则才会对该对象进行复制,每条跨区域复制规则最多添加5条前缀匹配规则,且前缀之间不同重叠。
类型:String
父节点:Replication
DeleteMarkerStatus 指明是否开始删除复制,若显式指定为Enabled为开启,若为Disabled或不指定均为关闭状态,若开启删除复制,则当源Bucket删除一个对象时,该对象在目标Bucket的副本也会删除。
类型:String
父节点:Replication
targetBucket 跨区域复制的目标存储空间
类型:String
父节点:Replication

特殊错误

Error Code 描述 HTTP Status Code
NoSuchBucketReplicationConfiguration 此复制没有跨区域复制规则配置 404 Not Found

示例

请求示例

GET /?crr HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Wed, 14 May 2014 02:11:21 GMT
Content-MD5: xxx 
Authorization: authorization string
Content-Length: yyy
Content-type: application/xml

以上在某个存储空间上设置跨区域复制规则,其中复制规则匹配两条前缀规则(“abc”和“xyz”),且启用删除同步功能,目标存储空间为targetbucket。

响应示例

HTTP/1.1 200 OK  
Content-Length: 0  
Date: Tue, 19 Jul 2017 09:14:23 GMT  
Server: Tengine  
x-kss-request-id: 6af24440694b4d00b8de063ccbe86336  
<Replication xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
	<prefix>abc</prefix>  
	<prefix>xyz</prefix>   
	<DeleteMarkerStatus>Enabled</DeleteMarkerStatus>   
	<targetBucket>bucketname</targetBucket>  
</Replication>

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈