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 {
// この例では、中国 (杭州) リージョンを使用します。エンドポイントを、ソースバケットが配置されているリージョンの実際のエンドポイントに置き換えてください。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// エンドポイントに対応するリージョン ID (cn-hangzhou など) を指定します。
String region = "cn-hangzhou";
// コードに認証情報を保存すると、漏洩してアカウントのセキュリティが損なわれる可能性があるため、推奨されません。この例では、環境変数から認証情報を取得する方法を示します。この例を実行する前に、必要な環境変数を設定してください。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// ソースバケットの名前を指定します。
String bucketName = "src-bucket";
// データレプリケーションの宛先バケットを指定します。宛先バケットとソースバケットは、同じアカウントに属している必要があります。
String targetBucketName = "dest-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 がレプリケーションのために引き受ける RAM ロールを指定します。ロールには、ソースバケットからのレプリケーションと宛先バケットへの書き込み権限が必要です。
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");
// レプリケーションするオブジェクトのプレフィックスを指定します。指定されたプレフィックスを持つオブジェクトのみが宛先バケットにレプリケーションされます。
//request.setObjectPrefixList(prefixes);
//List actions = new ArrayList();
//actions.add(AddBucketReplicationRequest.ReplicationAction.PUT);
// オブジェクトの作成および更新操作をソースバケットから宛先バケットにレプリケーションします。
//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())
# ソースバケットが配置されているリージョンのエンドポイントを指定します。この例では、中国 (杭州) リージョンを使用します。エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。
# ソースバケットの名前 (例：src-bucket) を指定します。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'src-bucket')
replica_config = ReplicationRule(
# データレプリケーションの宛先バケットを指定します。宛先バケットとソースバケットは、同じアカウントに属している必要があります。
target_bucket_name='dest-bucket',
# 宛先バケットのリージョンを指定します。宛先バケットとソースバケットは、異なるリージョンにある必要があります。
target_bucket_location='oss-cn-shanghai',
# OSS がデータをレプリケーションするために引き受ける RAM ロールの名前を指定します。このロールには、ソースバケットからの CRR 実行権限と宛先バケットへの書き込み権限が必要です。
sync_role_name='roleNameTest',
)
# レプリケーションするオブジェクトのプレフィックスを指定します。プレフィックスを指定すると、そのプレフィックスで始まる名前のオブジェクトのみが宛先バケットにレプリケーションされます。
# prefix_list = ['prefix1', 'prefix2']
# データレプリケーションルールを設定します。
# replica_config = ReplicationRule(
# prefix_list=prefix_list,
# オブジェクトの作成および更新操作をソースバケットから宛先バケットにレプリケーションします。
# action_list=[ReplicationRule.PUT],
# データレプリケーションの宛先バケットを指定します。宛先バケットとソースバケットは、同じアカウントに属している必要があります。
# target_bucket_name='dest-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" // 宛先バケットが配置されているリージョン。
)
// バケットの名前が指定されているかどうかを確認します。
if len(bucketName) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, bucket name required")
}
// リージョンが指定されているかどうかを確認します。
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)
}