Copie d’objets vers ou depuis un compartiment de répertoires

L’opération de copie crée une copie d’un objet déjà stocké dans Amazon S3. Vous pouvez copier des objets entre des compartiments de répertoires et des compartiments à usage général. Vous pouvez également copier des objets au sein d’un compartiment et entre des compartiments du même type, par exemple, d’un compartiment de répertoires à un autre.

Vous pouvez créer une copie d’un objet d’une taille maximale de 5 Go dans une seule opération atomique. Toutefois, pour copier un objet supérieur à 5 Go, vous devez utiliser les opérations d’API de chargement partitionné. Pour de plus amples informations, veuillez consulter Utilisation du chargement partitionné avec les compartiments de répertoires.

Autorisations

Pour copier des objets, vous devez disposer des autorisations suivantes :

Chiffrement

Amazon S3 chiffre automatiquement tous les nouveaux objets chargés dans un compartiment S3. La configuration de chiffrement par défaut d’un compartiment S3 est toujours activée et est au minimum définie sur le chiffrement côté serveur avec les clés gérées par Amazon S3 (SSE-S3).

Pour les compartiments d'annuaire, le SSE-S3 et le chiffrement côté serveur avec des clés AWS Key Management Service (AWS KMS) (SSE-KMS) sont pris en charge. Lorsque le compartiment de destination est un compartiment de répertoires, nous recommandons que le chiffrement par défaut du compartiment de destination utilise la configuration de chiffrement souhaitée et que vous ne remplaciez pas le chiffrement par défaut du compartiment. Les nouveaux objets seront ensuite automatiquement chiffrés avec les paramètres de chiffrement souhaités. De plus, les clés de compartiment S3 ne sont pas prises en charge lorsque vous copiez des objets chiffrés SSE-KMS depuis des compartiments à usage général vers des compartiments de répertoire, des compartiments de répertoire vers des compartiments à usage général, ou entre des compartiments de répertoire, via CopyObject. Dans ce cas, Amazon S3 effectue un appel à AWS KMS chaque fois qu'une demande de copie est faite pour un objet chiffré par KMS. Pour plus d'informations sur les comportements de remplacement du chiffrement dans les compartiments de répertoire, voir Spécifier le chiffrement côté serveur avec AWS KMS pour les téléchargements de nouveaux objets.

Pour les compartiments à usage général, vous pouvez utiliser le SSE-S3 (par défaut), le chiffrement côté serveur avec des clés () AWS Key Management Service (SSE-KMS AWS KMS), le chiffrement double couche côté serveur avec des clés (DSSE-KMS) ou le chiffrement côté serveur avec des AWS KMS clés fournies par le client (SSE-C).

Si vous effectuez une demande de copie qui indique d’utiliser le chiffrement DSSE-KMS ou SSE-C pour un compartiment de répertoires (compartiment source ou cible), la réponse renverra une erreur.

Balises

Les compartiments de répertoires ne prennent pas en charge les balises. Si vous copiez un objet contenant des balises à partir d’un compartiment à usage général vers un compartiment de répertoires, vous recevez une réponse HTTP 501 (Not Implemented). Pour plus d’informations, consultez .CopyObjectdans le manuel Amazon Simple Storage Service API Reference.

ETags

Les balises d'entité (ETags) pour S3 Express One Zone sont des chaînes alphanumériques aléatoires et ne sont pas des MD5 checksums. Pour garantir l’intégrité des objets, utilisez des sommes de contrôle supplémentaires.

Sommes de contrôle supplémentaires

S3 Express One Zone vous offre la possibilité de choisir l’algorithme de somme de contrôle utilisé pour valider vos données pendant le chargement ou le téléchargement. Vous pouvez sélectionner l'un des algorithmes de hachage sécurisé (SHA) ou de contrôle de redondance cyclique (CRC) suivants : CRC32 C CRC32, SHA-1 et SHA-256. MD5les checksums basés sur la base de données ne sont pas pris en charge avec la classe de stockage S3 Express One Zone.

Pour de plus amples informations, veuillez consulter Bonnes pratiques supplémentaires en matière de somme de contrôle S3.

Fonctionnalités prises en charge

Pour plus d’informations sur les fonctionnalités Amazon S3 prises en charge pour S3 Express One Zone, consultez Différences pour les compartiments de répertoires.

 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);
       }
 }

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

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