Kopieren von Objekten von oder 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.

Kopieren von Objekten von oder 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.

Anmerkung

Das Kopieren von Objekten zwischen verschiedenen Objekten wird AWS-Regionen nicht unterstützt, wenn sich der Quell- oder Ziel-Bucket in einer AWS lokalen Zone befindet. Die Quell- und Ziel-Buckets müssen dieselbe übergeordnete AWS-Region haben. Die Quell- und Ziel-Buckets können unterschiedliche Bucket-Speicherorttypen haben (Availability Zone oder Local Zone).

Sie können eine Kopie Ihres Objekts mit einer Größe von bis zu 5 GB in einer einzigen atomaren Operation hochladen. Um jedoch ein Objekt zu kopieren, das größer als 5 GB ist, müssen Sie die API-Operationen für mehrteilige Uploads verwenden. Weitere Informationen finden Sie unter Verwenden von mehrteiligen Uploads mit Verzeichnis-Buckets.

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 zu Verzeichnis-Buckets zu kopieren, benötigen Sie die s3express:CreateSession-Berechtigung und s3:GetObject-Berechtigung zum Lesen des Quellobjekts, das kopiert wird.

    Weitere Informationen finden Sie unter CopyObjectin der Amazon Simple Storage Service API-Referenz.

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 werden SSE-S3 und serverseitige Verschlüsselung mit AWS Key Management Service (AWS KMS) -Schlüsseln (SSE-KMS) unterstützt. Wenn es sich bei dem Ziel-Bucket um einen Verzeichnis-Bucket handelt, empfehlen wir, dass die Standardverschlüsselung des Ziel-Buckets die gewünschte Verschlüsselungskonfiguration verwendet und Sie die Standardverschlüsselung des Buckets nicht überschreiben. Anschließend werden neue Objekte automatisch mit den gewünschten Verschlüsselungseinstellungen verschlüsselt. Außerdem werden S3-Bucket-Keys nicht unterstützt, wenn Sie mit SSE-KMS verschlüsselte Objekte von Allzweck-Buckets in Verzeichnis-Buckets, von Verzeichnis-Buckets in Allzweck-Buckets oder zwischen Verzeichnis-Buckets kopieren, bis CopyObject. In diesem Fall ruft Amazon S3 AWS KMS jedes Mal, wenn eine Kopieranforderung für ein KMS-verschlüsseltes Objekt gestellt wird, auf. Weitere Informationen zum Verhalten beim Überschreiben der Verschlüsselung in Verzeichnis-Buckets finden Sie unter Serverseitige Verschlüsselung mit AWS KMS für Uploads neuer Objekte angeben.

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 angibt, DSSE-KMS oder SSE-C für einen Verzeichnis-Bucket (entweder den Quell- oder den Ziel-Bucket) zu verwenden, gibt die Antwort einen Fehler zurück.

Tags

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

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 Algorithmen zur Prüfung der Datenintegrität mit Secure Hash Algorithms (SHA) oder Cyclic Redundancy Check (CRC) auswählen: CRC32 C CRC32, SHA-1 und SHA-256. MD5basierte Prüfsummen werden von der S3 Express One Zone-Speicherklasse 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 unter Unterschiede bei Verzeichnis-Buckets.

Anmerkung

Die Einschränkungen beim Kopieren eines Objekts in einen Verzeichnis-Bucket mit der Konsole sind folgende:

  • Die Copy-Aktion gilt für alle Objekte in den angegebenen Ordnern (Präfixe). Objekte, die während der laufenden Aktion in diese Ordner hinzugefügt werden, könnten betroffen sein.

  • Objekte, die mit vom Kunden bereitgestellten Verschlüsselungsschlüsseln (SSE-C) verschlüsselt wurden, können nicht mit der S3-Konsole kopiert werden. Verwenden Sie das AWS SDK oder die Amazon S3 S3-REST-API AWS CLI, um mit SSE-C verschlüsselte Objekte zu kopieren.

  • Bei kopierten Objekten werden die Object-Lock-Einstellungen der Originalobjekte nicht beibehalten.

  • Wenn der Bucket, aus dem Sie Objekte kopieren, die vom Bucket-Besitzer erzwungene Einstellung für S3 Object Ownership verwendet, ACLs wird das Objekt nicht an das angegebene Ziel kopiert.

  • Wenn Sie Objekte in einen Bucket kopieren möchten, der die vom Bucket-Besitzer erzwungene Einstellung für S3 Object Ownership verwendet, stellen Sie sicher, dass der Quell-Bucket auch die erzwungene Einstellung des Bucket-Besitzers verwendet, oder entfernen Sie alle Objekt-ACL-Zuweisungen an andere AWS Konten und Gruppen.

  • Objekte, die aus einem Allzweck-Bucket in einen Verzeichnis-Bucket kopiert wurden, ACLs behalten keine Objekt-Tags oder Etag-Werte bei. Prüfsummenwerte können kopiert werden, entsprechen aber nicht einem Etag. Der Prüfsummenwert kann sich im Vergleich zu dem Zeitpunkt, zu dem er hinzugefügt wurde, ändern.

  • Alle Objekte, die in einen Verzeichnis-Bucket kopiert werden, unterliegen der vom Bucket-Eigentümer erzwungenen Einstellung für S3 Object Ownership.

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

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

  2. Im linken Navigationsbereich der Bucket-Typ, 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 die Registerkarte Verzeichnis-Buckets.

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

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

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

    Die Seite Kopieren wird angezeigt.

  6. Wählen Sie unter Ziel den Verzeichnis-Bucket für Ihren Zieltyp aus. Um den Zielpfad anzugeben, wählen Sie S3 durchsuchen aus, navigieren Sie zum Ziel und markieren Sie das Kontrollkästchen links von dem Ziel. Wählen Sie unten rechts Choose destination (Ziel auswählen) aus.

    Geben Sie alternativ den Zielpfad ein.

  7. Wählen Sie unter Zusätzliche Kopiereinstellungen aus, ob Sie Quelleinstellungen kopieren, Keine Einstellungen angeben oder Einstellungen angeben möchten. Quelleinstellungen kopieren ist die Standardoption. Wenn Sie das Objekt nur ohne die Quelleinstellungsattribute kopieren möchten, wählen Sie Keine Einstellungen angeben aus. Wählen Sie Einstellungen angeben aus, um Einstellungen für serverseitige Verschlüsselung, Prüfsummen und Metadaten anzugeben.

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

Anmerkung

Beim Kopieren eines Objekts in einen Allzweck-Bucket mit der Konsole gelten folgende Einschränkungen:

  • Die Copy-Aktion gilt für alle Objekte in den angegebenen Ordnern (Präfixe). Objekte, die während der laufenden Aktion in diese Ordner hinzugefügt werden, könnten betroffen sein.

  • Objekte, die mit vom Kunden bereitgestellten Verschlüsselungsschlüsseln (SSE-C) verschlüsselt wurden, können nicht mit der S3-Konsole kopiert werden. Verwenden Sie das AWS SDK oder die Amazon S3 S3-REST-API AWS CLI, um mit SSE-C verschlüsselte Objekte zu kopieren.

  • Bei kopierten Objekten werden die Object-Lock-Einstellungen der Originalobjekte nicht beibehalten.

  • Wenn der Bucket, aus dem Sie Objekte kopieren, die vom Bucket-Besitzer erzwungene Einstellung für S3 Object Ownership verwendet, ACLs wird das Objekt nicht an das angegebene Ziel kopiert.

  • Wenn Sie Objekte in einen Bucket kopieren möchten, der die vom Bucket-Besitzer erzwungene Einstellung für S3 Object Ownership verwendet, stellen Sie sicher, dass der Quell-Bucket auch die erzwungene Einstellung des Bucket-Besitzers verwendet, oder entfernen Sie alle Objekt-ACL-Zuweisungen an andere AWS Konten und Gruppen.

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

  1. Melden Sie sich bei der an 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 die Registerkarte Verzeichnis-Buckets aus.

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

  5. Wählen Sie dieObjekte-Tag. Markieren 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 den Allzweck-Bucket für Ihren Zieltyp aus. Um den Zielpfad anzugeben, wählen Sie S3 durchsuchen aus, navigieren Sie zum Ziel und wählen Sie die Optionsschaltfläche links vom Ziel aus. Wählen Sie unten rechts Choose destination (Ziel auswählen) aus.

    Geben Sie alternativ den Zielpfad ein.

  8. Wählen Sie unter Zusätzliche Kopiereinstellungen aus, ob Sie Quelleinstellungen kopieren, Keine Einstellungen angeben oder Einstellungen angeben möchten. Quelleinstellungen kopieren ist die Standardoption. Wenn Sie das Objekt nur ohne die Quelleinstellungsattribute kopieren möchten, wählen Sie Keine Einstellungen angeben aus. Wählen Sie Einstellungen angeben, um Einstellungen für Speicherklasse, Objekt-Tags ACLs, Metadaten, serverseitige Verschlüsselung und zusätzliche Prüfsummen anzugeben.

  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 den Befehl zu verwenden, ersetzen Sie den Platzhaltertext des Benutzers durch Ihre eigenen Informationen.

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

Weitere Informationen finden Sie unter copy-objectin der AWS CLI Befehlsreferenz.