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 keinen Einfluss 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änderlicher Object Storage (WORM)

Die IBM Cloud Object Storage-Implementierung von Immutable Object Storage (d. h. Aufbewahrungsrichtlinien) ist in Buckets mit aktivierter Versionierung nicht zulässig. Versuche, eine Aufbewahrungsrichtlinie zu erstellen, schlagen fehl, ebenso wie Versuche, die Versionsverwaltung für einen 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 Bucket 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 festlegen, 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 Object Storage auf, die Objektschlüssel in der Antwort URL-zu-kodieren. Objektschlüssel können beliebige Unicode-Zeichen enthalten; der XML 1.0-Parser kann jedoch bestimmte Zeichen nicht verarbeiten, beispielsweise Zeichen mit einem ASCII-Wert zwischen 0 und 10. Für Zeichen, die in XML 1.0 nicht unterstützt werden, können Sie diesen Parameter hinzufügen, um anzugeben, dass Object Storage die Schlüssel in der Antwort kodieren soll. Gültiger Wert: url.

key-marker: Gibt den Schlüssel an, mit dem bei der Auflistung von Objekten in einem Bucket 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 niemals 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'

Beispiel für die IBM Cloud-CLI:

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 Versionsverwaltung mithilfe des IBM Cloud Object Storage-SDKs für Python kann entweder über die High-Level-Ressourcen- oder die Low-Level-Client-Syntax 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 Versionsverwaltung mit dem 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
});