

 **Cette page est réservée aux clients existants du service Amazon Glacier utilisant Vaults et l'API REST d'origine datant de 2012.**

Si vous recherchez des solutions de stockage d'archives, nous vous recommandons d'utiliser les classes de stockage Amazon Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les [classes de stockage Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'accepte plus de nouveaux clients. Amazon Glacier est un service autonome doté de son propre service APIs qui stocke les données dans des coffres-forts et qui se distingue des classes de stockage Amazon S3 et Amazon S3 Glacier. Vos données existantes resteront sécurisées et accessibles indéfiniment dans Amazon Glacier. Aucune migration n'est requise. Pour un stockage d'archivage à long terme et à faible coût AWS , nous [recommandons les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), qui offrent une expérience client supérieure avec des compartiments S3, une Région AWS disponibilité totale APIs, des coûts réduits et AWS une intégration des services. Si vous souhaitez des fonctionnalités améliorées, envisagez de migrer vers les classes de stockage Amazon S3 Glacier en suivant nos [conseils relatifs aux AWS solutions pour le transfert de données depuis les coffres-forts Amazon Glacier vers les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Étape 4 : télécharger une archive depuis un coffre-fort dans Amazon Glacier
<a name="getting-started-download-archive"></a>

Dans cette étape, vous allez télécharger l'exemple d'archive que vous avez chargée précédemment à l'[Étape 3 : télécharger une archive dans un coffre-fort d'Amazon Glacier](getting-started-upload-archive.md).

 

**Important**  
Amazon Glacier fournit une console. Cependant, toute opération d'archivage, telle que le chargement, le téléchargement ou la suppression, nécessite que vous utilisiez la AWS Command Line Interface (CLI) ou que vous écriviez du code. Il n'y a aucune prise en charge de la console pour les opérations d'archivage. Par exemple, pour télécharger des données, telles que des photos, des vidéos et d'autres documents, vous devez soit utiliser le AWS CLI code pour effectuer des demandes, soit en utilisant directement l'API REST, soit en utilisant le AWS SDKs.   
Pour installer le AWS CLI, voir [AWS Command Line Interface](https://aws.amazon.com/cli/). Pour plus d'informations sur l'utilisation d'Amazon Glacier avec le AWS CLI, consultez la section [AWS CLI Référence relative à Amazon Glacier](https://docs.aws.amazon.com/cli/latest/reference/glacier/index.html). Pour des exemples d'utilisation du AWS CLI pour télécharger des archives sur Amazon Glacier, consultez la section [Utilisation d'Amazon Glacier avec le AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-glacier.html). 

En général, la récupération de vos données depuis Amazon Glacier s'effectue en deux étapes : 

1. Lancez une tâche d'extraction.

1. Une fois la tâche terminée, téléchargez les octets de données. 

Pour récupérer une archive depuis Amazon Glacier, vous devez d'abord lancer une tâche. Une fois la tâche terminée, vous téléchargez les données. Pour plus d'informations sur les récupérations d'archives, consultez [Récupération des archives Amazon Glacier](downloading-an-archive-two-steps.md).

Le temps d'accès de votre demande dépend de l'option d'extraction que vous choisissez : Expedited, Standard ou Bulk. Pour toutes les archives à l'exception des plus volumineuses (plus de 250 Mo), les archives auxquelles vous accédez avec des extractions de type Expedited sont généralement disponibles en 1-5 minutes. Les archives récupérées avec des extractions de type Standard sont généralement disponibles en 3-5 heures. Les extractions de type Bulk sont généralement disponibles dans un délai compris entre 5 et 12 heures. Pour plus d'informations sur les différentes options de récupération, consultez la [FAQ Amazon Glacier](https://aws.amazon.com/glacier/faqs/#Data-retrievals). Pour plus d'informations sur les frais de récupération des données, consultez la [page de tarification d'Amazon Glacier](https://aws.amazon.com/s3/glacier/pricing/).

Les exemples de code présentés dans les rubriques suivantes lancent la tâche, attendent qu'elle soit terminée, puis téléchargent les données de l'archive. 

**Topics**
+ [Téléchargez une archive depuis un coffre-fort d'Amazon Glacier à l'aide du AWS SDK pour Java](getting-started-download-archive-java.md)
+ [Téléchargez une archive depuis un coffre-fort d'Amazon Glacier à l'aide du AWS SDK pour .NET](getting-started-download-archive-dotnet.md)

# Téléchargez une archive depuis un coffre-fort d'Amazon Glacier à l'aide du AWS SDK pour Java
<a name="getting-started-download-archive-java"></a>

L'exemple de code Java suivant utilise l'API de haut niveau du AWS SDK pour Java pour télécharger l'archive que vous avez chargée à l'étape précédente. Dans l'exemple de code, notez les éléments suivants :
+ L' exemple crée une instance de la classe `AmazonGlacierClient`. 
+ Le code utilise la région USA Ouest (Oregon) (`us-west-2`) qui correspond à l'emplacement du coffre que vous avez créé précédemment à l'[Étape 2 : créer un coffre-fort dans Amazon Glacier](getting-started-create-vault.md). 
+ L'exemple utilise l'opération d'API `download` de la classe `ArchiveTransferManager` issue de l'API de haut niveau d' AWS SDK pour Java. L'exemple crée une rubrique Amazon Simple Notification Service (Amazon SNS) et une file d'attente Amazon Simple Queue Service (Amazon SQS) qui est abonnée à cette rubrique. Si vous avez créé un utilisateur administrateur Gestion des identités et des accès AWS (IAM) conformément aux instructions[Étape 1 : Avant de commencer à utiliser Amazon Glacier](getting-started-before-you-begin.md), celui-ci dispose des autorisations IAM nécessaires pour créer et utiliser la rubrique Amazon SNS et la file d'attente Amazon SQS.

Pour step-by-step obtenir des instructions sur la façon d'exécuter cet exemple, reportez-vous à[Exécution d'exemples Java pour Amazon Glacier à l'aide d'Eclipse](using-aws-sdk-for-java.md#setting-up-and-testing-sdk-java). Vous devez mettre à jour le code tel qu'il est présenté avec l'ID d'archive du fichier que vous avez chargé à l'[Étape 3 : télécharger une archive dans un coffre-fort d'Amazon Glacier](getting-started-upload-archive.md). 

**Example — Téléchargement d'une archive à l'aide du AWS SDK pour Java**  <a name="GS_ExampleDownloadArchiveJava"></a>

```
import java.io.File;
import java.io.IOException;

import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.glacier.AmazonGlacierClient;
import com.amazonaws.services.glacier.transfer.ArchiveTransferManager;
import com.amazonaws.services.sns.AmazonSNSClient;
import com.amazonaws.services.sqs.AmazonSQSClient;

public class AmazonGlacierDownloadArchive_GettingStarted {
    public static String vaultName = "examplevault";
    public static String archiveId = "*** provide archive ID ***";
    public static String downloadFilePath  = "*** provide location to download archive ***";
    
    public static AmazonGlacierClient glacierClient;
    public static AmazonSQSClient sqsClient;
    public static AmazonSNSClient snsClient;
    
    public static void main(String[] args) throws IOException {
        
        
    	ProfileCredentialsProvider credentials = new ProfileCredentialsProvider();
    	
        glacierClient = new AmazonGlacierClient(credentials);        
        sqsClient = new AmazonSQSClient(credentials);
        snsClient = new AmazonSNSClient(credentials);
        
        glacierClient.setEndpoint("glacier.us-west-2.amazonaws.com");
        sqsClient.setEndpoint("sqs.us-west-2.amazonaws.com");
        snsClient.setEndpoint("sns.us-west-2.amazonaws.com");

        try {
            ArchiveTransferManager atm = new ArchiveTransferManager(glacierClient, sqsClient, snsClient);
            
            atm.download(vaultName, archiveId, new File(downloadFilePath));
            
        } catch (Exception e)
        {
            System.err.println(e);
        }
    }
}
```

# Téléchargez une archive depuis un coffre-fort d'Amazon Glacier à l'aide du AWS SDK pour .NET
<a name="getting-started-download-archive-dotnet"></a>

L'exemple de code C\$1 suivant utilise l'API de haut niveau du AWS SDK pour .NET pour télécharger l'archive que vous avez téléchargée précédemment. [Téléchargez une archive dans un coffre-fort d'Amazon Glacier à l'aide du AWS SDK pour .NET](getting-started-upload-archive-dotnet.md) Dans l'exemple de code, notez les éléments suivants :

 
+ L'exemple crée une instance de la `ArchiveTransferManager` classe pour le point de terminaison Amazon Glacier Region spécifié.
+ L'exemple de code utilise la région USA Ouest (Oregon) (`us-west-2`) qui correspond à l'emplacement du coffre créé précédemment à l'[Étape 2 : créer un coffre-fort dans Amazon Glacier](getting-started-create-vault.md). 
+ L'exemple utilise l'opération d'API `Download` de la classe `ArchiveTransferManager` pour télécharger votre archive. L'exemple crée une rubrique Amazon Simple Notification Service (Amazon SNS) et une file d'attente Amazon Simple Queue Service (Amazon SQS) qui est abonnée à cette rubrique. Si vous avez créé un utilisateur administrateur Gestion des identités et des accès AWS (IAM) conformément aux instructions[Étape 1 : Avant de commencer à utiliser Amazon Glacier](getting-started-before-you-begin.md), celui-ci dispose des autorisations IAM nécessaires pour créer et utiliser la rubrique Amazon SNS et la file d'attente Amazon SQS.
+ L'exemple lance ensuite la tâche d'extraction d'archive et interroge la file d'attente pour que l'archive soit disponible. Le téléchargement commence dès que l'archive est disponible. Pour plus d'informations sur les délais d'extraction, consultez [Options de récupération des archives](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options).

Pour step-by-step obtenir des instructions sur la façon d'exécuter cet exemple, consultez[Exemples de code en cours d'exécution](using-aws-sdk-for-dot-net.md#setting-up-and-testing-sdk-dotnet). Vous devez mettre à jour le code tel qu'il est présenté avec l'ID d'archive du fichier que vous avez chargé à l'[Étape 3 : télécharger une archive dans un coffre-fort d'Amazon Glacier](getting-started-upload-archive.md). 

**Example — Téléchargez une archive à l'aide de l'API de haut niveau du AWS SDK pour .NET**  <a name="GS_ExampleDownloadArchiveDotNet"></a>

```
using System;
using Amazon.Glacier;
using Amazon.Glacier.Transfer;
using Amazon.Runtime;

namespace glacier.amazon.com.rproxy.govskope.us.docsamples
{
    class ArchiveDownloadHighLevel_GettingStarted
    {
        static string vaultName = "examplevault";
        static string archiveId = "*** Provide archive ID ***";
        static string downloadFilePath = "*** Provide the file name and path to where to store the download ***";

        public static void Main(string[] args)
        {
            try
            {
                var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2);

                var options = new DownloadOptions();
                options.StreamTransferProgress += ArchiveDownloadHighLevel_GettingStarted.progress;
                // Download an archive.
                Console.WriteLine("Intiating the archive retrieval job and then polling SQS queue for the archive to be available.");
                Console.WriteLine("Once the archive is available, downloading will begin.");
                manager.Download(vaultName, archiveId, downloadFilePath, options);
                Console.WriteLine("To continue, press Enter");
                Console.ReadKey();
            }
            catch (AmazonGlacierException e) { Console.WriteLine(e.Message); }
            catch (AmazonServiceException e) { Console.WriteLine(e.Message); }
            catch (Exception e) { Console.WriteLine(e.Message); }
            Console.WriteLine("To continue, press Enter");
            Console.ReadKey();
        }

        static int currentPercentage = -1;
        static void progress(object sender, StreamTransferProgressArgs args)
        {
            if (args.PercentDone != currentPercentage)
            {
                currentPercentage = args.PercentDone;
                Console.WriteLine("Downloaded {0}%", args.PercentDone);
            }
        }
    }
}
```