GetBucketReplication接口用来获取某个存储空间(Bucket)已设置的跨区域复制规则。
请求语法
GET /?replication HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
响应元素
名称 |
类型 |
描述 |
---|---|---|
ReplicationConfiguration |
容器 |
Bucket复制规则的容器。 父节点:无 子节点:Rule |
Rule |
容器 |
保存复制规则的容器。 父节点:ReplicationConfiguration 子节点:Destination、HistoricalObjectReplication、Status和ID |
ID |
字符串 |
复制规则对应的ID。 父节点:Rule 子节点:无 |
PrefixSet |
容器 |
保存前缀(Prefix)的容器。每条复制规则中,最多可指定10个Prefix。 父节点:Rule 子节点:Prefix |
Prefix |
字符串 |
被复制到目标Bucket中Object的前缀(Prefix)。 父节点:PrefixSet 子节点:无 |
Action |
字符串 |
表示被同步到目标Bucket的操作。 Action允许以下操作类型,您可以指定一项或多项。 取值:
父节点:Rule 子节点:无 |
Status |
字符串 |
表示复制状态。 取值:
父节点:Rule 子节点:无 |
Destination |
容器 |
保存目标Bucket信息的容器。 父节点:Rule 子节点:Bucket和Location |
Bucket |
字符串 |
数据要复制到的目标Bucket。 父节点:Destination 子节点:无 |
Location |
字符串 |
目标Bucket所处的Location。 父节点:Destination 子节点:无 |
TransferType |
字符串 |
跨区域复制时使用的数据传输类型。 取值:
|
HistoricalObjectReplication |
字符串 |
是否复制历史数据。即开启跨区域复制前,是否将源Bucket中的已有的数据复制到目标Bucket。 取值:
父节点:Rule 子节点:无 |
示例
请求示例
GET /?replication HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 24 Sep 2015 15:39:15 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:CTkuxpLAi4XZ+WwIfNm0Fmgb****
返回示例
说明仅当传输类型为oss_acc时,返回的XML示例中才会包含<TransferType>元素。
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 24 Sep 2015 15:39:15 GMT
Content-Length: 186
Content-Type: application/xml
Connection: close
Server: AliyunOSS
<?xml version="1.0" ?>
<ReplicationConfiguration>
<Rule>
<ID>test_replication_1</ID>
<PrefixSet>
<Prefix>source_image</Prefix>
<Prefix>video</Prefix>
</PrefixSet>
<Action>PUT</Action>
<Destination>
<Bucket>target-bucket</Bucket>
<Location>oss-cn-beijing</Location>
<TransferType>oss_acc</TransferType>
</Destination>
<Status>doing</Status>
<HistoricalObjectReplication>enabled</HistoricalObjectReplication>
<SyncRole>acs:ram::174649585760****:role/aliyunramrole</SyncRole>
</Rule>
</ReplicationConfiguration>
错误码
错误码 |
状态码 |
说明 |
---|---|---|
NoSuchBucket |
404 NotFound |
请求的Bucket不存在。 |
NoSuchReplicationConfiguration |
404 NotFound |
请求的Bucket没有配置跨区域复制规则。 |