腾讯云对象存储存储桶复制

简介

本文档提供关于存储桶复制的 API 概览以及 SDK 示例代码。

设置存储桶复制

功能说明

设置指定存储桶的存储桶复制规则（PUT Bucket replication）。

方法原型

public void setBucketReplicationConfiguration(        SetBucketReplicationConfigurationRequest setBucketReplicationConfigurationRequest)                throws CosClientException, CosServiceException;

请求示例

// 源存储桶名称，需包含 appidString 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);
SetBucketReplicationConfigurationRequest setBucketReplicationConfigurationRequest =        new SetBucketReplicationConfigurationRequest(bucketName, bucketReplicationConfiguration);cosClient.setBucketReplicationConfiguration(setBucketReplicationConfigurationRequest);

参数说明

返回结果说明

成功：无返回值。失败：发生错误（如身份认证失败），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。

查询存储桶复制

功能说明

查询指定存储桶的存储桶复制规则（GET Bucket replication）。

方法原型

// 获取存储桶存储桶复制配置方法1public BucketReplicationConfiguration getBucketReplicationConfiguration(String bucketName)            throws CosClientException, CosServiceException;
// 获取存储桶存储桶复制方法2        public BucketReplicationConfiguration getBucketReplicationConfiguration(            GetBucketReplicationConfigurationRequest getBucketReplicationConfigurationRequest)            throws CosClientException, CosServiceException;

请求示例

String bucketName = "examplebucket-1250000000";
// 获取存储桶存储桶复制配置方法1BucketReplicationConfiguration brcfRet = cosClient.getBucketReplicationConfiguration(bucketName);
// 获取存储桶存储桶复制配置方法2BucketReplicationConfiguration brcfRet2 = cosClient.getBucketReplicationConfiguration(        new GetBucketReplicationConfigurationRequest(bucketName));

参数说明

返回结果说明

成功：返回存储桶的存储桶复制规则。失败：发生错误（如身份认证失败），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。

删除存储桶复制

功能说明

删除指定存储桶的存储桶复制规则（DELETE Bucket replication）。

方法原型

// 删除存储桶存储桶复制配置方法1public void deleteBucketReplicationConfiguration(String bucketName)            throws CosClientException, CosServiceException;
// 删除存储桶存储桶复制方法2        public void deleteBucketReplicationConfiguration(            DeleteBucketReplicationConfigurationRequest deleteBucketReplicationConfigurationRequest)            throws CosClientException, CosServiceException;

请求示例

String bucketName = "examplebucket-1250000000";
// 删除存储桶存储桶复制配置方法1cosClient.deleteBucketReplicationConfiguration(bucketName);
// 删除存储桶存储桶复制配置方法2cosClient.deleteBucketReplicationConfiguration(new DeleteBucketReplicationConfigurationRequest(bucketName));

参数说明

返回结果说明

成功：无返回值。失败：发生错误（如身份认证失败），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。
对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠