Willkommen im neuen Amazon-S3-Benutzerhandbuch! Das Amazon-S3-Benutzerhandbuch kombiniert Informationen und Anweisungen aus den drei eingestellten Handbüchern: Amazon-S3-Entwicklerhandbuch, Benutzerhandbuch der Amazon-S3-Konsole und Amazon S3 – Handbuch Erste Schritte.
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, das 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 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-Managementkonsole 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 Versionierung zu aktivieren, wählen Sie unter Destination (Ziel) die Option Enable Bucket Versioning (Bucket-Versionierung 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.
-
Informationen zum Konfigurieren zusätzlicher Objekteigenschaften vor dem Hochladen finden Sie unter So konfigurieren Sie zusätzliche Objekteigenschaften.
So konfigurieren Sie zusätzliche Objekteigenschaften
-
Um zusätzliche Objekteigenschaften zu konfigurieren, wählen Sie Additional upload options (Zusätzliche Upload-Optionen) 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.
-
Wählen Sie Override default encryption bucket settings (Bucket-Einstellungen für die Standardverschlüsselung überschreiben) aus.
-
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 Schützen von Daten durch serverseitige Verschlüsselung mit von Amazon S3 verwalteten Verschlüsselungsschlüsseln (SSE-S3).
-
Um Ihre hochgeladenen Dateien mit dem AWS Key Management Service (AWS KMS) zu verschlüsseln, wählen Sie AWS Key Management Service key (SSE-KMS) (AWS KMS-Schlüssel) aus. Wählen Sie dann eine Option für den AWS KMS-Schlüssel aus.
-
Von AWS verwalteter Schlüssel (aws/s3) - Wählen Sie einen von AWS verwalteten CMK aus.
-
Wählen Sie aus Ihren KMS-Hauptschlüsseln aus - Wählen Sie einen kundenverwalteten CMK aus einer Liste von CMKs, die sich in derselben Region befinden wie Ihr Bucket, aus.
Weitere Informationen zum Erstellen eines von Kunden verwalteten AWS KMS-CMK finden Sie unter Erstellen von Schlüsseln im AWS Key Management Service-Entwicklerhandbuch. Weitere Informationen zum Schutz von Daten mit AWS KMS finden Sie unter Schutz von Daten mit serverseitiger Verschlüsselung mit in AWS Key Management Service (SSE-KMS) gespeicherten CMKs.
-
Geben Sie den KMS-Hauptschlüssel-ARN ein - Geben Sie den AWS KMS-Schlüssel-ARN für ein vom Kunden verwaltetes CMK ein und geben Sie den Amazon-Ressourcennamen (ARN) ein.
Sie können den KMS-Hauptschlüssel-ARN verwenden, um einem externen Konto die Möglichkeit zu geben, ein Objekt zu verwenden, das durch ein AWS KMS-CMK geschützt ist. Wählen Sie dazu Enter KMS master key ARN (KMS-Hauptschlü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 AWS KMS-CMK 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 CMKs verwenden, die in der selben AWS-Region wie der Bucket verfügbar sind.
-
-
-
Um die Berechtigungen für Zugriffskontrolllisten zu ändern, bearbeiten Sie die Berechtigungen unter Access control list (ACL) (Zugriffssteuerungsliste (ACL)).
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 allgemeinen Öffentlichkeit Lesezugriff auf Ihre Objekte erteilen, und zwar für alle Dateien, die Sie hochladen. Wir empfehlen, die Standardeinstellung für den öffentlichen Lesezugriff nicht zu ändern. Die Erteilung von öffentlichen Lesezugriff ist nur für wenige Anwendungsfälle sinnvoll, beispielsweise, wenn Buckets Websites verwendet werden. Nachdem Sie das Objekt hochgeladen haben, können Sie jederzeit Änderungen an den Objektberechtigungen vornehmen.
-
Um allen hochgeladenen Objekten Tags 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 Tags 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-Tags finden Sie unter Kategorisieren des Speichers mithilfe von Tags.
-
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.
Falls in Ihrer Anwendung erforderlich, können Sie AWS-Befehlszeilenschnittstellen(AWS CLI)-Anforderungen 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 in der AWS-CLI-Befehlsreferenz.