Interruption d’un chargement partitionné - Amazon Simple Storage Service

Interruption d’un chargement partitionné

Après avoir lancé un chargement partitionné, vous commencez à charger les parties. Amazon S3 stocke ces parties et ne crée l’objet qu’une fois que vous avez chargé toutes les parties et envoyé une demande de finalisation du chargement partitionné. Dès réception de la demande de fin de chargement partitionné, Amazon S3 assemble les parties et crée un objet. Si vous n’envoyez pas correctement la demande de finalisation du chargement partitionné, S3 n’assemble pas les différentes parties et ne crée aucun objet. Si vous ne souhaitez pas finaliser un chargement partitionné après avoir chargé différentes parties, vous devez abandonner le chargement partitionné.

Vous êtes facturé pour tout le stockage associé aux parties chargées. Il est recommandé de toujours finaliser le chargement partitionné ou d’arrêter le chargement partitionné pour supprimer les parties chargées. Pour de plus amples informations sur la tarification, consultez Chargement partitionné et tarification.

Vous pouvez également arrêter un chargement partitionné incomplet à l’aide d’une configuration de cycle de vie de compartiment. Pour en savoir plus, consultez Configuration d’une configuration de cycle de vie de compartiment pour supprimer les chargements partitionnés incomplets.

La section suivante montre comment arrêter un chargement partitionné en cours dans Amazon S3 à l’aide de l’AWS Command Line Interface, de l’API REST ou des kits SDK AWS.

Pour en savoir plus sur l’utilisation de la AWS CLI pour arrêter un chargement partitionné, consultez abort-multipart-upload dans la Référence des commandes de l’AWS CLI.

Pour en savoir plus sur l’utilisation de l’API REST pour arrêter un chargement partitionné, consultez AbortMultipartUpload dans la Référence des API Amazon Simple Storage Service.

Java

La classe TransferManager fournit la méthode abortMultipartUploads pour arrêter les chargements partitionnés en cours. Un chargement est considéré comme étant en cours dès que vous le lancez et jusqu’à ce qu’il soit terminé ou arrêté. Vous fournissez une valeur Date, et cette API arrête tous les chargements partitionnés dans ce compartiment qui avaient été lancés avant la Date spécifiée et qui sont toujours en cours.

Les tâches suivantes vous guident tout au long de l’utilisation des classes Java de haut niveau pour arrêter les chargements partitionnés.

Processus d’arrêt des chargements partitionnés grâce à l’API de haut niveau

1

Créez une instance de la classe TransferManager.

2

Exécutez la méthode TransferManager.abortMultipartUploads en indiquant le nom du compartiment et une valeur Date.

Le code Java suivant arrête tous les chargements partitionnés en cours initiés dans un compartiment spécifique, il y a plus d’une semaine. Pour obtenir les instructions pour la création et le test d’un exemple pratique, consultez Démarrer dans le Guide du développeur AWS SDK for Java.

import java.util.Date; import com.amazonaws.AmazonClientException; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.s3.transfer.TransferManager; public class AbortMPUUsingHighLevelAPI { public static void main(String[] args) throws Exception { String existingBucketName = "*** Provide existing bucket name ***"; TransferManager tm = new TransferManager(new ProfileCredentialsProvider()); int sevenDays = 1000 * 60 * 60 * 24 * 7; Date oneWeekAgo = new Date(System.currentTimeMillis() - sevenDays); try { tm.abortMultipartUploads(existingBucketName, oneWeekAgo); } catch (AmazonClientException amazonClientException) { System.out.println("Unable to upload file, upload was aborted."); amazonClientException.printStackTrace(); } } }
Note

Vous pouvez également arrêter un chargement partitionné spécifique. Pour plus d’informations, consultez Utilisation des kits SDK AWS (API de bas niveau).

.NET

L’exemple C# suivant arrête tous les chargements partitionnés en cours initiés sur un compartiment spécifique il y a plus d’une semaine. Pour de plus amples informations sur la configuration et l’exécution des exemples de code, consultez Mise en route avec le kit SDK AWS pour .NET dans le Guide du développeur SDK AWS pour .NET.

using Amazon; using Amazon.S3; using Amazon.S3.Transfer; using System; using System.Threading.Tasks; namespace Amazon.DocSamples.S3 { class AbortMPUUsingHighLevelAPITest { private const string bucketName = "*** provide bucket name ***"; // Specify your bucket region (an example region is shown). private static readonly RegionEndpoint bucketRegion = RegionEndpoint.USWest2; private static IAmazonS3 s3Client; public static void Main() { s3Client = new AmazonS3Client(bucketRegion); AbortMPUAsync().Wait(); } private static async Task AbortMPUAsync() { try { var transferUtility = new TransferUtility(s3Client); // Abort all in-progress uploads initiated before the specified date. await transferUtility.AbortMultipartUploadsAsync( bucketName, DateTime.Now.AddDays(-7)); } catch (AmazonS3Exception e) { Console.WriteLine("Error encountered on server. Message:'{0}' when writing an object", e.Message); } catch (Exception e) { Console.WriteLine("Unknown encountered on server. Message:'{0}' when writing an object", e.Message); } } } }
Note

Vous pouvez également arrêter un chargement partitionné spécifique. Pour plus d’informations, consultez Utilisation des kits SDK AWS (API de bas niveau).

Vous pouvez arrêter un chargement partitionné en cours en appelant la méthode AmazonS3.abortMultipartUpload. Cette méthode supprime toutes les parties qui ont été chargées dans Amazon S3 et libère les ressources. Vous devez fournir l’ID de chargement, le nom du compartiment et le nom de la clé. L’exemple de code Java suivant illustre comment arrêter un chargement partitionné en cours.

Pour arrêter un chargement partitionné, vous fournissez l’ID de chargement, ainsi que les noms de compartiment et de clé utilisés dans le chargement. Après avoir arrêté un chargement partitionné, vous ne pouvez pas utiliser l’ID de chargement pour charger les parties supplémentaires. Pour en savoir plus sur les chargements partitionnés Amazon S3, consultez Chargement et copie d’objets à l’aide du chargement partitionné dans Amazon S3.

Java

L’exemple de code Java suivant arrête un chargement partitionné en cours.

InitiateMultipartUploadRequest initRequest = new InitiateMultipartUploadRequest(existingBucketName, keyName); InitiateMultipartUploadResult initResponse = s3Client.initiateMultipartUpload(initRequest); AmazonS3 s3Client = new AmazonS3Client(new ProfileCredentialsProvider()); s3Client.abortMultipartUpload(new AbortMultipartUploadRequest( existingBucketName, keyName, initResponse.getUploadId()));
Note

Au lieu d’un chargement partitionné spécifique, vous pouvez arrêter tous vos chargements partitionnés démarrés avant un moment spécifique et qui sont toujours en cours. Cette opération de nettoyage est utile pour arrêter les anciens chargements partitionnés que vous avez initiés mais que vous n’avez pas terminés ou arrêtés. Pour plus d’informations, consultez Utilisation des kits SDK AWS (API de haut niveau).

.NET

L’exemple C# suivant montre comment arrêter un chargement partitionné. Pour obtenir un exemple C# complet incluant le code suivant, consultez Utilisation des kits SDK AWS (API de bas niveau).

AbortMultipartUploadRequest abortMPURequest = new AbortMultipartUploadRequest { BucketName = existingBucketName, Key = keyName, UploadId = initResponse.UploadId }; await AmazonS3Client.AbortMultipartUploadAsync(abortMPURequest);

Vous pouvez aussi annuler tous les chargements partitionnés en cours démarrés avant un moment spécifique. Cette opération de nettoyage est utile pour abandonner les chargements partitionnés que vous n’avez pas terminés ou interrompus. Pour plus d’informations, consultez Utilisation des kits SDK AWS (API de haut niveau).

PHP

Cet exemple illustre comment utiliser une classe de la version 3 du kit AWS SDK for PHP pour interrompre un chargement partitionné en cours. Pour de plus amples informations sur l’API du kit SDK AWS pour Ruby, consultez Kit SDK AWS pour Ruby - Version 2. L’exemple de la méthode abortMultipartUpload().

Pour de plus amples informations sur l’API du kit SDK AWS pour Ruby, consultez Kit SDK AWS pour Ruby - Version 2.

require 'vendor/autoload.php'; use Aws\S3\S3Client; $bucket = '*** Your Bucket Name ***'; $keyname = '*** Your Object Key ***'; $uploadId = '*** Upload ID of upload to Abort ***'; $s3 = new S3Client([ 'version' => 'latest', 'region' => 'us-east-1' ]); // Abort the multipart upload. $s3->abortMultipartUpload([ 'Bucket' => $bucket, 'Key' => $keyname, 'UploadId' => $uploadId, ]);