バージョン管理されたオブジェクトのアーカイブと有効期限切れ

ライフサイクル構成は、バージョンが有効なバケットで許可されます。 ただし、 Amazon S3とは異なり、新規バージョンは通常のオブジェクトと同じ方法でアーカイブ・ルールに従います。 オブジェクトには、作成時に遷移日が指定され、現行バージョンであるか非現行バージョンであるかに関係なく、個々の遷移日にアーカイブされます。 オブジェクトを上書きしても、以前のバージョンの移行日付けには影響せず、新しい（現在の）バージョンには移行日付けが割り当てられます。

NoncurrentVersionTransition ルールを使用して、ライフサイクル構成内のオブジェクトの非現行バージョン のみ をアーカイブすることはできません。

不変型 Object Storage （WORM）

IBM Cloud Object Storage における不変型 Object Storage （すなわち、保存ポリシー）の実装は、バージョン管理が有効になっているバケットでは使用できません。 保存ポリシーの作成は失敗します。また、保存ポリシーが設定されているバケットでバージョン管理を有効にしようとしても、同様に失敗します。

バケットのバージョン管理を有効にする

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 の単一の結果エレメントの下にグループ化されます。 これらのグループは、最大キー制限に対する 1 つの結果としてカウントされます。 これらのキーは、応答内の他の場所には返されません。

encoding-type: レスポンス内のオブジェクトキーをURLエンコードするよう、 Object Storage に要求します。 オブジェクトキーには任意のUnicode文字を含めることができますが、XML 1.0 パーサーでは、ASCII値が0から10までの文字など、一部の文字を解析できません。 XML 1.0 でサポートされていない文字については、このパラメータを追加することで、 Object Storage を使用してレスポンス内のキーをエンコードするよう要求できます。 有効な値: 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>) を使用します。 このパラメーターは、メタデータとタグの読み取り、削除、検査、およびアーカイブ・オブジェクトの復元に同じ方法で使用されます。 例えば、 L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo というバージョン ID を持つオブジェクト 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

Python 用 IBM Cloud Object Storage SDKを使用したバージョン管理の有効化は、 高レベルのリソース 構文または 低レベルのクライアント 構文のいずれかを使用して行うことができます。

リソースの使用:

#!/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 Cloud Object Storage 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
});