## 简介
本文档提供关于存储桶复制的 API 概览以及 SDK 示例代码。
| API | 操作名 | 操作描述 |
| ------------------------------------------------------------ | -------------- | -------------------------- |
| [PUT Bucket replication](https://intl.cloud.tencent.com/document/product/436/19223) | 设置存储桶复制 | 设置存储桶的存储桶复制规则 |
| [GET Bucket replication](https://intl.cloud.tencent.com/document/product/436/19222) | 查询存储桶复制 | 查询存储桶的存储桶复制规则 |
| [DELETE Bucket replication](https://intl.cloud.tencent.com/document/product/436/19221) | 删除存储桶复制 | 删除存储桶的存储桶复制规则 |
## 设置存储桶复制
#### 功能说明
设置指定存储桶的存储桶复制规则（PUT Bucket replication）。
#### 方法原型
```java
public void setBucketReplicationConfiguration(
SetBucketReplicationConfigurationRequest setBucketReplicationConfigurationRequest)
throws CosClientException, CosServiceException;
```
#### 请求示例
[//]: # (.cssg-snippet-put-bucket-replication)
```java
// 源存储桶名称，需包含 appid
String bucketName = "examplebucket-1250000000";
BucketReplicationConfiguration bucketReplicationConfiguration = new BucketReplicationConfiguration();
// 设置发起者身份, 格式为： qcs::cam::uin/:uin/
bucketReplicationConfiguration.setRoleName("qcs::cam::uin/100000000001:uin/100000000001");
// 设置目标存储桶和存储类型，QCS 的格式为：qcs::cos:[region]::[bucketname-AppId]
ReplicationDestinationConfig replicationDestinationConfig = new ReplicationDestinationConfig();
replicationDestinationConfig.setBucketQCS("qcs::cos:ap-beijing::destinationbucket-1250000000");
replicationDestinationConfig.setStorageClass(StorageClass.Standard);
// 设置规则状态和前缀
ReplicationRule replicationRule = new ReplicationRule();
replicationRule.setStatus(ReplicationRuleStatus.Enabled);
replicationRule.setPrefix("");
replicationRule.setDestinationConfig(replicationDestinationConfig);
// 添加规则
String ruleId = "replication-to-beijing";
bucketReplicationConfiguration.addRule(replicationRule);
Set
