バージョン管理

複製を有効にするには、バージョン管理が必須です。 ソース・バケットとターゲット・バケットの両方で バージョン管理を有効に し、ソース・バケットで複製を構成すると、以下の問題が発生する場合があります。

• ソース・バケットのバージョン管理を無効にしようとすると、 Object Storage からエラーが返されます。 ソース・バケットのバージョン管理を無効にするには、複製構成を削除する必要があります。
• ターゲット・バケットのバージョン管理を無効にすると、複製は失敗します。

Key Protect 暗号化

ソース・オブジェクトは、ソース・バケットの ルート・キーを使用して暗号化 され、レプリカはターゲット・バケットのルート・キーを使用して暗号化されます。

ライフサイクル構成

ターゲット・バケットで ライフサイクル・ポリシー が有効になっている場合、ライフサイクル・アクションは、ターゲット・バケットでレプリカが使用可能になる時刻ではなく、ソースでのオブジェクトの元の作成時刻に基づきます。

Immutable Object Storage

バージョン管理が有効になっている バケットでは保存ポリシーを使用できません。バージョン管理は複製の要件であるため、Immutable Object Storage が有効になっているバケットとの間でオブジェクトを複製することはできません。

レガシー・バケット・ファイアウォール

IP アドレスに基づいてアクセスを制限するためにレガシー・ファイアウォールを使用するバケット は、複製を使用できません。オブジェクトを複製するバックグラウンド・サービスには固定 IP アドレスがなく、ファイアウォールを渡すことができないためです。

ネットワーク情報に基づいてアクセスを制御する場合は、代わりに コンテキストベースの制限を使用する ことをお勧めします。

Cloud Functions および Code Engine

複製を構成しても、現時点では Cloud Functions のトリガー イベントも Code Engine イベントも提供されませんが、オブジェクトの書き込みと削除により、ソースとターゲットの両方のバケットに対して Object:Write 通知と Object:Delete 通知が作成されます。 これらのイベントには、イベントが同期をトリガーしたか、同期によってトリガーされたかを示す notifications.replication_type フィールドの注釈が付けられます。

バケットでの複製の有効化

複製構成は、要求の本体で XML として提供されます。 新規要求により、バケットに存在する既存の複製規則が上書きされます。

複製構成には少なくとも 1 つの規則を含める必要があり、最大 1,000 個を含めることができます。 各ルールは、ソース・バケット内のオブジェクトをフィルタリングすることによって、複製するオブジェクトのサブセットを識別します。 複製するオブジェクトの追加サブセットを選択するには、サブセットごとにルールを追加します。

複製規則を適用するソース・バケット内のオブジェクトのサブセットを指定するには、 Rule エレメントの子として Filter エレメントを追加します。 オブジェクト・キー接頭部、1 つ以上のオブジェクト・タグ、またはその両方に基づいてオブジェクトをフィルターに掛けることができます。 構成に Filter エレメントを追加する場合は、 DeleteMarkerReplication、 Status、および Priority エレメントも追加する必要があります。

要求の本体には、以下のスキーマの XML ブロックが含まれている必要があります。

この例では、すべての新規オブジェクトを複製しますが、削除マーカーは複製しません。

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>'

この例では、 project_a/ で始まるキー (名前) を持つすべてのオブジェクトを $DESTINATION_CRN_A で識別されるバケットに複製し、 project_b/ で始まるキー (名前) を持つすべてのオブジェクトを $DESTINATION_CRN_B で識別されるバケットに複製し、キー Client と値 ACME を持つすべてのオブジェクトを $DESTINATION_CRN_C で識別される 3 番目のバケットに複製します。すべてのケースで削除マーカーを複製します。

以下の 4 つのオブジェクトがソース・バケットに追加されるとします。 以下で説明するように、ターゲット・バケットに複製されます。

1. project_a/foo.mp4
2. project_a/bar.mp4
3. project_b/baz.pdf
4. project_b/acme.pdf この 4 番目のオブジェクトには、キー Client と値 ACME を持つオブジェクト・タグもあります。

以下の規則により、オブジェクト 1 および 2 は $DESTINATION_CRN_A に複製されます。 オブジェクト 3 は $DESTINATION_CRN_B に複製されます。 オブジェクト 4 は $DESTINATION_CRN_C にのみ複製されます。これは、ID AcmeCorp のルールの優先順位の値が ID ProjectB のルールの優先順位の値より高く、両方のルールの要件を満たしている場合にのみ、前者のルールに従うためです。

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>'

要求が成功すると、 200 応答が返されます。

バケットの複製構成の表示

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

これにより、適切なスキーマを持つ XML 応答本体が返されます。

<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'

要求が成功すると、 204 応答が返されます。

Python

IBM COS SDK for Python を使用したバージョン管理は、 低レベル・クライアント 構文を使用して行うことができます。

クライアントの使用:

#!/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)

Python API は非常に柔軟であり、同じタスクを実行するためのさまざまな方法があることに注意してください。

Node.js

IBM COS SDK for Node.js を使用したバージョン管理の有効化:

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
});