归档和到期版本化对象

在支持版本的存储区中允许生命周期配置。 但是，与 Amazon S3不同，新版本受归档规则约束的方式与常规对象相同。 创建对象时，将为其提供转换日期，并在其个别转换日期对其进行归档，而不考虑这些对象是当前版本还是非当前版本。 覆盖对象不会影响先前版本的转换日期，并且将为新 (当前) 版本分配转换日期。

无法使用 NoncurrentVersionTransition 规则 仅 归档生命周期配置中对象的非当前版本。

不可变Object Storage（WORM）

在启用了版本控制的存储区中不允许不可变 Object Storage (即，保留时间策略) 的 IBM COS 实现。 尝试创建保留时间策略将失败，尝试在具有保留时间策略的存储区上启用版本控制也将失败。

在存储区上启用版本控制

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?versioning" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: 8qj8HSeDu3APPMQZVG06WQ==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<VersioningConfiguration>
            <Status>Enabled</Status>
          </VersioningConfiguration>'

成功的请求返回 200 响应。

暂挂存储区上的版本控制

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?versioning" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: hxXDWuCDWB72Be0LG4XniQ==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<VersioningConfiguration>
            <Status>Suspended</Status>
          </VersioningConfiguration>'

成功的请求返回 200 响应。

列出水桶中对象的版本

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

这将返回 XML 响应主体:

<ListVersionsResult>
   <IsTruncated>boolean</IsTruncated>
   <KeyMarker>string</KeyMarker>
   <VersionIdMarker>string</VersionIdMarker>
   <NextKeyMarker>string</NextKeyMarker>
   <NextVersionIdMarker>string</NextVersionIdMarker>
   <Version>
      <ETag>string</ETag>
      <IsLatest>boolean</IsLatest>
      <Key>string</Key>
      <LastModified>timestamp</LastModified>
      <Owner>
         <DisplayName>string</DisplayName>
         <ID>string</ID>
      </Owner>
      <Size>integer</Size>
      <StorageClass>string</StorageClass>
      <VersionId>string</VersionId>
   </Version>
   ...
   <DeleteMarker>
      <IsLatest>boolean</IsLatest>
      <Key>string</Key>
      <LastModified>timestamp</LastModified>
      <Owner>
         <DisplayName>string</DisplayName>
         <ID>string</ID>
      </Owner>
      <VersionId>string</VersionId>
   </DeleteMarker>
   ...
   <Name>string</Name>
   <Prefix>string</Prefix>
   <Delimiter>string</Delimiter>
   <MaxKeys>integer</MaxKeys>
   <CommonPrefixes>
      <Prefix>string</Prefix>
   </CommonPrefixes>
   ...
   <EncodingType>string</EncodingType>
</ListVersionsResult>

delimiter：分隔符是您指定用于分组键的字符。 在前缀与第一次出现的定界符之间包含相同字符串的所有键都分组在 CommonPrefixes 中的单个结果元素下。 这些组将根据 max-keys 限制作为一个结果进行计数。 这些键不会在响应中的其他位置返回。

encoding-type: 请求 COS 对响应中的对象键进行 URL 编码。 对象键可能包含任何 Unicode 字符; 但是，XML 1.0 解析器无法解析某些字符，例如具有从 0 到 10 的 ASCII 值的字符。 对于 XML 1.0中不支持的字符，您可以添加此参数以请求 COS 对响应中的密钥进行编码。 有效值: url。

key-marker：指定在列出数据桶中的对象时要从哪个键开始。

max-keys: 设置响应中返回的最大密钥数。 缺省情况下，API 最多返回 1,000 个密钥名称。 响应可能包含更少的密钥，但永远不会包含更多密钥。

prefix: 使用此参数可仅选择那些以指定前缀开头的键。

version-id-marker: 指定要从其开始列表的对象版本。

对特定对象版本的操作

多个 API 使用新的查询参数 (?versionId=<VersionId>)，该参数指示您正在请求哪个版本的对象。 此参数以相同的方式用于读取，删除，检查元数据和标记以及复原归档对象。 例如，要读取版本标识为 L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo 的对象 foo 的版本，请求可能类似于以下内容:

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

以相同方式删除该对象。

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

对于已使用查询参数的请求，可以将 versionId 参数添加到末尾。

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/foo?tagging&versionId=L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo" \
     -H 'Authorization: bearer $TOKEN'

支持对象版本的服务器端复制，但使用的语法略有不同。 查询参数不会添加到 URL 本身，而是会附加到 x-amz-copy-source 头。 这与从源对象为多部分创建部分的语法相同。

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/<new-object-key>"
 -H "Authorization: bearer $TOKEN"
 -H "x-amz-copy-source: /<source-bucket>/<object-key>?versionId=L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo"

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-versioning-bucket" # The bucket that will enable versioning.

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

versioning = cos.BucketVersioning(BUCKET)

versioning.enable()

然后，可以使用 versioning.suspend() 暂挂存储区的版本控制

通过使用同一 cos 资源，可以使用以下命令列出对象的所有版本:

versions = s3.Bucket(BUCKET).object_versions.filter(Prefix=key)

for version in versions:
    obj = version.get()
    print(obj.get('VersionId'), obj.get('ContentLength'), obj.get('LastModified'))

使用客户机:

#!/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-versioning-bucket" # The bucket that will enable versioning.

#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,
    VersioningConfiguration={
        'Status': 'Enabled'
    }
)

使用同一客户机列出对象的版本:

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: 'my-versioning-bucket', /* required */
    VersioningConfiguration: { /* required */
    Status: 'Enabled'
   },
};

s3.putBucketVersioning(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
});