Versionierungsobjekte

Versionsgesteuerte Objekte archivieren und als verfallen speichern

Lebenszykluskonfigurationen sind in einem für die Version aktivierten Bucket zulässig. Im Gegensatz zu Amazon S3unterliegen neue Versionen jedoch der Archivierungsregel auf dieselbe Weise wie reguläre Objekte. Objekte erhalten ein Übergangsdatum, wenn sie erstellt werden, und werden an ihrem individuellen Übergangsdatum archiviert, unabhängig davon, ob sie aktuelle oder nicht aktuelle Versionen sind. Das Überschreiben eines Objekts hat keine Auswirkungen auf das Übergangsdatum der vorherigen Version und der neuen (aktuellen) Version wird ein Übergangsdatum zugewiesen.

Es ist nicht möglich, NoncurrentVersionTransition-Regeln zu verwenden, um nur nicht aktuelle Versionen von Objekten in einer Lebenszykluskonfiguration zu archivieren.

Unveränderlich Object Storage (WORM)

Die IBM COS-Implementierung von Immutable Object Storage (d. h. Aufbewahrungsrichtlinien) ist in Buckets mit aktivierter Versionssteuerung nicht zulässig. Versuche, eine Aufbewahrungsrichtlinie zu erstellen, schlagen ebenso fehl wie Versuche, die Versionssteuerung für ein Bucket mit einer Aufbewahrungsrichtlinie zu aktivieren.

Versionssteuerung für Bucket aktivieren

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

Eine erfolgreiche Anforderung gibt eine 200-Antwort zurück.

Versionssteuerung für ein Bucket aussetzen

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

Eine erfolgreiche Anforderung gibt eine 200-Antwort zurück.

Versionen von Objekten in einem Bereich auflisten

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

Gibt einen XML-Antworthauptteil zurück:

<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: Ein Trennzeichen ist ein Zeichen, das Sie angeben, um Schlüssel zu gruppieren. Alle Schlüssel, die dieselbe Zeichenfolge zwischen dem Präfix und dem ersten Vorkommen des Begrenzers enthalten, werden unter einem einzelnen Ergebniselement in CommonPrefixes gruppiert. Diese Gruppen werden als ein Ergebnis für die Begrenzung der maximalen Anzahl von Schlüsseln gezählt. Diese Schlüssel werden nicht an anderer Stelle in der Antwort zurückgegeben.

encoding-type: Fordert COS zum URL-Codieren der Objektschlüssel in der Antwort an. Objektschlüssel können beliebige Unicode-Zeichen enthalten. Einige Zeichen, wie z. B. Zeichen mit einem ASCII-Wert von 0 bis 10, können jedoch vom XML 1.0-Parser nicht syntaktisch analysiert werden. Für Zeichen, die in XML 1.0nicht unterstützt werden, können Sie diesen Parameter hinzufügen, um anzufordern, dass COS die Schlüssel in der Antwort codiert. Gültiger Wert: url.

key-marker: Gibt den Schlüssel an, mit dem bei der Auflistung von Objekten in einem Bereich begonnen werden soll.

max-keys: Legt die maximale Anzahl der in der Antwort zurückgegebenen Schlüssel fest. Standardmäßig gibt die API bis zu 1.000 Schlüsselnamen zurück. Die Antwort enthält möglicherweise weniger Schlüssel, aber nie mehr.

prefix: Verwenden Sie diesen Parameter, um nur die Schlüssel auszuwählen, die mit dem angegebenen Präfix beginnen.

version-id-marker: Gibt die Objektversion an, bei der die Auflistung beginnen soll.

Versionen von Objekten in einem Bucket löschen

Ein regulärer Aufruf von ListObjects oder ListObjectsV2 gibt keine Versions-IDs zurück. Um die Versions-IDs zu erhalten, die für einen Löschvorgang benötigt werden, müssen Sie ListObjectVersions verwenden: eine GET-Anfrage mit dem Abfrageparameter ?versions. Dies gibt auch die Löschmarkierungen und ihre Versions-IDs zurück. Ohne diesen Schritt ist keiner der folgenden Löschvorgänge möglich.

curl Beispiel:

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

IBM Cloud CLI-Beispiel:

ibmcloud cos object-versions --bucket $BUCKET

Python-Beispiel:

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

Operationen für bestimmte Versionen von Objekten

Mehrere APIs verwenden einen neuen Abfrageparameter (?versionId=<VersionId>), der angibt, welche Version des Objekts Sie anfordern. Dieser Parameter wird auf dieselbe Weise zum Lesen, Löschen, Überprüfen von Metadaten und Tags und Wiederherstellen archivierter Objekte verwendet. Um beispielsweise eine Version eines Objekts foo mit der Versions-ID L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo zu lesen, könnte die Anforderung wie folgt aussehen:

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

Das Löschen dieses Objekts erfolgt auf dieselbe Weise.

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

Für Anforderungen, die bereits einen Abfrageparameter verwenden, kann der Parameter versionId am Ende hinzugefügt werden.

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

Das serverseitige Kopieren von Objektversionen wird unterstützt, verwendet jedoch eine geringfügig andere Syntax. Der Abfrageparameter wird nicht zur URL URL selbst hinzugefügt, sondern an den x-amz-copy-source Header angehängt. Dies ist dieselbe Syntax wie die Erstellung eines Teils für einen mehrteiligen Teil aus einem Quellenobjekt.

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

Die Aktivierung der Versionssteuerung mit dem IBM COS SDK für Python kann entweder mit der Syntax der übergeordneten Ressource oder der Low-Level-Clientsyntax erfolgen.

Ressource verwenden:

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

Die Versionssteuerung für das Bucket kann dann mit versioning.suspend() ausgesetzt werden.

Bei Verwendung derselben cos-Ressource können alle Versionen von Objekten wie folgt aufgelistet werden:

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

Verwendung eines Clients:

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

Auflisten der Versionen eines Objekts mit demselben Client:

resp = cosClient.list_object_versions(Prefix='some-prefix', Bucket=BUCKET)

Löschen Sie die Versionen eines Objekts, die denselben Mandanten verwenden:

Die APIs von Python sind sehr flexibel, und es gibt viele verschiedene Möglichkeiten, die gleiche Aufgabe zu erfüllen.

Node.js

Aktivieren der Versionssteuerung mit dem 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
});