Erste Schritte mit Amazon S3 mit AWS CLI

Erstellen Sie ein Quell-Bundle mit dem Befehl s3api create-bucket. amzn-s3-demo-bucketErsetzen Sie es durch einen eindeutigen Bucket-Namen und us-east-1 durch Ihre gewünschte Region:

aws s3api create-bucket --bucket amzn-s3-demo-bucket --region us-east-1

Für andere Regionen als us-east-1 müssen Sie die Standortbeschränkung angeben:

aws s3api create-bucket --bucket amzn-s3-demo-bucket --region us-west-2 --create-bucket-configuration LocationConstraint=us-west-2

Stellen Sie sicher, dass Ihr Bucket erstellt wurde, indem Sie alle Buckets auflisten:

aws s3 ls

Für die Objekteigentümerschaft können Sie ACLs deaktivieren oder aktivieren und die Eigentümerschaft von Objekten steuern, die in Ihren Bucket hochgeladen werden.

Deaktivierte ACLs

Bucket-Eigentümer als erzwungen festlegen (Standard) – ACLs sind deaktiviert und der Bucket-Eigentümer besitzt automatisch jedes Objekt im Allzweck-Bucket und hat die volle Kontrolle darüber.

aws s3api put-bucket-ownership-controls --bucket amzn-s3-demo-bucket --ownership-controls="Rules=[{ObjectOwnership=BucketOwnerEnforced}]"

Aktivierte ACLs

So überprüfen Sie die aktuelle Einstellung „Objekteigentum“ für Ihren Bucket:

aws s3api get-bucket-ownership-controls --bucket amzn-s3-demo-bucket

So überprüfen Sie, ob Block Public Access aktiviert ist (für neue Buckets ist diese Option standardmäßig aktiviert):

aws s3api get-public-access-block --bucket amzn-s3-demo-bucket

Die vier Einstellungen Blockieren jeglichen öffentlichen Zugriffs sind für neue Buckets standardmäßig aktiviert. Es wird empfohlen, alle Einstellungen aktiviert zu lassen, es sei denn, Sie wissen, dass Sie eine oder mehrere dieser Einstellungen für Ihren Anwendungsfall deaktivieren müssen. Weitere Informationen zum Blockieren des öffentlichen Zugriffs finden Sie unter Blockieren des öffentlichen Zugriffs auf Ihren Amazon-S3-Speicher.

Wenn Sie Block Public Access aktivieren müssen, verwenden Sie den folgenden Befehl:

aws s3api put-public-access-block --bucket amzn-s3-demo-bucket --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"

So aktivieren Sie die Versionsverwaltung für Ihren Bucket:

aws s3api put-bucket-versioning --bucket amzn-s3-demo-bucket --versioning-configuration Status=Enabled

Für einen neuen Bucket ist die Versionsverwaltung standardmäßig deaktiviert. Das Versioning ermöglicht Ihnen, mehrere Versionen eines Objekts im selben Bucket aufzubewahren. Sie können Versioning verwenden, um sämtliche Versionen aller Objekte in Ihrem Bucket zu speichern, abzurufen oder wiederherzustellen. Daten lassen sich dank Versioning nach unbeabsichtigten Benutzeraktionen und Anwendungsfehlern leichter wiederherstellen. Weitere Informationen über das Versioning finden Sie unter Beibehalten mehrerer Versionen von Objekten mit der S3-Versionsverwaltung.

Amazon S3 Object Lock schützt neue Objekte vor dem Löschen oder Überschreiben. Weitere Informationen finden Sie unter Sperren von Objekten mit Object Lock. Um zu aktivieren Sperren von Objekten mit Object Lock (erfordert Bucket-Versionsverwaltung):

Für einen neuen Bucket:

aws s3api create-bucket --bucket amzn-s3-demo-bucket --region us-east-1 --object-lock-enabled-for-bucket

Für einen vorhandenen Bucket:

aws s3api put-object-lock-configuration --bucket amzn-s3-demo-bucket --object-lock-configuration '{"ObjectLockEnabled": "Enabled"}'

Wenn Sie Sperren von Objekten mit Object Lock neben der Aktivierung von Object Lock auch einen Standard festlegen möchten, können Sie Folgendes verwenden:

aws s3api put-object-lock-configuration --bucket amzn-s3-demo-bucket --object-lock-configuration '{"ObjectLockEnabled":"Enabled","Rule":{"DefaultRetention":{"Mode":"COMPLIANCE","Days":30}}}'

Sie können ihn "COMPLIANCE" durch "GOVERNANCE" einen weniger restriktiven Modus ersetzen und die Anzahl der Tage nach Bedarf anpassen.

Sie können Ihrem Bucket Tags hinzufügen. Mit der AWS-Kostenzuordnung können Sie Bucket-Tags verwenden, um Kommentare zur Rechnungsstellung für Ihre Verwendung eines Buckets anzubringen. Ein Tag ist ein Schlüssel-Wert-Paar, das eine Bezeichnung repräsentiert, die Sie einem Bucket zuweisen. Weitere Informationen finden Sie unter Verwenden von Kostenzuordnungs-Markierungen für S3-Buckets.

So fügen Sie Ihrem Bucket Tags hinzu:

aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging 'TagSet=[{Key=Purpose,Value=Testing},{Key=Environment,Value=Development}]'

Buckets und neue Objekte werden mit serverseitiger Verschlüsselung verschlüsselt. Dabei sind von Amazon S3 verwaltete Schlüssel (SSE-S3) die Grundebene der Verschlüsselungskonfiguration. Verwenden Sie den folgenden Befehl, um die Standardverschlüsselung Ihres Buckets zu überprüfen:

aws s3api get-bucket-encryption --bucket amzn-s3-demo-bucket

Sie können auch serverseitige Verschlüsselung mit AWS KMS Schlüsseln (SSE-KMS) und serverseitige Dual-Layer-Verschlüsselung mit AWS KMS Schlüsseln (DSSE-KMS) für Ihren Bucket konfigurieren. Sowohl der AWS-verwaltete Schlüssel (aws/s3) als auch Ihre kundenseitig verwalteten Schlüssel können als AWS KMS-Schlüssel für SSE-KMS- und DSSE-KMS-Verschlüsselungskonfiguration verwendet werden. Weitere Informationen über vom Kunden verwaltete Schlüssel finden Sie unter Kundenschlüssel und AWS-Schlüssel im Entwicklerhandbuch zu AWS Key Management Service. Weitere Informationen zum Erstellen von AWS KMS-Schlüsseln finden Sie unter Erstellen von Schlüsseln im AWS Key Management Service-Entwicklerhandbuch.

Wenn Sie Ihren Bucket für die Verwendung der Standardverschlüsselung mit SSE-KMS konfigurieren, können Sie auch Amazon S3-Bucket-Schlüssel aktivieren. Amazon S3-Bucket-Schlüssel verringern den Anforderungsverkehr von Amazon S3 zu AWS KMS und senken die Verschlüsselungskosten. Weitere Informationen finden Sie unter Reduzieren des Preises von SSE-KMS mit Amazon-S3-Bucket-Schlüsseln. Amazon S3-Bucket-Schlüssel werden für DSSE-KMS nicht unterstützt. In der AWS CLI sind Amazon S3-Bucket-Schlüssel NICHT standardmäßig aktiviert, wenn ein neuer Bucket erstellt wird. Dies unterscheidet sich vom Verhalten der Konsole, bei dem sie standardmäßig aktiviert sind.

So konfigurieren SSE-KMS und aktivieren Sie die Amazon S3-Bucket-Schlüssel:

aws s3api put-bucket-encryption --bucket amzn-s3-demo-bucket --server-side-encryption-configuration "{\"Rules\":[{\"ApplyServerSideEncryptionByDefault\":{\"SSEAlgorithm\":\"aws:kms\",\"KMSMasterKeyID\":\"YOUR-KMS-KEY-ARN\"},\"BucketKeyEnabled\":true}]}"

Um zu überprüfen, ob Amazon S3-Bucket-Schlüssel für einen Bucket aktiviert sind:

aws s3api get-bucket-encryption --bucket amzn-s3-demo-bucket

Die Ausgabe wird ein BucketKeyEnabled Feld enthalten, das entweder auf true oder gesetzt istfalse.

Um DSSE-KMS zu konfigurieren, verwenden Sie folgenden Befehl:

aws s3api put-bucket-encryption --bucket amzn-s3-demo-bucket --server-side-encryption-configuration '{"Rules":[{"ApplyServerSideEncryptionByDefault":{"SSEAlgorithm":"aws:kms:dsse","KMSMasterKeyID":"YOUR-KMS-KEY-ARN"}}]}'

Weitere Informationen zur Standard-Verschlüsselung finden Sie unter Einstellen des Verhaltens der serverseitigen Verschlüsselung für Amazon S3-Buckets. Weitere Informationen zu SSE-S3 finden Sie unter Verwenden serverseitiger Verschlüsselung mit von Amazon S3 verwalteten Schlüsseln (SSE-S3).

Erstellen Sie eine einfache Textdatei: Sie können einen beliebigen Texteditor verwenden oder den folgenden Befehl ausführen:

echo 'Hello, Amazon S3!' > example.txt

Laden Sie die Datei mit dem Befehl s3 cp in Ihren Bucket hoch:

aws s3 cp example.txt s3://amzn-s3-demo-bucket/

Wenn der Upload erfolgreich ausgeführt wurde, sehen Sie eine Ausgabe ähnlich der Folgenden:

upload: ./example.txt to s3://amzn-s3-demo-bucket/example.txt

Stellen Sie sicher, dass das Objekt hochgeladen wurde, indem Sie den Inhalt Ihres Buckets auflisten:

aws s3 ls s3://amzn-s3-demo-bucket/

So erhalten Sie Informationen zu Ihrem Objekt:

aws s3api head-object --bucket amzn-s3-demo-bucket --key example.txt

Dieser Befehl gibt Metadaten über das Objekt zurück, einschließlich seines Inhaltstyps, seiner Inhaltslänge und des Datums der letzten Änderung.

Laden Sie das Objekt auf Ihren lokalen Computer herunter:

aws s3 cp s3://amzn-s3-demo-bucket/example.txt downloaded-example.txt

Wenn der Download erfolgreich ausgeführt wurde, wird eine Ausgabe ähnlich der Folgenden angezeigt:

download: s3://amzn-s3-demo-bucket/example.txt to ./downloaded-example.txt

Überprüfen des Inhalts der heruntergeladenen Datei:

cat downloaded-example.txt

In Amazon S3 werden Ordner als Präfixe dargestellt, die im Namen des Objektschlüssels angezeigt werden. Erstellen Sie einen „Ordner“, indem Sie ein Objekt mit einem Präfix kopieren:

aws s3 cp s3://amzn-s3-demo-source-bucket/example.txt s3://amzn-s3-demo-destination-bucket/favorite-files/example.txt

Wenn der Kopiervorgang erfolgreich ausgeführt wurde, wird eine Ausgabe ähnlich der Folgenden angezeigt:

copy: s3://amzn-s3-demo-source-bucket/example.txt to s3://amzn-s3-demo-destination-bucket/favorite-files/example.txt

Stellen Sie sicher, dass das Objekt kopiert wurde, indem Sie den Inhalt des Ordners auflisten:

aws s3 ls s3://amzn-s3-demo-destination-bucket/favorite-files/

Option 1: Verwenden Sie für kleinere Buckets den rm Befehl mit dem --recursive Flag, um alle Objekte im Bucket zu löschen:

aws s3 rm s3://amzn-s3-demo-bucket --recursive

Dieser Befehl löscht alle Objekte im Bucket, einschließlich der Objekte in Ordnern.

Option 2: Verwenden Sie die Amazon S3-Lebenszyklusregeln (empfohlen für große Buckets)

Verwenden Sie für Buckets mit vielen Objekten oder großen Objekten eine Amazon S3-Lebenszyklusregel, um alle Objekte automatisch ablaufen zu lassen und zu löschen. Warten Sie, bis die Lebenszyklusregel verarbeitet wurde (dies kann bis zu 24 Stunden dauern). Weitere Informationen finden Sie unter Wie leere ich einen Amazon-S3-Bucket mithilfe einer Lebenszykluskonfigurationsregel?.

Stellen Sie sicher, dass der Bucket leer ist:

aws s3 ls s3://amzn-s3-demo-bucket

Wenn für Ihren Bucket die Versionsverwaltung aktiviert ist, verwenden Sie die folgenden Befehle, um versionierte Objekte und Markierungen zu löschen.

Versionierte Objekte entfernen:

aws s3api delete-objects --bucket amzn-s3-demo-bucket --delete "$(aws s3api list-object-versions --bucket amzn-s3-demo-bucket --output json --query='{Objects: Versions[].{Key:Key,VersionId:VersionId}}')"

So entfernen Sie Löschmarkierungen:

aws s3api delete-objects --bucket amzn-s3-demo-bucket --delete "$(aws s3api list-object-versions --bucket amzn-s3-demo-bucket --output json --query='{Objects: DeleteMarkers[].{Key:Key,VersionId:VersionId}}')"

Stellen Sie sicher, dass der Bucket keine Objektversionen enthält, und löschen Sie die Markierungen:

aws s3api list-object-versions --bucket amzn-s3-demo-bucket

In der Ausgabe sollten keine Versionen oder verbleibenden Löschmarkierungen angezeigt werden.

Löschen Ihren Bucket:

aws s3api delete-bucket --bucket amzn-s3-demo-bucket

Stellen Sie sicher, dass der Bucket gelöscht wurde, indem Sie alle Ihre Buckets auflisten:

aws s3 ls