You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
存储桶复制
GetBucketReplication
复制全文
下载 pdf
GetBucketReplication
此接口用于获取指定存储桶(Bucket)当前的数据复制进度、跨区域复制规则或同区域复制规则。​
说明​
分层桶暂不支持 GetBucketReplication 接口。​
请求消息样式​
​
GET /?replication&progress&rule-id=1 HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: authorization string​
​
请求参数和消息头​
该请求使用的公共请求消息头,请参见公共参数。​
​
名称​
位置​
参数类型​
是否必选​
示例值​
说明​
replication​
Query​
String​
是​
-​
代表 GetBucketReplication 请求的特殊标识。​
progress​
Query​
String​
否​
progress​
是否查询桶的数据复制进度,需与 rule-id 参数一起使用。​
rule-id​
Query​
String​
否​
1​
查询复制进度的规则编号,需与 progress 参数一起使用。​
​
请求元素​
该请求不使用消息元素。​
响应消息头​
该请求返回的公共响应消息头,请参见公共参数。​
响应元素​
​
名称​
参数类型​
示例值​
说明​
Role​
String​
ServiceRoleforReplicationAccessTOS​
角色名称。​
Rules​
Array​
-​
复制规则。​
ID​
String​
1​
规则的唯一标识符。​
Status​
String​
Enabled​
指定是否启用该规则,取值说明如下:​
  • Enabled:启用该规则。​
  • Disabled:不启用该规则。​
PrefixSet​
Array​
prefix_1​
适用该规则的对象名前缀。​
Tags​
Array​
-​
TOS 可针对有特定标签的 Object 进行复制,最多可配置 10 个标签。关于标签的详细说明,请参见文件标签管理。​
Key​
String​
key​
对象标签的键。​
父节点:Tags​
Value​
String​
value​
对象标签的值。​
父节点:Tags​
Destination​
Object​
-​
保存目标 Bucket 信息。​
Bucket​
String​
Target Bucket Name​
存储被规则标识的对象副本的桶名称。​
Location​
String​
cn-beijing​
目标桶所在的地域。​
StorageClass​
String​
STANDARD​
指定复制到目标存储桶的对象的存储类型,取值说明如下:​
  • STANDARD:标准存储。​
  • STANDARD_IA:低频存储。​
  • GLACIER_IR: 归档闪回存储。​
  • INTELLIGENT_TIERING: 智能分层存储。​
  • ARCHIVE:归档存储。​
  • COLD_ARCHIVE:冷归档存储。​
  • DEEP_COLD_ARCHIVE:深度冷归档存储​
说明​
如果同时设置了 StorageClass 和 StorageClassInheritDirective 参数,优先根据 StorageClass指定的值设置对象的存储类型。​
StorageClassInheritDirective​
String​
DESTINATION_BUCKET​
设置复制到目标存储桶的对象存储类型,取值说明如下:​
  • SOURCE_OBJECT:继承源桶对象的存储类型。​
  • DESTINATION_BUCKET:继承目标存储桶的默认存储类型。​
HistoricalObjectReplication​
String​
Enabled​
是否开启复制历史对象,如果开启,会复制符合这条规则的历史对象,取值说明如下:​
  • Enabled:开启复制历史对象。​
  • Disabled:不开启复制历史对象。​
DeleteMarkerReplication​
String​
Enabled​
是否开启同步删除标记,如果开启,会复制符合这条规则的删除标记,取值说明如下:​
  • Enabled:开启同步删除标记。​
  • Disabled:不开启同步删除标记。​
注意​
当前同步删除标记功能处于邀测状态,如您需要使用该功能,请联系客户经理。​
DeleteObjectReplication​
String​
Enabled​
是否开启同步删除对象,如果开启,在源桶删除对象后,会同步删除目标存储桶中的对象,取值说明如下:​
  • Enabled:开启同步删除对象。​
  • Disabled:不开启同步删除对象。​
注意​
  • 当前同步删除对象功能处于邀测状态,如您需要使用该功能,请联系客户经理。​
  • 默认情况下,开启同步删除对象后,TOS 会保证两端数据的最终一致性。但如果您配置了多个桶间的双向复制规则,且在复制过程中删除了单个目标端的对象,则 TOS 无法保证各端数据的最终一致性。​
TransferType​
String​
tos_acc​
数据复制时使用的数据传输链路,取值说明如下:​
  • internal:TOS 默认传输链路。该链路仅允许在中国内地和中国内地之间进行跨区域复制数据时使用。​
  • tos_acc:传输加速链路。该链路仅允许在中国内地和中国内地以外地区之间进行跨区域复制数据时使用。​
关于传输加速的详细介绍,请参见传输加速。​
AccessControlTranslation​
Object​
-​
对象的所有者管理权限。​
说明​
仅跨账号复制对象时,会返回 AccessControlTranslation 参数,如果存储桶使用的是跨账号复制功能,但是没有返回 AccessControlTranslation 参数,说明没有授予目的存储桶复制的对象所有者管理权限,即目标存储桶所有者可以覆盖和删除对象,但是不能读取对象,也不能授予其他账号读取对象的权限。​
Owner​
String​
BucketOwnerEntrusted​
已授予目的存储桶复制的对象所有者管理权限,即目的存储桶拥有读取对象,授予其他账号读取对象的权限。​
Progress​
Object​
-​
保存复制的进度。​
NewObject​
String​
2015-09-24T15:28:14.000Z​
显示数据复制到目标桶的时间点。​
HistoricalObject​
float64​
0.99​
显示已复制历史数据的百分比。​
​
请求示例​
​
GET /?replication&progress&rule-id=1 HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: authorization string​
​
响应示例​
​
HTTP/1.1 200 OK​
Date: Fri, 30 Jul 2021 13:53:55 GMT​
Server: TosServer​
x-tos-id-2: 1e89f203jld00006-a444fd0​
x-tos-request-id: 1e89f203b2d00006-a444ed0​
Content-Length: 643​
​
{​
"Role": "ServiceRoleforReplicationAccessTOS",​
"Rules":[{​
"ID": "1",​
"Status": "Enabled",​
"PrefixSet": ["prefix_1", "prefix_2"],​
"Destination":{​
"Bucket":"Target Bucket Name",​
"Location": "Target Bucket Location",​
"StorageClass": "STANDARD"​
},​
"HistoricalObjectReplication": "Enabled",​
"DeleteMarkerReplication": "Enabled",​
"DeleteObjectReplication": "Disabled",​
"AccessControlTranslation": {​
"Owner": "BucketOwnerEntrusted"​
},​
"Progress":{​
"NewObject": "2015-09-24T15:28:14.000Z",​
"NewObject": "0.99"​
}​
}]​
}​
​
​
最近更新时间:2026.02.03 14:18:14
这个页面对您有帮助吗?
有用
有用
无用
无用