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-阿裏雲