版本化物件

保存已版本化的物件並使其到期

已啟用版本的儲存區中允許生命週期配置。 不過，與 Amazon S3不同，新版本遵循保存規則的方式與一般物件相同。 物件會在建立時獲得轉移日期，並在其個別轉移日期保存，不論它們是現行版本還是非現行版本。 改寫物件不會影響舊版的轉移日期，而新 (現行) 版本將獲指派轉移日期。

無法使用 NoncurrentVersionTransition 規則在生命週期配置中 只 保存非現行版本的物件。

不可變更 Object Storage (WORM)

在啟用版本化的儲存區中不允許 Immutable 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 剖析器無法剖析部分字元，例如 ASCII 值從 0 到 10 的字元。 對於 XML 1.0中不支援的字元，您可以將此參數新增至要求 COS 對回應中的金鑰進行編碼。 有效值: url。

key-marker:指定列出水桶中物件時要從哪個鍵開始。

max-keys: 設定回應中傳回的索引鍵數目上限。 依預設，API 最多會傳回 1,000 個金鑰名稱。 回應可能包含較少的索引鍵，但絕不會包含較多的索引鍵。

prefix: 使用此參數只選取以指定字首開頭的金鑰。

version-id-marker: 指定您要從中開始列出的物件版本。

刪除水桶中物件的版本

一般的 ListObjects 或 ListObjectsV2 呼叫不會回傳版本 ID。 若要取得任何刪除作業所需的版本 ID，您必須使用 ListObjectVersions: 搭配 ?versions 查詢參數的 GET 請求。 這也會回傳刪除標記及其版本 ID。 沒有這個步驟，以下的刪除操作都無法進行。

curl 範例：

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

IBM Cloud CLI 範例：

ibmcloud cos object-versions --bucket $BUCKET

Python 範例：

pythonresponse = cosClient.list_object_versions(Bucket=BUCKET)
for version in response.get('Versions', []):
    print(version['Key'], version['VersionId'])
for marker in response.get('DeleteMarkers', []):
    print(marker['Key'], marker['VersionId'], '(delete marker)')

ibmcloud cos object-delete --bucket $BUCKET --key $OBJECT_KEY --version-id $VERSION_ID

pythoncosClient.delete_object(
    Bucket=BUCKET,
    Key='my-object.txt',
    VersionId='L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo'
)
Node.js:
javascriptawait cos.deleteObject({
  Bucket: 'my-versioning-bucket',
  Key: 'my-object.txt',
  VersionId: 'L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo'
}).promise();

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

cosClient.delete_object(
    Bucket=BUCKET,
    Key='my-object.txt',
    VersionId='null'
)

對特定物件版本的作業

數個 API 會使用新的查詢參數 (?versionId=<VersionId>) 來指出您要求的物件版本。 此參數以相同方式用於讀取、刪除、檢查 meta 資料和標籤，以及還原保存物件。 例如，若要讀取版本 ID 為 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
});