Hochladen eines Objekts zu einem Verzeichnis-Bucket - Amazon Simple Storage Service

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.

Hochladen eines Objekts zu einem Verzeichnis-Bucket

Die Kopieroperation erzeugt eine Kopie eines Objekts, das bereits in Amazon S3 gespeichert ist. Sie können Objekte zwischen Verzeichnis-Buckets und Allzweck-Buckets kopieren. Sie können Objekte auch innerhalb eines Buckets und zwischen Buckets desselben Typs kopieren, z. B. von Verzeichnis-Bucket zu Verzeichnis-Bucket.

Sie können eine Kopie eines Objekts mit einer Größe von bis zu 5 GB in einem einzigen atomaren Vorgang erstellen. Um jedoch ein Objekt zu kopieren, das größer als 5 GB ist, müssen Sie die mehrteiligen Upload-API-Operationen verwenden. Weitere Informationen finden Sie unter Mehrteilige Uploads mit Verzeichnis-Buckets verwenden.

Berechtigungen

Um Objekte zu kopieren, müssen Sie über die folgenden Berechtigungen verfügen:

  • Um Objekte von einem Verzeichnis-Bucket zu einem anderen Verzeichnis-Bucket zu kopieren, benötigen Sie die s3express:CreateSession-Berechtigung.

  • Um Objekte aus Verzeichnis-Buckets zu Allzweck-Buckets zu kopieren, benötigen Sie die s3express:CreateSession-Berechtigung und s3:PutObject-Berechtigung zum Schreiben der Objektkopie in den Ziel-Bucket.

  • Um Objekte aus Allzweck-Buckets in Verzeichnis-Buckets zu kopieren, benötigen Sie die s3express:CreateSession Erlaubnis und s3:GetObject die Erlaubnis, das kopierte Quellobjekt zu lesen.

    Weitere Informationen finden Sie unter CopyObject in der API-Referenz zu Amazon Simple Storage Service.

Verschlüsselung

Amazon S3 verschlüsselt automatisch alle neuen Objekte, die in einen S3-Bucket hochgeladen werden. Die Standardverschlüsselungskonfiguration eines S3-Buckets ist immer aktiviert und mindestens auf serverseitige Verschlüsselung mit von Amazon S3 verwalteten Schlüsseln (SSE-S3) eingestellt.

Für Verzeichnis-Buckets wird nur SSE-S3 unterstützt. Für allgemeine Buckets können Sie SSE-S3 (Standard), serverseitige Verschlüsselung mit () -Schlüsseln (SSE-KMS), zweischichtige serverseitige Verschlüsselung mit AWS Key Management Service Schlüsseln (DSSE-KMS) oder serverseitige Verschlüsselung mit vom Kunden bereitgestellten AWS KMS Schlüsseln (SSE-C) verwenden.AWS KMS

Wenn Sie eine Kopieranforderung stellen, die die Parameter SSE-C, SSE-KMS oder DSSE-KMS für einen Verzeichnis-Bucket entweder als Quelle oder als Ziel festlegt, gibt die Antwort einen Fehler zurück.

Tags

Verzeichnis-Buckets unterstützen keine Tags. Wenn Sie ein Objekt mit Tags aus einem Allzweck-Bucket in einen Verzeichnis-Bucket kopieren, erhalten Sie eine HTTP-Antwort. 501 (Not Implemented) Weitere Informationen finden Sie unter CopyObject in der API-Referenz zu Amazon Simple Storage Service.

ETags

Entitäts-Tags (ETags) für S3 Express One Zone sind zufällige alphanumerische Zeichenfolgen und keine MD5-Prüfsummen. Verwenden Sie zusätzliche Prüfsummen, um die Objektintegrität sicherzustellen.

Zusätzliche Prüfsummen

S3 Express One Zone bietet Ihnen die Möglichkeit, den Prüfsummenalgorithmus auszuwählen, der zur Validierung Ihrer Daten beim Hoch- oder Herunterladen verwendet wird. Sie können einen der folgenden Secure Hash Algorithms (SHA)- oder Cyclic Redundancy Check (CRC)-Algorithmen zur Überprüfung der Datenintegrität auswählen: CRC32, CRC32C, SHA-1 und SHA-256. MD5-basierte Prüfsummen werden von der Speicherklasse S3 Express One Zone nicht unterstützt.

Weitere Informationen finden Sie unter Bewährte Methoden für zusätzliche S3-Prüfsummen.

Unterstützte Features

Weitere Informationen darüber, welche Amazon S3-Funktionen für S3 Express One Zone unterstützt werden, finden Sie unterWodurch zeichnet sich S3 Express One Zone aus?.

Um ein Objekt aus einem Allzweck-Bucket oder einem Verzeichnis-Bucket in einen Verzeichnis-Bucket zu kopieren

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

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

  3. Wählen Sie den Bucket aus, aus dem Sie Objekte kopieren möchten:

    • Um aus einem Allzweck-Bucket zu kopieren, wählen Sie die Registerkarte Allzweck-Buckets.

    • Um aus einem Verzeichnis-Bucket zu kopieren, wählen Sie den Tab Directory-Buckets.

  4. Wählen Sie den Allzweck-Bucket oder den Verzeichnis-Bucket, der die Objekte enthält, die Sie kopieren möchten.

  5. Wählen Sie dieObjekte-Tag. Aktivieren Sie auf der Seite Objekte das Kontrollkästchen links neben den Namen der Objekte, die Sie kopieren möchten.

  6. Wählen Sie im Menü Actions (Aktionen) die Option Copy (Kopieren) aus.

    Die Seite Kopieren wird angezeigt.

  7. Wählen Sie unter Ziel die Option Directory-Bucket für Ihren Zieltyp aus. Um den Zielpfad anzugeben, wählen Sie Browse S3 aus, navigieren Sie zum Ziel und wählen Sie dann das Optionsfeld links neben dem Ziel. Wählen Sie unten rechts Choose destination (Ziel auswählen) aus.

    Geben Sie alternativ den Zielpfad ein.

  8. Wählen Sie unter Prüfsummen aus, ob Sie die Objekte mit ihren vorhandenen Prüfsummenfunktionen kopieren oder die vorhandenen Prüfsummenfunktionen durch eine neue ersetzen möchten. Beim Hochladen der Objekte hatten Sie die Möglichkeit, den Prüfsummenalgorithmus anzugeben, der zur Überprüfung der Datenintegrität verwendet wurde. Beim Kopieren des Objekts haben Sie die Möglichkeit, eine neue Funktion auszuwählen. Wenn Sie ursprünglich keine zusätzliche Prüfsumme angegeben haben, können Sie den Abschnitt „Prüfsummen“ verwenden, um eine hinzuzufügen.

    Anmerkung

    Selbst wenn Sie dieselbe Prüfsummenfunktion verwenden, kann sich Ihr Prüfsummenwert ändern, wenn das Objekt größer als 16 MB ist. Der Prüfsummenwert kann sich aufgrund der Methode ändern, wie Prüfsummen für mehrteilige Uploads berechnet werden. Weitere Informationen dazu, wie sich die Prüfsumme beim Kopieren des Objekts ändern kann, finden Sie unter Verwenden von Prüfsummen auf Teilebene für mehrteilige Uploads.

    Um die Prüfsummenfunktion zu ändern, wählen Sie Replace with a new checksum function (Durch eine neue Prüfsummenfunktion ersetzen) aus. Wählen Sie die neue Prüfsummenfunktion aus der Drop-down-Liste aus. Wenn das Objekt kopiert wird, wird die neue Prüfsumme unter Verwendung des angegebenen Algorithmus berechnet und gespeichert.

  9. Wählen Sie unten rechts Copy (Kopieren) aus. Amazon S3 kopiert Ihre Objekte in den Zielordner.

So kopieren Sie ein Objekt aus einem Verzeichnis-Bucket in einen Allzweck-Bucket

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

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

  3. Wählen Sie den Tab Directory-Buckets.

  4. Wählen Sie den Verzeichnis-Bucket aus, der die Objekte enthält, die Sie kopieren möchten.

  5. Wählen Sie dieObjekte-Tag. Aktivieren Sie auf der Seite Objekte das Kontrollkästchen links neben den Namen der Objekte, die Sie kopieren möchten.

  6. Wählen Sie im Menü Actions (Aktionen) die Option Copy (Kopieren) aus.

  7. Wählen Sie unter Ziel die Option Allzweck-Bucket für Ihren Zieltyp aus. Um den Zielpfad anzugeben, wählen Sie Browse S3 aus, navigieren Sie zum Ziel und wählen Sie das Optionsfeld links neben dem Ziel. Wählen Sie unten rechts Choose destination (Ziel auswählen) aus.

    Geben Sie alternativ den Zielpfad ein.

  8. Wählen Sie unter Prüfsummen aus, ob Sie die Objekte mit ihren vorhandenen Prüfsummenfunktionen kopieren oder die vorhandenen Prüfsummenfunktionen durch eine neue ersetzen möchten. Beim Hochladen der Objekte hatten Sie die Möglichkeit, den Prüfsummenalgorithmus anzugeben, der zur Überprüfung der Datenintegrität verwendet wurde. Beim Kopieren des Objekts haben Sie die Möglichkeit, eine neue Funktion auszuwählen. Wenn Sie ursprünglich keine zusätzliche Prüfsumme angegeben haben, können Sie den Abschnitt Prüfsummen verwenden, um eine hinzuzufügen.

    Anmerkung

    Selbst wenn Sie dieselbe Prüfsummenfunktion verwenden, kann sich Ihr Prüfsummenwert ändern, wenn das Objekt größer als 16 MB ist. Der Prüfsummenwert kann sich aufgrund der Methode ändern, wie Prüfsummen für mehrteilige Uploads berechnet werden. Weitere Informationen dazu, wie sich die Prüfsumme beim Kopieren des Objekts ändern kann, finden Sie unter Verwenden von Prüfsummen auf Teilebene für mehrteilige Uploads.

    Um die Prüfsummenfunktion zu ändern, wählen Sie Replace with a new checksum function (Durch eine neue Prüfsummenfunktion ersetzen) aus. Wählen Sie die neue Prüfsummenfunktion aus der Drop-down-Liste aus. Wenn das Objekt kopiert wird, wird die neue Prüfsumme unter Verwendung des angegebenen Algorithmus berechnet und gespeichert.

  9. Wählen Sie unten rechts Copy (Kopieren) aus. Amazon S3 kopiert Ihre Objekte in den Zielordner.

SDK for Java 2.x
 public static void copyBucketObject (S3Client s3, String sourceBucket, String objectKey, String targetBucket) {
      CopyObjectRequest copyReq = CopyObjectRequest.builder()
          .sourceBucket(sourceBucket)
          .sourceKey(objectKey)
          .destinationBucket(targetBucket)
          .destinationKey(objectKey)
          .build();
       String temp = "";
                                             
       try {
           CopyObjectResponse copyRes = s3.copyObject(copyReq);
           System.out.println("Successfully copied " + objectKey +" from bucket " + sourceBucket +" into bucket "+targetBucket);
       }
       
       catch (S3Exception e) {
           System.err.println(e.awsErrorDetails().errorMessage());
           System.exit(1);
       }
 }

Der folgende copy-object Beispielbefehl zeigt, wie Sie mit dem AWS CLI ein Objekt von einem Bucket in einen anderen Bucket kopieren können. Sie können Objekte zwischen Bucket-Typen kopieren. Um diesen Befehl auszuführen, ersetzen Sie die Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

aws s3api copy-object --copy-source bucket SOURCE_BUCKET/SOURCE_KEY_NAME --key TARGET_KEY_NAME --bucket TARGET_BUCKET_NAME

Weitere Informationen finden Sie unter copy-object in der Referenz zum AWS CLI -Befehl.