188      直播

跨区域复制__Java-SDK_SDK 参考_对象存储 OSS-阿里云

跨区域复制是跨不同OSS数据中心的Bucket自动、异步地复制Object，它会将对源Bucket中的对象的改动（新建、覆盖、删除等）同步到目标Bucket。该功能能够很好的提供Bucket跨区域容灾或满足用户数据复制的需求。目标Bucket中的对象是源Bucket中对象的精确副本，它们具有相同的对象名、元数据以及内容（例如，创建时间、拥有者、用户定义的元数据、Object ACL、对象内容等）。

更多跨区域复制的内容请参考 跨区域复制

开启跨区域复制

通过OSSClient.addBucketReplication开启跨区域复制：

AddBucketReplicationRequest request = new AddBucketReplicationRequest("bucketName");
request.setReplicationRuleID("ruleId");
request.setTargetBucketName("targetBucketName");
request.setTargetBucketLocation("oss-cn-qingdao");
ossClient.addBucketReplication(request);

提示：

• 开启跨区域复制，默认会同步历史数据。如果不需要同步历史数据，使用AddBucketReplicationRequest.setEnableHistoricalObjectReplication(false)禁止历史数据同步。

查看跨区域复制

通过OSSClient.getBucketReplication查看bucket上开启的跨区域复制：

List<ReplicationRule> rules = ossClient.getBucketReplication("bucketName");
for (ReplicationRule rule : rules) {
    System.out.println(rule.getReplicationRuleID());
    System.out.println(rule.getTargetBucketLocation());
    System.out.println(rule.getTargetBucketName());
}

删除跨区域复制

通过OSSClient.deleteBucketReplication删除已开启的跨区域复制，删除后目标bucket和object依然存在：

ossClient.deleteBucketReplication("bucketName", "ruleId");

查看跨区域复制进度

复制进度分为历史数据同步进度、实时数据同步进度。历史数据的同步用百分比表示，如0.80表示完成了80%，仅对开启了历史数据同步的Bucket有效。实时数据同步用新写入数据的时间点表示，表示这个时间点之前的数据已同步完成。

通过OSSClient.deleteBucketReplication查看跨区域复制进度：

BucketReplicationProgress process = ossClient.getBucketReplicationProgress("bucketName", "repRuleID");
System.out.println(process.getReplicationRuleID());
// 是否开启了历史数据同步
System.out.println(process.isEnableHistoricalObjectReplication());
// 历史数据同步进度
System.out.println(process.getHistoricalObjectProgress());
// 实时数据同步进度
System.out.println(process.getNewObjectProgress());

查看目标数据中心

通过OSSClient.getBucketReplicationLocation获取Bucket所在的数据中心可同步到的数据中心：

List<String> locations = ossClient.getBucketReplicationLocation("bucketName");
for (String loc : locations) {
    System.out.println(loc);
}

最后更新：2016-11-23 16:55:46

  上一篇： 设置访问日志__Java-SDK_SDK 参考_对象存储 OSS-阿里云

  下一篇： 管理存储空间__Python-SDK_SDK 参考_对象存储 OSS-阿里云