複製とは?

レプリケーションは、新しく作成されたオブジェクトとオブジェクトの更新を、ソースバケットからターゲットバケットにコピーします。

• 新しいオブジェクト、または既存のオブジェクトの新しいバージョン（レプリケーションルールがバケットに追加された後に作成されたもの）のみが、ターゲットバケットにコピーされます。 既存のオブジェクトを 自分自身にコピーすることで、 複製された新しいバージョンを作ることができる。
• ソース・オブジェクトのメタデータがレプリケートされたオブジェクトに適用される。
• 2つのバケット間で双方向レプリケーションを行うには、両方のバケットでルールが有効になっている必要があります。
• フィルタ（プレフィックスやタグで構成）を使って、レプリケーションルールをオブジェクトのサブセットだけに適用するようにスコープすることができます。 1つのポリシーに複数のルールを定義することができ、これらのルールは異なる宛先を指定することができる。 このようにして、同じバケット内の異なるオブジェクトを異なる宛先にレプリケートすることができる。

なぜレプリケーションを使うのか？

• 異なる地理的な場所にあるバケットにデータのコピーを保管する。
• 許可された場所にのみレプリカを保存するレプリケーション・ルールを定義することで、データ主権に関するコンプライアンス規制を満たすことができます。
• レプリケーションでは、最終更新時刻やバージョンIDなどのオブジェクト・メタデータが保持されるため、本番データとテストデータの同期を保つことができます。
• ターゲットバケットに異なるストレージクラスやライフサイクルルールを定義することで、ソースに依存しないレプリケートされたオブジェクトのストレージクラスやライフサイクルポリシーを管理します。 同様に、バケット内のレプリカを別のサービスインスタンスや、 IBM Cloud アカウント保存し、レプリカへのアクセスを独自に制御することもできます。

レプリケーションを始める

始めるにあたって、いくつかの前提条件を満たしておく必要がある：

• ソースバケットに Writer または Manager プラットフォームロール、あるいは適切なレプリケーションアクションを持つカスタムロール（ cloud-object-storage.bucket.put_replication など）を設定します。
• ターゲットバケットへのアクセス権は必要ありませんが、ソースバケットからターゲットバケットへの書き込みを許可する 新しい IAM ポリシーを 作成するための十分なプラットフォームロールが必要です。
• ターゲットバケットは、レガシーバケットファイアウォールを有効にしてはいけませんが、 コンテキストベースの制限を 使うことができます。
• SSE-Cを使用して 暗号化されたオブジェクトはレプリケートできないが、 Key Protect のようなマネージド暗号化（SSE-KMS ）はレプリケーションと完全に互換性がある。
• アーカイブ状態のオブジェクトはレプリケートできない。
• ソースバケットとターゲットバケットが異なる IBM アカウントある場合は、必ずそれぞれのアカウントバケットを作成してください。
• ソースバケットとターゲットバケットの両方で バージョン管理を 有効にする。

バージョニングはレプリケーションの要件であるため、 Immutable Object Storage ポリシーで 設定されたバケット内のオブジェクトをレプリケートすることはできません。

IBM アカウント使用

同じ IBM アカウントバケット間でオブジェクトを複製するには、以下のようにします：

1. 選択したソースバケットに移動したら、 Configuration タブをクリックします。
2. Bucket replicationを探し、 Setup replication ボタンをクリックする。
3. 「 レプリケーションのソース 」を選択し、「 次へ 」をクリックします。
4. ドロップダウンメニューからインスタンスとバケットを選択します。 または、ラジオボタンを 「いいえ」に切り替え、対象のバケツの CRN を貼り付けます。
5. チェック権限ボタンをクリックします。

ここで、ソースバケットにターゲットバケットの Writer パーミッションを付与する必要があります。 これにはいくつかの方法があるが、最も簡単なのは IBM Cloud Shell と IBM Cloud CLI を使うことである。

1. IBM Cloud Shell を新しいウィンドウまたはタブで開きます。
2. Object storageコンソールに表示されている IBM Cloud CLIコマンドをコピーし、新しいシェルに貼り付ける。
3. バケツ設定ウィンドウまたはタブに戻り、 Check permissions ボタンをもう一度クリックします。

次にレプリケーション・ルールを作成する。

1. ルールステータスのラジオボタンが[ Enabled] に設定されていることを確認します。
2. ルールの名前と優先度、およびレプリケーションルールの対象となるオブジェクトを制限するプレフィックスまたはタグフィルタを指定します。
3. 「完了 (Done)」 をクリックします。

IBM アカウント使い分け

異なる IBM アカウントバケット間でオブジェクトを複製するには、以下のようにします：

1. 宛先の IBM アカウント IAM ポリシーを設定する。 IAMポリシーの作成については、 IAMポリシーとは何か、誰が割り当てることができるかを 参照してください。
2. アカウント IDとサービスインスタンスIDをバケット設定ページでCRN形式で検索します。
3. 宛先アカウント IBM Cloud UI を使用して、 Manage>Access**(IAM)** をクリックします。
4. 左のパネルで「 認証 」をクリックする。
5. [ 作成 ] をクリックして、新しい IAM ポリシーを作成します。
6. サービス認可ページの設定を許可する。 これは、新しいIAMポリシーを作成した後に表示されるページです。
7. 別のアカウント を選択し、ソースアカウント アカウント IDを入力します。
8. サービスアクセスを提供する Cloud Object Storage.
9. アクセス範囲]で[ 特定のリソース ]を選択します。
10. Source Service Instance を選択し、ソースバケットのサービスインスタンスIDを入力します。
11. ターゲット]で、ソースバケットへのアクセスに Cloud Object Storage を選択する。
12. Target Scopeで Specific resources> Service** Instanceを選択する。
13. ドロップダウンメニューから宛先アカウントサービスインスタンスIDを選択します。
14. 必要に応じて、 オブジェクト・ライター またはライターの役割を選択してください。

レプリケーションを有効にするには、 オブジェクト・ライターの役割だけで十分です。

用語

ソースバケット ：レプリケーションポリシーが設定されているバケット。 複製されたオブジェクトのソースである。

ターゲットバケット ：ソースバケットレプリケーションポリシーでデスティネーションとして定義されているバケット。 複製されたオブジェクトのターゲットである。 デスティネーション」バケットとも呼ばれる。

レプリカ ：ソースバケットへのリクエストによってターゲットバケットに作成される新しいオブジェクト。

何が複製されるのか？

CopyObject, PutObject, CompleteMultipartUpload によって作成された新しいオブジェクトは、ソースバケットからターゲットバケットにレプリケートされます。 複製されたオブジェクトは、ソースオブジェクトから以下のメタデータフィールドを継承する： Etag Last Modified Time、 Version ID、 user-attributes、 Tags。

削除マーカーは、レプリケーション・ポリシーで設定されていればレプリケートされる。

バージョンのタグの更新は、ソースバケットからターゲットバケットにレプリケートされます。

以下は複製されない：

• ライフサイクルイベントによって開始されるアクション
• アーカイブに直接書き込まれたオブジェクト
• アーカイブ層からリストアされたオブジェクト
• SSE-Cで暗号化されたオブジェクト
• オブジェクトACL

事業継続と災害復旧のためのレプリケーションの活用

レプリケーションは、障害発生時にサービスの継続性を提供するために使用できる：

• ソースバケットとターゲットバケットが異なる場所にあることを確認する。
• 両方のバケット間でオブジェクトの最新バージョンが同期されていることを確認する。 のようなツールが便利である。 Rclone ( rclone check コマンド)は、コマンドラインからシンクロニシティをチェックするのに便利である。
• 障害が発生した場合、アプリケーションのトラフィックをターゲットバケットにリダイレクトすることができる。

一貫性とデータの完全性

IBM Cloud Object Storage はすべてのデータIO操作に対して強力な一貫性を提供するが、バケット構成は最終的に一貫性を失う。 バケットで初めてレプリケーションルールを有効にした後、設定がシステム全体に伝わり、新しいオブジェクトがレプリケートされ始めるまで、しばらく時間がかかることがあります。

例外処理

レプリケーションの失敗は、バケットの設定ミス、サービスの停止、宛先バケットに対するユーザーの操作など、さまざまな理由（これらに限定されない）によって発生する可能性があります。

COSには、レプリケーションの障害に対処するための耐障害性が組み込まれています。 障害が発生した場合、COSは最大30日間、再試行を行うことができます。 再試行の頻度は、障害の性質によって異なる場合があります。 たとえば、まれに発生するI/Oエラーによる障害については数時間以内に再試行が行われる一方、ユーザーのバケット設定ミスによる障害については1日1回のみ再試行が行われる場合があります。 障害が30日以内に解消されない場合、システムによる自動再試行は行われなくなります。 すべての長期的な障害は、以下を通じて一覧表示できます ListBucketReplicationFailures を通じて一覧表示できます。

30日以上経過した「古い」失敗を再試行したい場合は、 PutBucketReplicationFailureReattempt を使用して再試行をトリガーできます。

IAM アクション

レプリケーションに関連する新しいIAMアクションがある。

Activity Tracker イベント

複製によって追加イベントが生成されます。

cloud-object-storage.bucket-replication.create イベントの場合、以下のフィールドに追加情報が示されます。

複製がアクティブな場合、オブジェクトに対する操作により、以下の追加情報が生成されることがあります。

オブジェクトがソースに書き込まれてからターゲットに書き込まれるまで、オブジェクトをトレースすることができます。 オブジェクト書き込みに関連付けられた要求 ID を検索すると、以下の 3 つのイベントが表示されます。

• 元の PUT。
• ソースからの同期要求。
• ターゲット上の PUT 要求。

これら 3 つのいずれかが欠落している場合は、障害を示します。

使用量とアカウンティング

すべてのレプリカはオブジェクト自体であり、他のデータと同様に 使用法を提供 します。 複製が成功すると、複製プロセスで消費された帯域幅は請求されませんが、 PUT、 GET、および HEAD の各要求が請求可能になります。

レプリケーションは、 IBM Cloud Monitoring で使用する追加のメトリクスを生成します：

• ibm_cos_bucket_replication_sync_requests_issued
• ibm_cos_bucket_replication_sync_requests_received

インタラクション

既存のオブジェクトの複製

複製ルールは、ルールが構成されてバケットに適用された 後 に書き込まれたオブジェクトに対してのみ動作できます。 複製する必要がある既存のオブジェクトがバケット内にある場合は、オブジェクトの存在を複製プロセスに認識させる必要があります。 これは、 PUT copy 操作を使用してオブジェクトをそれ自体にコピーすることによって簡単に行うことができます。

このプロセスにより、作成タイム・スタンプを含む一部のオブジェクト・メタデータがリセットされます。 これは、ライフサイクル・ポリシー、および作成タイム・スタンプまたは変更タイム・スタンプを使用するその他のサービス (コンテンツ配信ネットワークなど) に影響します。 オブジェクト・メタデータのリセットによって生じる可能性のある中断が適切に処理されていることを確認してください。

このプロセスには以下が含まれます

1. 複製ルールの対象となるバケット内のすべてのオブジェクトのリストを作成する
2. そのリストを反復処理し、ソースが要求のターゲットと同一である各オブジェクトに対して PUT copy 操作を実行します。

この例では、 PUT copy 要求によって作成されたオブジェクトの新規バージョンのみを複製します。 オブジェクトのすべてのバージョンを複製するには、個々のバージョンもコピーする必要があります。

以下の例は Pythonで作成されていますが、アルゴリズムは任意のプログラミング言語またはコンテキストで適用できます。

import os
import sys
import ibm_boto3
from ibm_botocore.config import Config

# Create client connection
cos = ibm_boto3.client("s3",
                       ibm_api_key_id=os.environ.get('IBMCLOUD_API_KEY'),
                       ibm_service_instance_id=os.environ['SERVICE_INSTANCE_ID'],
                       config=Config(signature_version="oauth"),
                       endpoint_url=os.environ['US_GEO']
                       )

# Define the bucket with existing objects for replication
bucket = os.environ['BUCKET']

def copy_in_place(BUCKET_NAME):
    print("Priming existing objects in " + bucket + " for replication...")

    paginator = cos.get_paginator('list_objects_v2')
    pages = paginator.paginate(Bucket=bucket)

    for page in pages:
        for obj in page['Contents']:
            key = obj['Key']
            print("  * Copying " + key + " in place...")
            try:
                headers = cos.head_object(
                    Bucket=bucket,
                    Key=key
                    )
                md = headers["Metadata"]
                cos.copy_object(
                    CopySource={
                        'Bucket': bucket,
                        'Key': key
                        },
                    Bucket=bucket,
                    Key=key,
                    TaggingDirective='COPY',
                    MetadataDirective='REPLACE',
                    Metadata=md
                    )
                print("    Success!")
            except Exception as e:
                print("    Unable to copy object: {0}".format(e))
    print("Existing objects in " + bucket + " are now subject to replication rules.")

copy_in_place(bucket)

REST API の例

以下の例では、使いやすさのために cURL を使用しています。 環境変数は、 $BUCKET、 $TOKEN、および $REGION などのユーザー固有のエレメントを表すために使用されます。 $REGION にはネットワーク・タイプの指定も含まれるため、プライベート・ネットワークを使用して us-south のバケットに要求を送信するには、この変数を private.us-south に設定する必要があることに注意してください。

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: exuBoz2kFBykNwqu64JZuA==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
            <Rule>
              <ID>SimpleReplication</ID>
              <Priority>1</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Disabled</Status>
              </DeleteMarkerReplication>
              <Filter/>
              <Destination>
                <Bucket>$DESTINATION_CRN</Bucket>
              </Destination>
          	</Rule>
          </ReplicationConfiguration>'

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: exuBoz2kFBykNwqu64JZuA==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
            <Rule>
              <ID>ProjectA</ID>
              <Priority>10</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Enabled</Status>
              </DeleteMarkerReplication>
              <Filter>
                <Prefix>project_a/</prefix>
              </Filter>
              <Destination>
                <Bucket>$DESTINATION_CRN_A</Bucket>
              </Destination>
          	</Rule>
            <Rule>
              <ID>ProjectB</ID>
              <Priority>5</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Enabled</Status>
              </DeleteMarkerReplication>
              <Filter>
                <Prefix>project_b/</prefix>
              </Filter>
              <Destination>
                <Bucket>$DESTINATION_CRN_B</Bucket>
              </Destination>
          	</Rule>
            <Rule>
              <ID>AcmeCorp</ID>
              <Priority>20</Priority>
              <Status>Enabled</Status>
              <DeleteMarkerReplication>
                <Status>Enabled</Status>
              </DeleteMarkerReplication>
              <Filter>
                <Tag>
                  <Key>Client</Key>
                  <Value>ACME</Value>
                </Tag>
              </Filter>
              <Destination>
                <Bucket>$DESTINATION_CRN_C</Bucket>
              </Destination>
          	</Rule>
          </ReplicationConfiguration>'

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN'

<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Rule>
    <ID>SimpleReplication</ID>
    <Status>ENABLED</Status>
    <DeleteMarkerReplication>
      <Status>DISABLED</Status>
    </DeleteMarkerReplication>
    <Destination>
      <Bucket>crn:v1:bluemix:public:cloud-object-storage:global:a/9978e07eXXXXXXXX66c89c428028654:ef1c725e-XXXX-4967-bcc1-734c03a2b846:bucket:replication-destination</Bucket>
    </Destination>
    <Priority>1</Priority>
    <Filter/>
  </Rule>
</ReplicationConfiguration>

curl -X "DELETE" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?replication" \
     -H 'Authorization: bearer $TOKEN'

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?ibm-replication-failures" \
     -H 'Authorization: bearer $TOKEN'

<ListReplicationFailureResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Name>example</Name>
    <FirstSyncAttemptedBefore>2025-12-15T00:00:00.000Z</FirstSyncAttemptedBefore>
    <MaxKeys>10</MaxKeys>
    <IsTruncated>false</IsTruncated>
    <EncodingType>false</EncodingType>
    <KeyCount>2</KeyCount>
    <Contents>
        <Key>test-obj+*1765434016787</Key>
        <VersionId>00000000-0000-0000-0000-019b0c114413</VersionId>
        <SyncType>Content</SyncType>
        <FirstSyncAttempted>2025-12-11T06:20:16.787Z</FirstSyncAttempted>
        <LastSyncAttempted>2025-12-11T06:20:16.787Z</LastSyncAttempted>
        <SyncFailureCause>Versioning disabled on destination bucket</SyncFailureCause>
    </Contents>
    <Contents>
        <Key>test-obj+*1765434016786</Key>
        <VersionId>00000000-0000-0000-0000-019b0c114412</VersionId>
        <SyncType>Content</SyncType>
        <FirstSyncAttempted>2025-12-11T06:20:16.786Z</FirstSyncAttempted>
        <LastSyncAttempted>2025-12-11T06:20:16.786Z</LastSyncAttempted>
        <SyncFailureCause>Replication operation not authorized on target bucket</SyncFailureCause>
    </Contents>
</ListReplicationFailureResult>

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?ibm-replication-reattempt" \
     -H 'Authorization: bearer $TOKEN'

HTTP/1.1 204 No Content
Connection: close
...
x-ibm-replication-reattempt-scheduled-time: Fri, 12 Dec 2025 00:00:00 GMT

SDK の例

以下の例では、 IBM COS SDK for Python および Node.jsを使用していますが、オブジェクト・バージョン管理の実装は、カスタム・エンドポイントの設定を可能にする S3-compatible ライブラリーまたはツールと完全に互換性がなければなりません。 サード・パーティー・ツールを使用するには、 AWS V4 署名を計算するための HMAC 資格情報が必要です。 HMAC 資格情報について詳しくは、 資料を参照してください。

#!/usr/bin/env python3

import ibm_boto3
from ibm_botocore.config import Config
from ibm_botocore.exceptions import ClientError

# Define constants
API_KEY = os.environ.get('IBMCLOUD_API_KEY')
SERVICE_INSTANCE = os.environ.get('SERVICE_INSTANCE_ID')
ENDPOINT = os.environ.get('ENDPOINT')

BUCKET = "my-replication-bucket" # The bucket that will enable replication.

# Create resource client with configuration info pulled from environment variables.
cosClient = ibm_boto3.client("s3",
                         ibm_api_key_id=API_KEY,
                         ibm_service_instance_id=SERVICE_INSTANCE,
                         config=Config(signature_version="oauth"),
                         endpoint_url=ENDPOINT
                         )

response = cosClient.put_bucket_versioning(
    Bucket=BUCKET,
    ReplicationConfiguration={
        'Rules': [
            {
                'ID': 'string',
                'Priority': 123,
                'Filter': {
                    'Prefix': 'string',
                    'Tag': {
                        'Key': 'string',
                        'Value': 'string'
                    },
                    'And': {
                        'Prefix': 'string',
                        'Tags': [
                            {
                                'Key': 'string',
                                'Value': 'string'
                            },
                        ]
                    }
                },
                'Status': 'Enabled'|'Disabled',
                'Destination': {
                    'Bucket': 'string',
                },
                'DeleteMarkerReplication': {
                    'Status': 'Enabled'|'Disabled'
                }
            },
        ]
    }
)

resp = cosClient.list_object_versions(Prefix='some-prefix', Bucket=BUCKET)

const IBM = require('ibm-cos-sdk');

var config = {
    endpoint: '<endpoint>',
    apiKeyId: '<api-key>',
    serviceInstanceId: '<resource-instance-id>',
};

var cos = new IBM.S3(config);

var params = {
  Bucket: 'STRING_VALUE', /* required */
  ReplicationConfiguration: { /* required */
    Role: 'STRING_VALUE', /* required */
    Rules: [ /* required */
      {
        Destination: { /* required */
          Bucket: 'STRING_VALUE', /* required */
        },
        Status: Enabled | Disabled, /* required */
        Filter: {
          And: {
            Prefix: 'STRING_VALUE',
            Tags: [
              {
                Key: 'STRING_VALUE', /* required */
                Value: 'STRING_VALUE' /* required */
              },
              /* more items */
            ]
          },
          Prefix: 'STRING_VALUE',
          Tag: {
            Key: 'STRING_VALUE', /* required */
            Value: 'STRING_VALUE' /* required */
          }
        },
        ID: 'STRING_VALUE',
        Prefix: 'STRING_VALUE',
        Priority: 'NUMBER_VALUE',
        }
      }
    ]
  },
  ContentMD5: 'STRING_VALUE',
};
cos.putBucketReplication(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});