版本控制

必须进行版本控制才能启用复制。 在源存储区和目标存储区上 启用版本控制 并在源存储区上配置复制后，可能会迂到以下问题:

• 如果尝试在源存储区上禁用版本控制，那么 Object Storage 将返回错误。 必须先除去复制配置，然后才能在源存储区上禁用版本控制。
• 如果在目标存储区上禁用版本控制，那么复制将失败。

Key Protect 加密

源对象将 使用源存储区的根密钥进行加密，副本将使用目标存储区的根密钥进行加密。

生命周期配置

如果在目标存储区上启用了 生命周期策略，那么生命周期操作将基于源对象的原始创建时间，而不是基于副本在目标存储区中变为可用的时间。

不可变对象存储器

在启用了 版本控制 的存储区上不可能使用保留策略，并且由于版本控制是复制的需求，因此无法在启用了不可变 Object Storage 的存储区中复制对象。

旧存储区防火墙

使用 旧防火墙来限制基于 IP 地址的访问 的存储区无法使用复制，因为复制对象的后台服务没有固定 IP 地址，并且无法通过防火墙。

建议改为 使用基于上下文的限制 来根据网络信息控制访问。

Cloud Functions 和 Code Engine

此时配置复制不会提供 Cloud Functions 的触发器 或 Code Engine 事件，但对象写入和删除将为源存储区和目标存储区创建 Object:Write 和 Object:Delete 通知。 这些事件使用 notifications.replication_type 字段进行注释，该字段指示事件是触发了同步，还是由同步触发。

在存储区上启用复制

复制配置在请求主体中以 XML 形式提供。 新请求将覆盖存储区上存在的任何现有复制规则。

复制配置必须至少包含一个规则，并且最多可以包含 1,000 个规则。 每个规则通过过滤源存储区中的对象来标识要复制的对象子集。 要选择要复制的其他对象子集，请为每个子集添加规则。

要指定源存储区中要应用复制规则的对象的子集，请添加 Filter 元素作为 Rule 元素的子代。 您可以根据对象键前缀和/或一个或多个对象标记来过滤对象。 在配置中添加 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 标识的第三个存储区，并且将在所有情况下复制删除标记。

假定将以下四个对象添加到源存储区。 它们将复制到目标存储区，如下所述:

1. project_a/foo.mp4
2. project_a/bar.mp4
3. project_b/baz.pdf
4. project_b/acme.pdf。此第四个对象还具有键为 Client 且值为 ACME 的对象标记。

由于以下规则，对象 1 和 2 将复制到 $DESTINATION_CRN_A。 对象 3 将复制到 $DESTINATION_CRN_B。 对象 4 将仅复制到 $DESTINATION_CRN_C，因为标识为 AcmeCorp 的规则具有比标识为 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
});