Objekte hochladen
Wenn Sie eine Datei zu Amazon S3 hochladen, wird sie in einem S3-Objekt gespeichert. Objekte umfassen die Datei und die Metadaten, die das Objekt beschreiben. Ein Bucket kann eine unbegrenzte Anzahl von Objekten aufnehmen. Bevor Sie Dateien zu Amazon S3 hochladen können, benötigen Sie die Schreibberechtigungen für den Bucket. Weitere Informationen zu den Zugriffsberechtigungen finden Sie unter Identity and Access Management in Amazon S3.
Sie können beliebige Dateitypen – Bilder, Backups, Daten, Filme usw. – in einen S3-Bucket hochladen. Die maximale Größe einer Datei, die Sie über die Amazon-S3-Konsole hochladen können, ist 160 GB. Verwenden Sie zum Hochladen einer Datei mit mehr als 160 GB die AWS CLI, AWS-SDK oder die Amazon-S3-REST-API.
Wenn Sie ein Objekt mit einem Schlüsselnamen hochladen, der bereits in einem Bucket mit aktiviertem Versioning vorhanden ist, erstellt Amazon S3 eine weitere Version des Objekts, statt das vorhandene Objekt zu ersetzen. Weitere Informationen über Versioning finden Sie unter Verwenden der S3-Konsole.
Abhängig von der Größe der Daten, die Sie hochladen, bietet Amazon S3 die folgenden Optionen:
-
Hochladen eines Objekts in einer einzigen Operation über die AWS-SDKs, die REST-API oder die AWS CLI – Mit einer einzigen PUT-Operation können Sie ein einzelnes Objekt mit einer Größe von bis zu 5 GB hochladen.
-
Hochladen eines einzelnen Objekts mit der Amazon-S3-Konsole – Mit der Amazon-S3-Konsole können Sie ein einzelnes Objekt mit einer Größe von bis zu 160 GB hochladen.
-
Hochladen eines Objekts in Teilen über die AWS-SDKs, die REST-API oder die AWS CLI – Über die API für mehrteilige Uploads können Sie ein einzelnes großes Objekt mit einer Größe von bis zu 5 TB hochladen.
Die API für mehrteilige Uploads ist darauf ausgelegt, die Upload-Leistung für größere Objekte zu verbessern. Sie können ein Objekt in Teilen hochladen. Diese Objektteile können unabhängig, in jeder beliebigen Reihenfolge und parallel hochgeladen werden. Sie können einen mehrteiligen Upload verwenden, um Objekte mit einer Größe von 5 MB bis 5 TB hochzuladen. Weitere Informationen finden Sie unter Hochladen und Kopieren von Objekten mit mehrteiligen Uploads.
Beim Hochladen eines Objekts können Sie optional anfordern, dass Amazon S3 Ihr Objekt verschlüsselt, bevor es dieses auf einen Datenträger schreibt, und es wieder entschlüsselt, wenn Sie es herunterladen. Weitere Informationen finden Sie unter Datenschutz durch Verschlüsselung.
In diesem Verfahren wird erläutert, wie Sie Objekte und Ordner mithilfe der Konsole in einen S3-Bucket hochladen.
Wenn Sie ein Objekt hochladen, ist der Name des Objektschlüssels der Dateiname und etwaige optionale Präfixe. In der Amazon-S3-Konsole können Sie Ordner erstellen, um Ihre Objekte zu organisieren. In Amazon S3 werden Ordner als Präfixe dargestellt, die im Namen des Objektschlüssels angezeigt werden. Wenn Sie ein einzelnes Objekt in einen Ordner in der Amazon-S3-Konsole hochladen, wird der Ordnername im Namen des Objektschlüssels aufgenommen.
Wenn Sie beispielsweise ein Objekt mit dem Namen sample1.jpg
in einen Ordner namens backup
hochladen, lautet der Schlüsselname backup/sample1.jpg
. Allerdings wird das Objekt in der Konsole als sample1.jpg
im Ordner backup
angezeigt. Weitere Informationen zu Schlüsselnamen finden Sie unter Arbeiten mit Objekt-Metadaten.
Wenn Sie ein Objekt umbenennen oder eine der Eigenschaften in der Amazon-S3-Konsole ändern, z. B. Storage Class (Speicherklasse), Encryption (Verschlüsselung), Metadata (Metadaten), wird ein neues Objekt erstellt, das das alte ersetzt. Wenn S3-Versioning aktiviert ist, wird eine neue Version des Objekts erstellt, und das vorhandene Objekt wird zu einer älteren Version. Die Rolle, die die Eigenschaft ändert, wird auch Besitzer des neuen Objekts (oder der neuen Objektversion).
Wenn Sie einen Ordner hochladen, lädt Amazon S3 alle Dateien und Unterordner aus dem angegebenen Ordner in Ihren Bucket hoch. Es wird dann ein Objektschlüsselname zugewiesen, der eine Kombination aus dem hochgeladenen Dateinamen und dem Ordnernamen ist. Wenn Sie beispielweise einen Ordner mit dem Namen /images
hochladen, der zwei Dateien, sample1.jpg
und sample2.jpg
, enthält, lädt Amazon S3 die Dateien hoch und weist ihnen die jeweiligen Schlüsselnamen images/sample1.jpg
und images/sample2.jpg
zu. Der Schlüsselname enthält den Ordnernamen als Präfix. Die Amazon-S3-Konsole zeigt nur den Teil des Schlüsselnamens nach dem letzten /
an. Beispielsweise werden im Ordner "images" die Objekte images/sample1.jpg
und images/sample2.jpg
dann als sample1.jpg
und sample2.jpg
angezeigt.
So laden Sie Ordner und Dateien in einen S3-Bucket hoch
Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon-S3-Konsole unter https://console.aws.amazon.com/s3/
. -
Wählen Sie in der Liste Buckets den Namen des Buckets aus, in den Ihre Ordner oder Dateien hochgeladen werden sollen.
-
Klicken Sie auf Upload.
-
Führen Sie im Fenster Upload einen der folgenden Schritte aus:
-
Ziehen Sie Dateien und Ordner in das Fenster Upload (Hochladen) und legen Sie sie dort ab.
-
Wählen Sie Add file (Datei hinzufügen) oder Add folder (Ordner hinzufügen) aus, wählen Sie hochzuladende Dateien oder Ordner aus und wählen Sie dann Open (Öffnen) aus.
-
-
Um die Versioning zu aktivieren, wählen Sie unter Destination (Ziel) die Option Enable Bucket Versioning (Bucket-Versioning aktivieren) aus.
-
Um die aufgelisteten Dateien und Ordner hochzuladen, ohne zusätzliche Upload-Optionen zu konfigurieren, wählen Sie unten auf der Seite Upload aus.
Amazon S3 lädt Ihre Objekte und Ordner hoch. Wenn der Upload abgeschlossen ist, wird auf der Seite Upload: status eine Erfolgsmeldung angezeigt.
So konfigurieren Sie zusätzliche Objekteigenschaften
-
Um Zugriffssteuerungslisten-Berechtigungen zu ändern, wählen Sie Permissions (Berechtigungen) aus.
-
Bearbeiten Sie die Berechtigungen unter Access control list (ACL) (Zugriffssteuerungsliste).
Weitere Informationen zu den Zugriffsberechtigungen für Objekte finden Sie unter Festlegen von ACL-Berechtigungen für ein Objekt mit der S3-Konsole. Sie können der Öffentlichkeit Lesezugriff auf Ihre Objekte erteilen, und zwar für alle Dateien, die Sie hochladen. Wir empfehlen allerdings, die Standardeinstellung für den öffentlichen Lesezugriff nicht zu ändern. Die Erteilung von öffentlichem Lesezugriff ist nur für wenige Anwendungsfälle sinnvoll, beispielsweise, wenn Buckets für Websites verwendet werden. Nachdem Sie das Objekt hochgeladen haben, können Sie jederzeit Änderungen an den Objektberechtigungen vornehmen.
-
Um andere zusätzliche Eigenschaften zu konfigurieren, wählen Sie Properties (Eigenschaften) aus.
-
Wählen Sie im Abschnitt Storage class (Speicherklasse) die Speicherklasse für die Dateien aus die Sie hochladen.
Weitere Informationen über Speicherklassen finden Sie unter Verwenden von Amazon-S3-Speicherklassen.
-
Um die Verschlüsselungseinstellungen für Ihre Objekte zu aktualisieren, gehen Sie unter Server-side encryption settings (Serverseitige Verschlüsselungseinstellungen) wie folgt vor.
-
Klicken Sie auf Specify an encryption key (Verschlüsselungsschlüssel angeben).
-
Um die hochgeladenen Dateien mit Schlüsseln zu verschlüsseln, die von Amazon S3 verwaltet werden, wählen Sie Amazon S3 key (SSE-S3) (Amazon-S3-Schlüssel) aus.
Weitere Informationen finden Sie unter Verwenden von serverseitiger Verschlüsselung mit von Amazon S3 verwalteten Verschlüsselungsschlüsseln (SSE-S3).
-
Um die hochgeladenen Dateien mit dem AWS Key Management Service (AWS KMS) zu verschlüsseln, wählen Sie den AWS Key Management Service-Schlüssel (SSE-KMS). Wählen Sie dann eine Option für den AWS KMS-Schlüssel.
-
AWS-verwalteter Schlüssel – Wählen Sie einen AWS-verwalteten Schlüssel aus.
-
Wählen Sie aus Ihren KMS-Root-Schlüsseln aus - Wählen Sie einen kundenverwalteten Schlüssel aus einer Liste von KMS-Schlüsseln aus, die sich in derselben Region befinden wie Ihr Bucket.
Weitere Informationen zum Erstellen eines vom Kunden verwalteten Schlüssels finden Sie unter Creating Keys (Erstellen von Schlüsseln) im AWS Key Management Service-Entwicklerhandbuch. Weitere Informationen zum Schutz von Daten mit AWS KMS finden Sie unter Verwenden von serverseitiger Verschlüsselung mit AWS Key Management Service (SSE-KMS).
-
Geben Sie den KMS-Root-Schlüssel-ARN ein – Geben Sie den AWS KMS-Schlüssel-ARN für einen vom Kunden verwalteten Schlüssel an und geben Sie den Amazon-Ressourcennamen (ARN) ein.
Sie können den KMS-Root-Schlüssel-ARN verwenden, um einem externen Konto die Möglichkeit zu geben, ein Objekt zu verwenden, das durch ein AWS KMS key geschützt ist. Wählen Sie dazu Enter KMS root key ARN (KMS-Root-Schlüssel-ARN eingeben) aus und geben Sie den Amazon-Ressourcennamen (ARN) für das externe Konto ein. Administratoren eines externen Kontos, die über Nutzungsrechte für ein durch Ihren KMS-Schlüssel geschütztes Objekt verfügen, können den Zugriff durch die Erstellung einer IAM-Richtlinie auf Ressourcenebene weiter einschränken.
Anmerkung Um Objekte in einem Bucket zu verschlüsseln, können Sie nur AWS KMS keys verwenden, die in der selben AWS-Region wie der Bucket verfügbar sind.
-
-
-
Wählen Sie On (Ein) aus, um zusätzliche Prüfsummen zu verwenden. Wählen Sie dann für Checksum function (Prüfsummenfunktion) die Funktion aus, die Sie verwenden möchten. Amazon S3 berechnet und speichert den Prüfsummenwert, nachdem es das gesamte Objekt erhalten hat. Sie können das Feld Precalculated value (Vorberechneter Wert) verwenden, um einen vorberechneten Wert anzugeben. In diesem Fall vergleicht Amazon S3 den von Ihnen angegebenen Wert mit dem eigenen berechneten Wert. Wenn die beiden Werte nicht übereinstimmen, generiert Amazon S3 einen Fehler.
Mit zusätzlichen Prüfsummen können Sie den Prüfsummenalgorithmus angeben, den Sie zur Überprüfung Ihrer Daten verwenden möchten. Weitere Informationen zu zusätzlichen Prüfsummen finden Sie unter Überprüfung der Objektintegrität.
-
Um allen hochgeladenen Objekten Markierungen hinzuzufügen, wählen Sie Add tag (Tag hinzufügen). Geben Sie einen Tag-Namen in das Feld Key (Schlüssel) ein. Geben Sie einen Wert für das Tag ein.
Das Markieren von Objekten ermöglicht Ihnen, Speicher zu kategorisieren. Jeder Tag ist ein Schlüssel/Wert-Paar. Bei Schlüssel- und Tag-Werten wird die Groß-/Kleinschreibung berücksichtigt. Sie können über bis zu 10 Markierungen pro Objekt verfügen. Ein Tag-Schlüssel kann maximal 128 Unicode-Zeichen lang sein, und die Tag-Werte können bis zu 255 Unicode-Zeichen lang sein. Weitere Informationen über Objekt-Markierungen finden Sie unter Kategorisieren des Speichers mithilfe von Markierungen.
-
Um Metadaten hinzuzufügen, wählen Sie Add metadata (Metadaten hinzufügen).
-
Wählen Sie unter Typdie Option System defined (System definiert) oder User defined (Benutzerdefiniert) aus.
Für systemdefinierte Metadaten können Sie gemeinsame HTTP-Header wie Content-Type und Content-Disposition auswählen. Eine Liste systemdefinierter Metadaten und Informationen dazu, ob Sie Werte hinzufügen können, finden Sie unter Systemdefinierte Objektmetadaten. Metadaten, die mit dem Präfix
x-amz-meta-
beginnen, werden als benutzerdefinierte Metadaten behandelt. Benutzerdefinierte-Metadaten werden mit dem Objekt gespeichert und beim Download mit ihm zurückgegeben. Sowohl die Schlüssel als auch deren Werte müssen US-ASCII-Standards entsprechen. Benutzerdefinierte Metadaten können bis zu 2 KB umfassen. Weitere Informationen zu systemdefinierten und benutzerdefinierten Metadaten finden Sie unter Arbeiten mit Objekt-Metadaten. -
Wählen Sie für Key einen Schlüssel aus.
-
Geben Sie einen Wert für den Schlüssel ein.
-
-
Um Ihre Objekte hochzuladen, wählen Sie Upload (Hochladen) aus.
Amazon S3 lädt Ihr Objekt hoch. Wenn der Upload abgeschlossen ist, wird auf der Seite Upload: status eine Erfolgsmeldung angezeigt.
-
Wählen Sie Exit (Beenden) aus.
Sie können das AWS-SDK verwenden, um Objekte in Amazon S3 hochzuladen. Das SDK bietet Ihnen Wrapper-Bibliotheken für den einfachen Upload von Daten an. Weitere Informationen finden Sie in der Liste der unterstützten SDKs.
Hier sind ein paar Beispiele mit einigen ausgewählten SDKs:
Sie können REST-Anfragen senden, um ein Objekt hochzuladen. Sie können eine PUT-Anforderung senden, um Daten in einer einzigen Operation hochzuladen. Weitere Informationen finden Sie unter PUT Object.
Sie können eine PUT
-Anforderung zum Hochladen eines Objekts von bis zu 5 GB in einem einzigen Vorgang senden. Weitere Informationen finden Sie im PutObject
-Beispiel in der AWS CLI-Befehlsreferenz.