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 de plus amples informations, veuillez consulter Configuration d’une configuration de cycle de vie de compartiment pour supprimer les chargements partitionnés incomplets.

La section suivante explique comment arrêter un chargement partitionné en cours dans Amazon S3 à l'aide de l' AWS Command Line Interface API REST ou. AWS SDKs

En utilisant le AWS CLI

Pour plus d'informations sur l'utilisation du AWS CLI pour arrêter un téléchargement partitionné, consultez abort-multipart-uploadla référence des AWS CLI commandes.

Utilisation de l'API REST

Pour plus d'informations sur l'utilisation de l'API REST pour arrêter un téléchargement AbortMultipartUploaden plusieurs parties, consultez le manuel Amazon Simple Storage Service API Reference.

Utilisation de AWS SDKs (API de haut niveau)

Java

Pour arrêter les téléchargements partitionnés en cours à l'aide du AWS SDK for Java, vous pouvez abandonner les téléchargements qui ont été initiés avant une date spécifiée et qui sont toujours 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é.

Pour arrêter les téléchargements partitionnés, vous pouvez :

1	Créez une instance S3Client.
2	Utilisez les méthodes d'abandon du client en transmettant le nom du compartiment et les autres paramètres requis.

Note

Vous pouvez également arrêter un chargement partitionné spécifique. Pour de plus amples informations, veuillez consulter Utilisation de AWS SDKs (API de bas niveau).

Pour des exemples expliquant comment abandonner des téléchargements partitionnés avec le SDK for AWS Java, consultez la section Annuler un téléchargement partitionné dans le manuel Amazon S3 API Reference.

.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 plus d'informations sur la configuration et l'exécution des exemples de code, consultez Getting Started with the AWS SDK for .NET dans AWS le Guide du développeur du SDK 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 de plus amples informations, veuillez consulter Utilisation de AWS SDKs (API de bas niveau).

Utilisation de AWS SDKs (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

Pour arrêter un téléchargement partitionné spécifique en cours à l'aide du AWS SDK for Java, vous pouvez utiliser l'API de bas niveau pour abandonner le téléchargement en fournissant le nom du bucket, la clé de l'objet et l'ID de téléchargement.

Note

Au lieu d'abandonner un téléchargement partitionné spécifique, vous pouvez arrêter tous les téléchargements partitionnés initiés avant une heure précise 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 de plus amples informations, veuillez consulter Utilisation de AWS SDKs (API de haut niveau).

Pour des exemples expliquant comment annuler un téléchargement partitionné spécifique avec le AWS SDK for Java, consultez la section Annuler un téléchargement partitionné dans le manuel Amazon S3 API Reference.

.NET

L’exemple C# suivant montre comment arrêter un chargement partitionné. Pour obtenir un exemple C# complet incluant le code suivant, consultez Utilisation de AWS SDKs (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 de AWS SDKs (API de haut niveau).

PHP

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

Pour plus d'informations sur l'API AWS SDK for Ruby, consultez AWS SDK for 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,
]);