金山云-文档中心-GET Bucket Replication

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

GET Bucket Replication

最近更新时间：2024-01-17 19:29:00

描述

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

权限

如果要使用此接口，您需要是这个Bucket的拥有者或具有ks3:GetBucketReplication权限。

请求

语法

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

请求参数

该接口不使用请求参数。

请求头部

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

请求内容

不使用请求内容。

响应

响应头部

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

响应内容

返回一个xml，可能有下列节点：

名称	描述	是否必选
Replication	包含复制规则的容器, 一个源存储空间只能有一条规则。类型：Container 子节点: 无父节点：无	是
prefix	前缀匹配，如果object匹配了前缀规则才会对该对象进行复制，每条复制规则最多添加10条前缀匹配规则，且前缀之间不同重叠。类型：String 父节点：Replication	否
DeleteMarkerStatus	指明是否开始删除复制，若显式指定为Enabled为开启，若为Disabled或不指定均为关闭状态，若开启删除复制，则当源Bucket删除一个对象时，该对象在目标Bucket的副本也会删除。类型：String 父节点：Replication	否
targetBucket	复制规则的目标存储空间类型：String 父节点：Replication	是
Region	目标存储空间所在的区域。类型：String	是
HistoricalObjectReplication	指定是否复制历史数据。即开启数据复制前，是否将源Bucket中的数据复制到目标Bucket。取值： Enabled：将历史数据复制到目标桶中（默认值） Disabled：不复制历史数据，仅将开启规则后的新数据复制到目标桶中。	是

示例

请求示例

GET /?crr HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.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 
Connection: keep-alive 
Date: Tue, 19 Jul 2017 09:14:23 GMT  
Server: KS3  
x-kss-request-id: 6af24440694b4d00b8de063ccbe86336  

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:Replication xmlns:ns2="http://s3.amazonaws.com/doc/2006-03-01/">
    <targetBucket>ywj-ks3-apitest1</targetBucket>
    <DeleteMarkerStatus>Enabled</DeleteMarkerStatus>
    <prefix>ccc</prefix>
    <prefix>aaa</prefix>
    <region>BEIJING</region>
</ns2:Replication>

错误码

错误码	HTTP状态码	描述
NoSuchBucketCrossRegionReplicate	404 Not Found	请求的Bucket没有配置复制规则。

文档导读

上一篇：PUT Bucket Replication

下一篇：DELETE Bucket Replication

纯净模式常规模式

纯净模式

点击可全屏预览文档内容