GET Bucket Replication
最近更新时间：2023-01-05 21:12:16
描述
此接口返回源存储空间的复制配置，即描述规则的一个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 |
是 |
示例
请求示例
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没有配置复制规则。 |
文档内容是否对您有帮助？
根本没帮助
文档较差
文档一般
文档不错
文档很好
在文档使用中是否遇到以下问题
内容不全，不深入
内容更新不及时
描述不清晰，比较混乱
系统或功能太复杂，缺乏足够的引导
内容冗长
更多建议
0/200
评价建议不能为空
提交成功！
非常感谢您的反馈，我们会继续努力做到更好！