功能描述

此接口用于为存储桶（Bucket）设置跨区域复制规则或同区域复制规则。通过 PutBucketReplication 接口，您可以将新创建的对象及修改的对象从一个源桶复制到相同地域或不同地域的目标桶中。

前提条件

如果您设置的是跨账号跨区域复制规则或跨账号同区域复制规则，则在设置规则前，您必须先授予 TOS 源桶读权限和目标桶的写权限。具体操作，请参见跨账号复制的权限配置。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
replication	Query	String	是	-	代表 PutBucketReplication 请求的特殊标识。

请求元素

名称	参数类型	是否必选	示例值	说明
Role	String	是	ServiceRoleforReplicationAccessTOS	角色名称。该角色必须具有 TOS 的读写权限及服务访问权限，您也可以使用 TOS 默认角色 ServiceRoleforReplicationAccessTOS。
Rules	Array	是	-	复制规则信息。
ID	String	否	1	规则的唯一标识符，小于 255 字符。
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	String	是	Target Bucket Name	目标桶名称。
Location	String	是	cn-beijing	目标桶所在的地域。
StorageClass	String	否	STANDARD	指定复制到目标存储桶的对象的存储类型，取值说明如下： STANDARD：标准存储。 STANDARD_IA：低频访问存储。 INTELLIGENT_TIERING：智能分层存储。 GLACIER_IR: 归档闪回存储。 ARCHIVE: 归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。说明当前仅华北2（北京）、华东2（上海）和华南1（广州）支持冷归档存储。当前仅华北2（北京）、华东2（上海）和华南1（广州）支持深度冷归档，且都处于邀测状态，如您需要使用该存储类型，请联系客户经理。如果同时设置了 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：传输加速链路。该链路仅允许在中国内地和中国内地以外地区之间进行跨区域复制数据时使用。默认值为 internal 。说明使用传输加速链路传输数据前，您必须开启传输加速功能，且开启后不能关闭，详细介绍，请参见开启传输加速。传输加速为邀测功能，如需试用，请联系客户经理。传输加速是单独的计费项，使用传输加速功能时，TOS 会同时收取源端桶的跨区域复制流量费用和传输加速流出流量费用。详细介绍，请参见传输加速费用。
AccessControlTranslation	Object	否	-	对象的所有者管理权限。说明仅跨账号复制对象时，需要设置 AccessControlTranslation参数。
Owner	String	否	BucketOwnerEntrusted	仅支持设置为 BucketOwnerEntrusted，表示将复制的对象授予目的存储桶所有者管理权限，即目的存储桶将拥有读取对象，授予其他账号读取对象的权限。默认目标存储桶所有者可以覆盖和删除对象，但是不能读取对象，也不能授予其他账号读取对象的权限。父节点：AccessControlTranslation 说明仅跨账号复制对象时，需要设置 Owner 参数。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

响应示例

对象存储