- 动态与公告
- 产品简介
- 购买指南
- 快速入门
- 控制台指南
- 工具指南
- 实践教程
- 开发者指南
- 数据湖存储
- 数据处理
- 故障处理
- API 文档
- 简介
- 公共请求头部
- 公共响应头部
- 错误码
- 请求签名
- 操作列表
- Service 接口
- Bucket 接口
- Object 接口
- 批量处理接口
- 数据处理接口
- 任务与工作流
- 内容审核接口
- 云查毒接口
- SDK 文档
- SDK 概览
- 准备工作
- Android SDK
- C SDK
- C++ SDK
- .NET(C#) SDK
- Flutter SDK
- Go SDK
- iOS SDK
- Java SDK
- JavaScript SDK
- Node.js SDK
- PHP SDK
- Python SDK
- React Native SDK
- 小程序 SDK
- 错误码
- 常见问题
- 相关协议
- 附录
- 词汇表
- 动态与公告
- 产品简介
- 购买指南
- 快速入门
- 控制台指南
- 工具指南
- 实践教程
- 开发者指南
- 数据湖存储
- 数据处理
- 故障处理
- API 文档
- 简介
- 公共请求头部
- 公共响应头部
- 错误码
- 请求签名
- 操作列表
- Service 接口
- Bucket 接口
- Object 接口
- 批量处理接口
- 数据处理接口
- 任务与工作流
- 内容审核接口
- 云查毒接口
- SDK 文档
- SDK 概览
- 准备工作
- Android SDK
- C SDK
- C++ SDK
- .NET(C#) SDK
- Flutter SDK
- Go SDK
- iOS SDK
- Java SDK
- JavaScript SDK
- Node.js SDK
- PHP SDK
- Python SDK
- React Native SDK
- 小程序 SDK
- 错误码
- 常见问题
- 相关协议
- 附录
- 词汇表
简介
本文档提供关于存储桶复制的 API 概览以及 SDK 示例代码。
API | 操作名 | 操作描述 |
设置存储桶复制 | 设置存储桶的存储桶复制规则 | |
查询存储桶复制 | 查询存储桶的存储桶复制规则 | |
删除存储桶复制 | 删除存储桶的存储桶复制规则 |
设置存储桶复制
功能说明
设置指定存储桶的存储桶复制规则（PUT Bucket replication）。
方法原型
public void setBucketReplicationConfiguration(SetBucketReplicationConfigurationRequest setBucketReplicationConfigurationRequest)throws CosClientException, CosServiceException;
请求示例
// 源存储桶名称，需包含 appidString bucketName = "examplebucket-1250000000";BucketReplicationConfiguration bucketReplicationConfiguration = new BucketReplicationConfiguration();// 设置发起者身份, 格式为： qcs::cam::uin/<OwnerUin>:uin/<SubUin>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);SetBucketReplicationConfigurationRequest setBucketReplicationConfigurationRequest =new SetBucketReplicationConfigurationRequest(bucketName, bucketReplicationConfiguration);cosClient.setBucketReplicationConfiguration(setBucketReplicationConfigurationRequest);
参数说明
参数名 | 参数描述 | 类型 |
bucketName | 存储桶的命名格式为 BucketName-APPID，详情请参见 命名规范 | String |
setBucketReplicationConfigurationRequest | 存储桶复制配置 | SetBucketReplicationConfigurationRequest |
返回结果说明
成功：无返回值。
失败：发生错误（如身份认证失败），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。
查询存储桶复制
功能说明
查询指定存储桶的存储桶复制规则（GET Bucket replication）。
方法原型
// 获取存储桶存储桶复制配置方法1public BucketReplicationConfiguration getBucketReplicationConfiguration(String bucketName)throws CosClientException, CosServiceException;// 获取存储桶存储桶复制方法2public BucketReplicationConfiguration getBucketReplicationConfiguration(GetBucketReplicationConfigurationRequest getBucketReplicationConfigurationRequest)throws CosClientException, CosServiceException;
请求示例
String bucketName = "examplebucket-1250000000";// 获取存储桶存储桶复制配置方法1BucketReplicationConfiguration brcfRet = cosClient.getBucketReplicationConfiguration(bucketName);// 获取存储桶存储桶复制配置方法2BucketReplicationConfiguration brcfRet2 = cosClient.getBucketReplicationConfiguration(new GetBucketReplicationConfigurationRequest(bucketName));
参数说明
参数名 | 参数描述 | 类型 |
bucketName | 存储桶的命名格式为 BucketName-APPID，详情请参见 命名规范 | String |
getBucketReplicationConfigurationRequest | 获取存储桶复制配置请求 | GetBucketReplicationConfigurationRequest |
返回结果说明
成功：返回存储桶的存储桶复制规则。
失败：发生错误（如身份认证失败），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。
删除存储桶复制
功能说明
删除指定存储桶的存储桶复制规则（DELETE Bucket replication）。
方法原型
// 删除存储桶存储桶复制配置方法1public void deleteBucketReplicationConfiguration(String bucketName)throws CosClientException, CosServiceException;// 删除存储桶存储桶复制方法2public void deleteBucketReplicationConfiguration(DeleteBucketReplicationConfigurationRequest deleteBucketReplicationConfigurationRequest)throws CosClientException, CosServiceException;
请求示例
String bucketName = "examplebucket-1250000000";// 删除存储桶存储桶复制配置方法1cosClient.deleteBucketReplicationConfiguration(bucketName);// 删除存储桶存储桶复制配置方法2cosClient.deleteBucketReplicationConfiguration(new DeleteBucketReplicationConfigurationRequest(bucketName));
参数说明
参数名 | 参数描述 | 类型 |
bucketName | 存储桶的命名格式为 BucketName-APPID，详情请参见 命名规范 | String |
deleteBucketReplicationConfigurationRequest | 删除存储桶复制配置请求 | DeleteBucketReplicationConfigurationRequest |
返回结果说明
成功：无返回值。
失败：发生错误（如身份认证失败），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。
是
否
本页内容是否解决了您的问题？