Java
import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.AddBucketReplicationRequest;
public class Demo {
public static void main(String[] args) throws Exception {
// Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Endpoint對應的Region資訊，例如cn-hangzhou。
String region = "cn-hangzhou";
// 強烈建議不要把訪問憑證儲存到工程代碼裡，否則可能導致訪問憑證泄露，威脅您帳號下所有資源的安全。本程式碼範例以從環境變數中擷取訪問憑證為例。運行本程式碼範例之前，請先配置環境變數。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// 填寫源Bucket名稱。
String bucketName = "src-bucket";
// 指定資料要複製到的目標Bucket。目標Bucket與源Bucket必須屬於相同帳號。
String targetBucketName = "dest-bucket";
// 指定目標Bucket所在地區。目標Bucket與源Bucket必須處於不同地區。
String targetBucketLocation = "oss-cn-shanghai";
// 建立OSSClient執行個體。
// 當OSSClient執行個體不再使用時，調用shutdown方法以釋放資源。
ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
// 顯式聲明使用 V4 簽名演算法
clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
OSS ossClient = OSSClientBuilder.create()
.endpoint(endpoint)
.credentialsProvider(credentialsProvider)
.clientConfiguration(clientBuilderConfiguration)
.region(region)
.build();
try {
AddBucketReplicationRequest request = new AddBucketReplicationRequest(bucketName);
request.setTargetBucketName(targetBucketName);
request.setTargetBucketLocation(targetBucketLocation);
// 預設複製歷史資料。此處設定為false，表示禁止複製歷史資料。
request.setEnableHistoricalObjectReplication(false);
// 指定授權OSS進行資料複製的角色名稱，且該角色必須已被授予源Bucket執行跨地區複製以及目標Bucket接收複製對象的許可權。
request.setSyncRole("yourRole");
// 指定OSS是否複製通過SSE-KMS加密建立的對象。
//request.setSseKmsEncryptedObjectsStatus("Enabled");
// 指定SSE-KMS密鑰ID。如果指定Status為Enabled，則必須指定該元素。
//request.setReplicaKmsKeyID("3542abdd-5821-4fb5-a425-90adca***");
//List prefixes = new ArrayList();
//prefixes.add("image/");
//prefixes.add("video");
//prefixes.add("a");
//prefixes.add("A");
// 指定待覆制Object的首碼Prefix。指定Prefix後，只有匹配該Prefix的Object才會複製到目標Bucket。
//request.setObjectPrefixList(prefixes);
//List actions = new ArrayList();
//actions.add(AddBucketReplicationRequest.ReplicationAction.PUT);
// 將源Bucket內Object的新增、更新操作複製到目標Bucket。。
//request.setReplicationActionList(actions);
ossClient.addBucketReplication(request);
} catch (OSSException oe) {
System.out.println("Caught an OSSException, which means your request made it to OSS, "
+ "but was rejected with an error response for some reason.");
System.out.println("Error Message:" + oe.getErrorMessage());
System.out.println("Error Code:" + oe.getErrorCode());
System.out.println("Request ID:" + oe.getRequestId());
System.out.println("Host ID:" + oe.getHostId());
} catch (ClientException ce) {
System.out.println("Caught an ClientException, which means the client encountered "
+ "a serious internal problem while trying to communicate with OSS, "
+ "such as not being able to access the network.");
System.out.println("Error Message:" + ce.getMessage());
} finally {
if (ossClient != null) {
ossClient.shutdown();
}
}
}
}
Python
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
from oss2.models import ReplicationRule
# 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# 填寫源Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
# 填寫源Bucket名稱，例如src-bucket。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'src-bucket')
replica_config = ReplicationRule(
# 指定資料要複製到的目標Bucket。目標Bucket與源Bucket必須屬於不同帳號。
target_bucket_name='dest-bucket',
# 指定目標Bucket所在地區。目標Bucket與源Bucket必須處於不同地區。
target_bucket_location='oss-cn-shanghai',
# 指定授權OSS進行資料複製的角色名稱，且該角色必須已被授予源Bucket執行跨地區複製以及目標Bucket接收複製對象的許可權。
sync_role_name='roleNameTest',
)
# 指定待覆制Object的首碼Prefix。指定Prefix後，只有匹配該Prefix的Object才會複製到目標Bucket。
# prefix_list = ['prefix1', 'prefix2']
# 設定資料複製規則。
# replica_config = ReplicationRule(
# prefix_list=prefix_list,
# 將源Bucket內Object的新增、更新操作複製到目標Bucket。
# action_list=[ReplicationRule.PUT],
# 指定資料要複製到的目標Bucket。目標Bucket與源Bucket必須屬於不同帳號。
# target_bucket_name='dest-bucket',
# 指定目標Bucket所在地區。目標Bucket與源Bucket必須處於不同地區。
# target_bucket_location='yourTargetBucketLocation',
# 預設複製歷史資料。此處設定為False，表示禁止複製歷史資料。
# is_enable_historical_object_replication=False,
# 指定資料複製時使用的資料轉送鏈路。
# target_transfer_type='oss_acc',
#)
# 開啟資料複製。
bucket.put_bucket_replication(replica_config)
Go
package main
import (
"context"
"flag"
"log"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)
// 定義全域變數
var (
region string // 儲存地區
bucketName string // 儲存空間名稱
)
// init函數用於初始化命令列參數
func init() {
flag.StringVar(®ion, "region", "", "The region in which the bucket is located.")
flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
}
func main() {
// 解析命令列參數
flag.Parse()
var (
targetBucket = "target bucket name" // 目標儲存空間名稱
targetLocation = "oss-cn-beijing" // 目標儲存地區
)
// 檢查bucket名稱是否為空白
if len(bucketName) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, bucket name required")
}
// 檢查region是否為空白
if len(region) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, region required")
}
// 載入預設配置並設定憑證提供者和地區
cfg := oss.LoadDefaultConfig().
WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
WithRegion(region)
// 建立OSS用戶端
client := oss.NewClient(cfg)
// 建立開啟儲存空間資料複製的請求
request := &oss.PutBucketReplicationRequest{
Bucket: oss.Ptr(bucketName), // 儲存空間名稱
ReplicationConfiguration: &oss.ReplicationConfiguration{
Rules: []oss.ReplicationRule{
{
RTC: &oss.ReplicationTimeControl{
Status: oss.Ptr("enabled"), // 在配置跨地區複製規則時，開啟資料複製時間控制（RTC）功能
},
Destination: &oss.ReplicationDestination{
Bucket: oss.Ptr(targetBucket), // 目標儲存空間名稱
Location: oss.Ptr(targetLocation), // 目標儲存地區
TransferType: oss.TransferTypeOssAcc, // 傳輸類型
},
HistoricalObjectReplication: oss.HistoricalObjectReplicationEnabled, // 開啟歷史資料複製功能
},
},
},
}
// 執行開啟儲存空間資料複製的請求
result, err := client.PutBucketReplication(context.TODO(), request)
if err != nil {
log.Fatalf("failed to put bucket replication %v", err)
}
// 列印開啟儲存空間資料複製的結果
log.Printf("put bucket replication result:%#v\n", result)
}