Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Auflisten von Objekten in einem versioning-fähigen Bucket
Dieser Abschnitt zeigt Beispiele, wie Objektversionen aus einem versioning-fähigen Bucket aufgelistet werden. Amazon S3 speichert Versionsinformationen zu Objekten in der versions-Subressource, die dem Bucket zugeordnet ist. Weitere Informationen finden Sie unter Optionen für die Bucket-Konfiguration. Um die Objekte in einem versionsfähigen Bucket aufzulisten, benötigen Sie die ListBucketVersions
-Berechtigung.
Befolgen Sie diese Schritte, um die Amazon-S3-Konsole zu verwenden, um die verschiedenen Versionen eines Objekts anzuzeigen.
Mehrere Versionen eines Objekts anzeigen
Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole unter https://console.aws.amazon.com/s3/
. -
Wählen Sie in der Liste Buckets den Namen des Buckets aus, der das Objekt enthält.
-
Um eine Liste der Versionen der Objekte in dem Bucket anzuzeigen, wählen Sie den Schalter Show versions (Versionen anzeigen).
Die Konsole zeigt für jede Objektversion eine eindeutige Versions-ID, das Datum und die Uhrzeit, wann das Objekt erstellt wurde, sowie weitere Eigenschaften an. (Objekte, die in Ihrem Bucket gespeichert waren, bevor Sie den Versioning-Status einrichten, haben die Versions-ID null.)
Um die Objekte ohne die Versionen aufzulisten, wählen Sie den Schalter List versions (Versionen auflisten) .
Objektversionen können auch in der Objektübersicht auf der Konsole angezeigt, heruntergeladen und gelöscht werden. Weitere Informationen finden Sie unter Anzeigen einer Objektübersicht in der Amazon-S3-Konsole.
Anmerkung
Um auf Objektversionen zuzugreifen, die älter als 300 Versionen sind, müssen Sie die AWS CLI oder die des Objekts verwendenURL.
Wichtig
Sie können den Löschvorgang für ein Objekt nur rückgängig machen, wenn seine aktuelle Version gelöscht wurde. Es ist nicht möglich, das Löschen einer vorherigen Version eines Objekts rückgängig zu machen, das gelöscht wurde. Weitere Informationen finden Sie unter Verwenden der Versioning in S3-Buckets.
Die Beispiele in diesem Abschnitt veranschaulichen, wie Sie eine Objektliste aus einem versioning-fähigen Bucket abrufen. Jede Anforderung gibt bis zu 1000 Versionen zurück, sofern Sie keine kleinere Anzahl festlegen. Wenn die Versionen im Bucket dieses Limit überschreiten, senden Sie eine Reihe von Anforderungen, um die Liste aller Versionen abzurufen. Dieser Vorgang zur „seitenweisen“ Rückgabe von Ergebnissen wird als Paginierung bezeichnet.
Um zu veranschaulichen, wie Paginierung funktioniert, limitieren die Beispiele jede Antwort auf zwei Objektversionen. Nachdem die erste Seite mit Ergebnissen abgerufen wurde, wird in jedem Beispiel überprüft, ob die Versionsliste abgeschnitten wurde. Wurde sie abgeschnitten, dann wird im Beispiel mit dem seitenweisen Abruf fortgefahren, bis alle Versionen abgerufen wurden.
Anmerkung
Die folgenden Beispiele funktionieren auch bei einem Bucket, der versioning-fähig ist, oder bei Objekten ohne individuelle Versionen. In solchen Fällen gibt Amazon S3 die Objektliste mit der Versions-ID von null
zurück.
Informationen zur Verwendung von anderen AWS SDKs finden Sie im AWS Developer
Beispiel – Alle Objektversionen in einem Bucket auflisten
Um alle Versionen aller Objekte in einem Bucket aufzulisten, verwenden Sie die versions
-Subressource in einer GET Bucket
-Anfrage. Amazon S3 kann maximal 1000 Objekte abrufen. Jede Objektversion zählt als vollständiges Objekt. Wenn ein Bucket also zwei Schlüssel enthält (z. B. photo.gif
und picture.jpg
) und der erste Schlüssel 990 Versionen und der zweite Schlüssel 400 Versionen hat, ruft eine einzelne Abfrage alle 990 Versionen von photo.gif
und nur die 10 neuesten Versionen von picture.jpg
ab.
Amazon S3 gibt Objektversionen in der Reihenfolge zurück, in der sie gespeichert wurden, wobei die zuletzt gespeicherte zuerst zurückgegeben wird.
Geben Sie in einer GET Bucket
-Anforderung die versions
-Subressource an.
GET /?versions HTTP/1.1 Host:
bucketName
.s3.amazonaws.com Date: Wed, 28 Oct 2009 22:32:00 +0000 Authorization: AWSAKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
Beispiel – Abruf aller Versionen eines Schlüssels
Wenn Sie eine Untermenge von Objektversionen abrufen möchten, verwenden Sie die Anforderungsparameter für GET
Bucket
. Weitere Informationen finden Sie unter GET Bucket.
-
Setzen Sie den Parameter
prefix
auf den Schlüssel des Objekts, das Sie abrufen wollen. -
Senden Sie eine
GET Bucket
-Anforderung unter Verwendung derversions
-Subressource undprefix
.GET /?versions&prefix=objectName HTTP/1.1
Beispiel – Abrufen von Objekten unter Verwendung eines Präfix
Das folgende Beispiel ruft Objekte ab, deren Schlüssel ist oder damit beginn myObject
.
GET /?versions&prefix=myObject HTTP/1.1 Host: bucket.s3.amazonaws.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
Sie können die anderen Anforderungsparameter verwenden, um eine Untermenge aller Versionen des Objekts abzurufen. Weitere Informationen finden Sie GET Bucketin der Amazon Simple Storage Service API Reference.
Beispiel – Abrufen einer Liste zusätzlicher Objekte, falls die Antwort gekürzt wurde
Wenn die Anzahl der Objekte, die in einer GET
-Anforderung zurückgegeben werden können, den Wert max-keys
überschreitet, enthält die Antwort <isTruncated>true</isTruncated>
, ebenso wie den ersten Schlüssel (in NextKeyMarker
) und die erste Versions-ID (in NextVersionIdMarker
), die die Anforderungskriterien erfüllen, aber nicht zurückgegeben wurden. Diese zurückgegebenen Werte verwenden Sie als Ausgangspunkt in einer nachfolgenden Anforderung, um die zusätzlichen Objekte abzurufen, die die GET
-Anforderung erfüllen.
Gehen Sie wie folgt vor, um zusätzlichen Objekte abzurufen, die die ursprüngliche GET Bucket versions
-Anforderung von einem Bucket erfüllen. Weitere Informationen zukey-marker
, version-id-marker
NextKeyMarker
NextVersionIdMarker
, und finden Sie GET
Bucketin der Amazon Simple Storage Service API Reference.
Im Folgenden finden Sie zusätzliche Antworten, die die ursprüngliche GET
-Anforderung erfüllen:
-
Setzen Sie den Wert von
key-marker
auf den Schlüssel, der inNextKeyMarker
in der vorherigen Antwort zurückgegeben wurde. -
Setzen Sie den Wert von
version-id-marker
auf die Versions-ID, die inNextVersionIdMarker
in der vorherigen Antwort zurückgegeben wurde. -
Senden Sie eine
GET Bucket versions
-Anforderung mitkey-marker
undversion-id-marker
.
Beispiel – Abrufen von Objekten ab einem bestimmten Schlüssel und einer bestimmten Versions-ID
GET /?versions&key-marker=myObject&version-id-marker=298459348571 HTTP/1.1 Host: bucket.s3.amazonaws.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
Der folgende Befehl gibt Metadaten zu allen Versionen der Objekte in einem Bucket zurück.
aws s3api list-object-versions --bucket
amzn-s3-demo-bucket1
Weitere Informationen zu list-object-versions
finden Sie unter list-object-versions in der AWS CLI -Befehlsreferenz.