Herunterladen von Objekten

In diesem Abschnitt wird erläutert, wie Sie Objekte aus einem S3-Bucket herunterladen. Mit Amazon S3 können Sie diese Objekte in einem oder mehreren Buckets speichern. Jedes Objekt kann eine Größe von bis zu 5 TB haben. Der Zugriff auf Amazon-S3-Objekte, die nicht archiviert sind, ist in Echtzeit möglich. Archivierte Objekte müssen jedoch wiederhergestellt werden, bevor sie heruntergeladen werden können. Weitere Informationen zum Herunterladen von archivierten Objekten finden Sie unter Herunterladen von archivierten Objekten.

Sie können ein einzelnes Objekt mithilfe der Amazon S3 S3-Konsole herunterladen. AWS Command Line Interface (AWS CLI), AWS SDKsoder Amazon S3 RESTAPI. Verwenden Sie die S3-Konsole, um ein Objekt von S3 herunterzuladen, ohne Code schreiben oder Befehle ausführen zu müssen. Weitere Informationen finden Sie unter Herunterladen eines Objekts.

Um mehrere Objekte herunterzuladen, verwenden Sie AWS CloudShell, das AWS CLI, oder der AWS SDKs. Weitere Informationen finden Sie unter Herunterladen mehrerer Objekte.

Wenn Sie einen Teil eines Objekts herunterladen müssen, verwenden Sie zusätzliche Parameter mit AWS CLI oder REST API um nur die Bytes anzugeben, die Sie herunterladen möchten. Weitere Informationen finden Sie unter Herunterladen eines Teils eines Objekts.

Wenn Sie ein Objekt herunterladen müssen, das Sie nicht besitzen, bitten Sie den Objekteigentümer, ein vorsigniertes Objekt zu generierenURL, mit dem Sie das Objekt herunterladen können. Weitere Informationen finden Sie unter Ein Objekt von einem anderen herunterladen AWS-Konto.

Wenn Sie Objekte außerhalb von herunterladen AWS Netzwerk, Datenübertragungsgebühren fallen an. Datenübertragung innerhalb des AWS Das Netzwerk ist innerhalb desselben kostenlos AWS-Region, aber alle GET Anfragen werden Ihnen in Rechnung gestellt. Weitere Informationen zu den Gebühren für Datenübertragungen und Datenabrufe finden Sie unter Preise für Amazon S3.

Herunterladen eines Objekts

Sie können ein Objekt mithilfe der Amazon S3 S3-Konsole herunterladen. AWS CLI, AWS SDKs, oder RESTAPI.

Verwenden der S3-Konsole

In diesem Abschnitt erfahren Sie, wie Sie mit der Amazon-S3-Konsole ein Objekt aus einem S3-Bucket herunterladen.

Anmerkung

• Sie können jeweils nur ein Objekt herunterladen.

• Wenn Sie über die Amazon-S3-Konsole ein Objekt herunterladen, dessen Schlüsselname mit Punkt (.) endet, wird der Punkt aus dem Schlüsselnamen des heruntergeladenen Objekts entfernt. Um den Punkt am Ende des Namens des heruntergeladenen Objekts beizubehalten, müssen Sie den AWS Command Line Interface (AWS CLI), AWS SDKsoder Amazon S3 RESTAPI.

Ein Objekt von einem S3-Bucket herunterladen

1. Melden Sie sich an bei AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole unter https://console.aws.amazon.com/s3/.

2. Wählen Sie in der Liste Buckets den Namen des Buckets aus, aus dem Sie ein Objekt herunterladen möchten.

3. Sie können ein Objekt wie folgt aus einem S3-Bucket herunterladen:

   • Aktivieren Sie das Kontrollkästchen neben dem Objekt und wählen Sie Herunterladen. Wenn Sie das Objekt in einen spezifischen Ordner herunterladen möchten, wählen Sie im Menü Aktionen die Option Herunterladen als.

   • Wenn Sie eine spezifische Version des Objekts herunterladen möchten, aktivieren Sie die Schaltfläche Versionen anzeigen (neben dem Suchfeld). Aktivieren Sie das Kontrollkästchen neben der gewünschten Version des Objekts und wählen Sie Herunterladen. Wenn Sie das Objekt in einen spezifischen Ordner herunterladen möchten, wählen Sie im Menü Aktionen die Option Herunterladen als.

Verwendung der AWS CLI

Der folgende get-object Beispielbefehl zeigt, wie Sie den verwenden können AWS CLI um ein Objekt von Amazon S3 herunterzuladen. Mit diesem Befehl wird das Objekt folder/my_image aus dem Bucket amzn-s3-demo-bucket1 abgerufen. Das Objekt wird in eine Datei mit dem Namen my_downloaded_image heruntergeladen.

aws s3api get-object --bucket amzn-s3-demo-bucket1 --key folder/my_image my_downloaded_image

Weitere Informationen und Beispiele finden Sie unter get-object in der AWS CLI Befehlsreferenz.

Verwendung der AWS SDKs

Beispiele für das Herunterladen eines Objekts mit dem AWS SDKs, sieheVerwenden Sie GetObject mit einem AWS SDKoder CLI.

Allgemeine Informationen zur Verwendung verschiedener AWS SDKs, sieheEntwickeln mit Amazon S3 unter Verwendung der AWS SDKs.

Mit dem REST API

Sie können den verwenden RESTAPI, um Objekte aus Amazon S3 abzurufen. Weitere Informationen finden Sie unter GetObjectin der Amazon Simple Storage Service API Reference.

Herunterladen mehrerer Objekte

Sie können mehrere Objekte herunterladen, indem Sie AWS CloudShell, der AWS CLI, oder der AWS SDKs.

Die Verwendung von AWS CloudShell in der AWS Management Console

AWS CloudShell ist eine browserbasierte, vorauthentifizierte Shell, die Sie direkt von der AWS Management Console.

Weitere Informationen zur AWS CloudShell, siehe Was ist? CloudShell in der AWS CloudShell Benutzerleitfaden.

Wichtig

Mit AWS CloudShell, Ihr Home-Verzeichnis hat Speicherplatz von bis zu 1 GB pro AWS-Region. Daher können Sie Buckets nicht mit Objekten synchronisieren, deren Gesamtwert diesen Betrag übersteigt. Weitere Einschränkungen finden Sie unter Dienstkontingente und Einschränkungen im AWS CloudShell Benutzerleitfaden.

Um Objekte herunterzuladen, verwenden Sie AWS CloudShell

1. Melden Sie sich an bei AWS Management Console und öffnen Sie die CloudShell Konsole unter https://console.aws.amazon.com/cloudshell/.

2. Führen Sie den folgenden Befehl aus, um Objekte in Ihrem Bucket mit zu synchronisieren CloudShell. Der folgende Befehl synchronisiert Objekte aus dem Bucket mit dem Namen amzn-s3-demo-bucket1 und erstellt einen Ordner mit dem Namen temp in CloudShell. CloudShell synchronisiert Ihre Objekte mit diesem Ordner. Zur Verwendung dieses Befehls ersetzen Sie user input placeholders durch eigene Informationen.

   aws s3 sync s3://amzn-s3-demo-bucket1 ./temp

   Anmerkung

   Wenn Sie einen Musterabgleich durchführen möchten, um bestimmte Objekte aus- oder einzuschließen, können Sie die Parameter --exclude "value" und --include "value" mit dem sync-Befehl verwenden.

3. Führen Sie den folgenden Befehl aus, um Ihre Objekte im Ordner temp in eine Datei mit dem Namen temp.zip zu komprimieren.

   zip temp.zip -r temp/

4. Wählen Sie Aktionen und anschließend Datei herunterladen aus.

5. Geben Sie den Dateinamen temp.zip ein und wählen Sie anschließend Herunterladen aus.

6. (Optional) Löschen Sie die temp.zip Datei und die Objekte, die mit dem temp Ordner in synchronisiert wurden. CloudShell Mit AWS CloudShell, Sie haben persistenten Speicher von jeweils bis zu 1 GB AWS-Region.

   Sie können den folgenden Beispielbefehl verwenden, um die .zip-Datei und den Ordner zu löschen. Wenn Sie diesen Beispielbefehl verwenden möchten, ersetzen Sie user input placeholders durch Ihre Informationen.

   rm temp.zip && rm -rf temp/

Verwendung der AWS CLI

Das folgende Beispiel zeigt, wie Sie das verwenden können AWS CLI um alle Dateien oder Objekte unter dem angegebenen Verzeichnis oder Präfix herunterzuladen. Mit diesem Befehl werden alle Objekte aus dem Bucket amzn-s3-demo-bucket1 in Ihr aktuelles Verzeichnis kopiert. Wenn Sie diesen Beispielbefehl verwenden möchten, verwenden Sie anstelle von amzn-s3-demo-bucket1 den Namen Ihres Buckets.

aws s3 cp s3://amzn-s3-demo-bucket1 . --recursive

Mit dem folgenden Befehl werden alle Objekte unter dem Präfix logs im Bucket amzn-s3-demo-bucket1 in Ihr aktuelles Verzeichnis heruntergeladen. Darüber hinaus werden die Parameter --exclude und --include verwendet, damit nur Objekte mit dem Suffix .log kopiert werden. Wenn Sie diesen Beispielbefehl verwenden möchten, ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3 cp s3://amzn-s3-demo-bucket1/logs/ . --recursive --exclude "*" --include "*.log"

Weitere Informationen und Beispiele finden Sie unter cp in der AWS CLI Befehlsreferenz.

Verwendung der AWS SDKs

Beispiele für das Herunterladen aller Objekte in einem Amazon S3 S3-Bucket mit dem AWS SDKs, sieheHerunterladen aller Objekte aus einem Amazon Simple Storage Service (Amazon S3)-Bucket in ein lokales Verzeichnis.

Allgemeine Informationen zur Verwendung verschiedener AWS SDKs, sieheEntwickeln mit Amazon S3 unter Verwendung der AWS SDKs.

Herunterladen eines Teils eines Objekts

Sie können einen Teil eines Objekts herunterladen, indem Sie AWS CLI oder RESTAPI. Dazu geben Sie mithilfe zusätzlicher Parameter an, welcher Teil eines Objekts heruntergeladen werden soll.

Verwendung der AWS CLI

Der folgende Beispielbefehl führt eine GET-Anforderung für einen Bytebereich im Objekt folder/my_data im Bucket amzn-s3-demo-bucket1 aus. In der Anforderung muss dem Bytebereich das Präfix bytes= vorangestellt werden. Das Teilobjekt wird in die Ausgabedatei mit dem Namen my_data_range heruntergeladen. Wenn Sie diesen Beispielbefehl verwenden möchten, ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3api get-object --bucket amzn-s3-demo-bucket1 --key folder/my_data --range bytes=0-500 my_data_range

Weitere Informationen und Beispiele finden Sie unter get-object in der AWS CLI Befehlsreferenz.

Weitere Informationen zum HTTP Range Header finden Sie unter RFC9110 auf der RFC Editor-Website.

Anmerkung

Amazon S3 unterstützt nicht das Abrufen mehrerer Datenbereiche in einer einzelnen GET-Anforderung.

Unter Verwendung des REST API

Sie können die Range Parameter partNumber und in verwenden RESTAPI, um Objektteile aus Amazon S3 abzurufen. Weitere Informationen finden Sie unter GetObjectin der Amazon Simple Storage Service API Reference.

Ein Objekt von einem anderen herunterladen AWS-Konto

Sie können ein vorsigniertes Objekt verwendenURL, um anderen zeitlich begrenzten Zugriff auf Ihre Objekte zu gewähren, ohne Ihre Bucket-Richtlinie zu aktualisieren.

Das Vorsignierte URL kann in einem Browser eingegeben oder von einem Programm zum Herunterladen eines Objekts verwendet werden. Die von der verwendeten Anmeldeinformationen URL sind die von AWS Benutzer, der das generiert hatURL. Nachdem URL das erstellt wurde, URL kann jeder, der das vorsignierte Objekt besitzt, das entsprechende Objekt herunterladen, bis es URL abläuft.

Verwenden eines in der S3-Konsole URL vorsignierten

Sie können die Amazon S3 S3-Konsole verwenden, um ein Objekt zu generieren, das URL für die gemeinsame Nutzung vorsigniert ist, indem Sie die folgenden Schritte ausführen. Wenn Sie die Konsole verwenden, beträgt die maximale Ablaufzeit für ein vorsigniertes URL Objekt 12 Stunden ab dem Zeitpunkt der Erstellung.

Um mit der Amazon S3 S3-Konsole ein URL vorsigniertes zu generieren

1. Melden Sie sich an bei AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole unter https://console.aws.amazon.com/s3/.

2. Wählen Sie im linken Navigationsbereich Buckets aus.

3. Wählen Sie in der Bucket-Liste den Namen des Buckets aus, der das Objekt enthält, für das Sie eine URL Vorsignierung wünschen.

4. Wählen Sie in der Objektliste das Objekt aus, für das Sie ein URL vorsigniertes Objekt erstellen möchten.

5. Wählen Sie im Menü „Objektaktionen“ die Option „Mit einem URL vorsignierten Objekt teilen“.

6. Geben Sie an, wie lange das Vorsignierte gültig sein URL soll.

7. Wählen Sie „URLVorsigniertes erstellen“.

8. Wenn eine Bestätigungsmeldung angezeigt wird, wird diese automatisch in Ihre Zwischenablage kopiert. URL Sie werden eine Schaltfläche sehen, mit der Sie das Vorsignierte kopieren könnenURL, falls Sie es erneut kopieren müssen.

9. Um das Objekt herunterzuladen, fügen Sie es URL in einen beliebigen Browser ein. Das Objekt versucht dann, es herunterzuladen.

Weitere Hinweise zu vorsignierten URLs und anderen Methoden zu ihrer Erstellung finden Sie unterSie arbeiten mit vorsignierten URLs.

Herunterladen von archivierten Objekten

Sie können Objekte, auf die selten zugegriffen wird, archivieren, um Ihre Speicherkosten dafür zu senken. Wenn Sie ein Objekt archivieren, wird es in einen kostengünstigen Speicher verschoben. Sie können also nicht in Echtzeit darauf zugreifen. Wenn Sie ein archiviertes Objekt herunterladen möchten, müssen Sie es zunächst wiederherstellen.

Je nach Speicherklasse können archivierte Objekte innerhalb von Minuten oder Stunden wiederhergestellt werden. Sie können ein archiviertes Objekt mithilfe der Amazon S3-Konsole, S3 Batch Operations, Amazon S3 RESTAPI, der AWS SDKs, und die AWS Command Line Interface (AWS CLI).

Detaillierte Anweisungen finden Sie unter Wiederherstellen eines archivierten Objekts. Nachdem Sie das archivierte Objekt wiederhergestellt haben, können Sie es herunterladen.

Objekte auf der Grundlage von Metadaten herunterladen

Sie können Vorbedingungen hinzufügen, um ein Objekt anhand seiner Metadaten mithilfe einer bedingten Leseanforderung herunterzuladen. Sie können ein Objekt auf der Grundlage seines Entity-Tags (ETag) oder des Datums der letzten Änderung zurückgeben. Dies kann eine S3-Operation auf Objekte beschränken, die seit einem bestimmten Datum aktualisiert wurden, oder nur eine bestimmte Objektversion zurückgeben.

Sie können bedingte Schreibvorgänge verwenden für GetObject oder HeadObjectAnfragen.

Weitere Informationen zu bedingten Anfragen finden Sie unterFügen Sie Vorbedingungen zu S3-Vorgängen mit bedingten Anfragen hinzu.

Fehlerbehebung beim Herunterladen von Objekten

Unzureichende Berechtigungen oder falscher Bucket oder AWS Identity and Access Management (IAM) Benutzerrichtlinien können zu Fehlern führen, wenn Sie versuchen, Objekte von Amazon S3 herunterzuladen. Diese Probleme können häufig den Fehler Zugriff verweigert (403 Verboten) hervorrufen. Dies bedeutet, dass Amazon S3 den Zugriff auf eine Ressource nicht gewähren kann.

Weitere Informationen zu den häufigsten Ursachen für den Fehler Zugriff verweigert (403 Verboten) finden Sie unter Problembehandlung bei Zugriff verweigert (403 Forbidden) Fehler in Amazon S3.