

 **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.

# Commencer à utiliser Amazon Glacier
<a name="amazon-glacier-getting-started"></a>

Vous pouvez commencer à utiliser Amazon Glacier (Amazon Glacier) en utilisant des coffres-forts et des archives. Un *coffre* est un conteneur destiné à stocker les archives ; une *archive* est un quelconque objet, par exemple une photo, une vidéo ou un document, que vous stockez dans un coffre. Une archive est l’unité de stockage de base dans Amazon Glacier. Cet exercice de démarrage fournit des instructions vous permettant d'explorer les opérations de base d'Amazon Glacier sur les coffres-forts et les archives. Pour plus d'informations sur ces ressources, consultez la section [Modèle de données Amazon Glacier](amazon-glacier-data-model.md). 

Dans l'exercice de démarrage, vous allez créer un coffre, charger et télécharger une archive, puis supprimer cette archive et ce coffre. Toutes ces opérations peuvent être effectuées par programme. Toutefois, l'exercice de mise en route utilise la console de gestion Amazon Glacier pour créer et supprimer un coffre-fort. Pour charger et télécharger une archive, cette section de démarrage utilise l'API de haut niveau pour le AWS SDK pour Java et le AWS SDK pour .NET. L'API de haut niveau fournit une expérience de programmation simplifiée lorsque vous travaillez avec Amazon Glacier. Pour plus d'informations sur l'utilisation de l'API de haut niveau avec le AWS SDKs, consultez[Utilisation du AWS SDKs avec Amazon Glacier](using-aws-sdk.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 [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). 

Cet exercice de mise en route fournit des exemples de code en Java et C\$1 qui vous permettent de charger et de télécharger une archive. La dernière section de l'exercice de démarrage décrit les étapes qui vous permettront d'en savoir plus sur l'expérience des développeurs avec Amazon Glacier.

**Topics**
+ [Étape 1 : Avant de commencer à utiliser Amazon Glacier](getting-started-before-you-begin.md)
+ [Étape 2 : créer un coffre-fort dans Amazon Glacier](getting-started-create-vault.md)
+ [Étape 3 : télécharger une archive dans un coffre-fort d'Amazon Glacier](getting-started-upload-archive.md)
+ [Étape 4 : télécharger une archive depuis un coffre-fort dans Amazon Glacier](getting-started-download-archive.md)
+ [Étape 5 : Supprimer une archive d'un coffre-fort dans Amazon Glacier](getting-started-delete-archive.md)
+ [Étape 6 : supprimer un coffre-fort dans Amazon Glacier](getting-started-delete-vault.md)
+ [Comment procéder ensuite ?](getting-started-where-do-i-go-next.md)

# Étape 1 : Avant de commencer à utiliser Amazon Glacier
<a name="getting-started-before-you-begin"></a>

Avant de commencer cet exercice, vous devez vous inscrire à un Compte AWS (si ce n'est pas déjà fait), puis télécharger l'un des AWS SDKs. Consultez les sections suivantes pour obtenir des instructions.

**Topics**
+ [Configuration d'un utilisateur Compte AWS et d'un administrateur](#setup)
+ [Téléchargez le AWS SDK approprié](#getting-started-download-sdk)

## Configuration d'un utilisateur Compte AWS et d'un administrateur
<a name="setup"></a>

Si ce n'est pas déjà fait, vous devez créer un compte Compte AWS et créer un compte administrateur. 

Pour effectuer la configuration, suivez les instructions contenues dans les rubriques suivantes.

### Configuration Compte AWS et création d'un utilisateur administrateur
<a name="setting-up"></a>

#### Inscrivez-vous pour AWS
<a name="setting-up-signup"></a>

Lorsque vous vous inscrivez à Amazon Web Services (AWS), vous êtes automatiquement Compte AWS inscrit à tous les services AWS, y compris Amazon Glacier. Seuls les services que vous utilisez vous sont facturés. Pour plus d'informations sur les taux d'utilisation d'Amazon Glacier, consultez la [page de tarification d'Amazon Glacier](https://aws.amazon.com/s3/glacier/pricing/).

Si vous en avez déjà un Compte AWS, passez directement à[Téléchargez le AWS SDK approprié](#getting-started-download-sdk). Si vous n'en avez pas Compte AWS, utilisez la procédure suivante pour en créer un.

Si vous n'en avez pas Compte AWS, procédez comme suit pour en créer un.

**Pour vous inscrire à un Compte AWS**

1. Ouvrez l'[https://portal.aws.amazon.com/billing/inscription.](https://portal.aws.amazon.com/billing/signup)

1. Suivez les instructions en ligne.

   Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique ou un SMS et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.

   Lorsque vous vous inscrivez à un Compte AWS, un *Utilisateur racine d'un compte AWS*est créé. Par défaut, seul l’utilisateur racine a accès à l’ensemble des Services AWS et des ressources de ce compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l’utilisateur racine pour effectuer les [tâches nécessitant un accès utilisateur racine](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).

Afin de créer un utilisateur administrateur, choisissez l'une des options suivantes :


****  

| Choisissez un moyen de gérer votre administrateur | À | En | Vous pouvez également | 
| --- | --- | --- | --- | 
| Dans IAM Identity Center (Recommandé) | Utiliser des informations d’identification à court terme pour accéder à AWS.C’est conforme aux bonnes pratiques en matière de sécurité. Pour plus d’informations sur les bonnes pratiques, consultez [Bonnes pratiques de sécurité dans IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) dans le *Guide de l’utilisateur IAM*. | Suivant les instructions fournies dans [Mise en route](https://docs.aws.amazon.com//singlesignon/latest/userguide/getting-started.html) dans le Guide de l’utilisateur AWS IAM Identity Center . | Configurez l'accès par programmation en [configurant le AWS CLI à utiliser AWS IAM Identity Center](https://docs.aws.amazon.com//cli/latest/userguide/cli-configure-sso.html) dans le guide de l'AWS Command Line Interface utilisateur. | 
| Dans IAM (Non recommandé) | Utiliser les informations d’identification à long terme pour accéder à AWS. | Suivant les instructions fournies dans [Création d’un utilisateur IAM pour l’accès d’urgence](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started-emergency-iam-user.html) dans le Guide de l’utilisateur IAM. | Configurer l’accès par programmation en suivant les instructions fournies dans [Gestion des clés d’accès pour les utilisateurs IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_credentials_access-keys.html) dans le Guide de l’utilisateur IAM. | 

## Téléchargez le AWS SDK approprié
<a name="getting-started-download-sdk"></a>

Pour essayer l'exercice de démarrage, vous devez choisir le langage de programmation que vous souhaitez utiliser, puis télécharger le AWS SDK adapté à votre plate-forme de développement.

L'exercice de démarrage fournit des exemples en Java et C\$1. 

### Téléchargement du AWS SDK pour Java
<a name="getting-started-download-sdk-java"></a>

Pour tester les exemples du manuel du développeur, vous avez besoin du kit AWS SDK pour Java. Vous disposez des options de téléchargement suivantes : 
+ Si vous utilisez Eclipse, vous pouvez le télécharger et l'installer AWS Toolkit for Eclipse en utilisant le site de mise à jour [http://aws.amazon.com/eclipse/](https://aws.amazon.com/eclipse/). Pour de plus amples informations, veuillez consulter [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/).
+ Si vous utilisez n'importe quel autre IDE pour créer votre application, téléchargez le kit [AWS SDK pour Java](https://aws.amazon.com/sdkforjava). 

### Téléchargement du AWS SDK pour .NET
<a name="getting-started-download-sdk-dotnet"></a>

Pour tester les exemples en C\$1 du manuel du développeur, vous avez besoin du kit AWS SDK pour .NET. Vous disposez des options de téléchargement suivantes :
+ Si vous utilisez Visual Studio, vous pouvez installer à la fois le AWS SDK pour .NET et le AWS Toolkit for Visual Studio. La boîte à outils fournit l' AWS explorateur pour Visual Studio et des modèles de projet que vous pouvez utiliser pour le développement. Pour le télécharger AWS SDK pour .NET, rendez-vous sur [http://aws.amazon.com/sdkfornet](https://aws.amazon.com/sdkfornet/). Par défaut, le script d'installation installe à la fois le AWS SDK et le. AWS Toolkit for Visual Studio Pour en savoir plus sur la boîte à outils, consulter le [Guide de l'utilisateur AWS Toolkit for Visual Studio](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/). 
+ Si vous utilisez n'importe quel autre IDE pour créer votre application, vous pouvez utiliser le même lien que celui fourni à l'étape précédente et installer uniquement le kit AWS SDK pour .NET. 

# Étape 2 : créer un coffre-fort dans Amazon Glacier
<a name="getting-started-create-vault"></a>

Un coffre-fort est un conteneur pour le stockage d'archives. La première étape consiste à créer un coffre-fort dans l'un des modèles pris en charge Régions AWS. Pour obtenir la Régions AWS liste des appareils pris en charge par Amazon Glacier, consultez la section [Points de terminaison et quotas Amazon Glacier](https://docs.aws.amazon.com/general/latest/gr/glacier-service.html) dans le manuel de *référence AWS général*.

Vous pouvez créer des coffres-forts par programmation ou à l'aide de la console Amazon Glacier. Cette section utilise la console pour créer un coffre.

**Pour créer un coffre**

1. Connectez-vous à la console Amazon Glacier AWS Management Console et ouvrez-la [https://console.aws.amazon.com/glacier/chez](https://console.aws.amazon.com/glacier/home) vous.

1. Dans le panneau de navigation de gauche, choisissez **Coffres**.

1. Choisissez **Créer un coffre**.

   La page **Créer un coffre** s'ouvre.

1. Sous **Sélectionnez une région**, sélectionnez-en une dans le sélecteur Région AWS de région. Votre coffre se situera dans la région que vous sélectionnez.

1. Dans **Nom du coffre**, donnez un nom à votre coffre.

   Les conventions de dénomination des coffres sont les suivantes :
   + Le nom d'un coffre doit être unique au sein d'un Compte AWS et de Région AWS ceux dans lesquels le coffre a été créé.
   + Un nom de coffre doit comporter entre 1 et 255 caractères.
   + Un nom de coffre peut contenir uniquement les caractères suivants : **a–z**, **A–Z**, **0–9**, **\$1** (trait de soulignement), **-** (trait d'union) et **.** (point).

1. Sous **Notifications d'événements**, pour activer ou désactiver les notifications de coffre signalant l'achèvement d'une tâche, choisissez l'un des paramètres suivants :
   + **Désactiver les notifications** : les notifications sont désactivées, et aucune notification n'est envoyée à une rubrique Amazon Simple Notification Service (Amazon SNS) lorsqu'une tâche spécifiée se termine. 
   + **Activer les notifications** : les notifications sont activées, et une notification est envoyée à la rubrique Amazon SNS fournie lorsqu'une tâche spécifiée se termine. 

     Si vous avez choisi **Activer les notifications**, consultez [Configuration des notifications Vault à l'aide de la console Amazon Glacier](https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications-console.html).

1. Si le nom Région AWS et le nom du coffre sont corrects, choisissez **Create vault**. 

Votre nouveau coffre-fort est désormais répertorié sur la page **Coffres-forts** de la console Amazon Glacier.

# Étape 3 : télécharger une archive dans un coffre-fort d'Amazon Glacier
<a name="getting-started-upload-archive"></a>

Dans cette étape, vous allez charger un exemple d'archive sur le coffre que vous avez créé à l'étape précédente (voir [Étape 2 : créer un coffre-fort dans Amazon Glacier](getting-started-create-vault.md)). Selon la plateforme de développement que vous utilisez, choisissez l'un des liens figurant à la fin de cette section.

**Important**  
Toute opération liée aux archives, telle que le chargement, le téléchargement ou la suppression, nécessite d'utiliser l' AWS Command Line Interface (CLI) ou d'écrire 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). 

Une archive est un objet, comme une photo, une vidéo ou un document, que vous stockez dans un coffre. Une archive est l’unité de stockage de base dans Amazon Glacier. Vous pouvez charger une archive dans une seule demande. Pour les archives volumineuses, Amazon Glacier fournit une opération d'API de téléchargement en plusieurs parties qui vous permet de télécharger une archive en plusieurs parties. 

Dans cette section de mise en route, vous chargez un exemple d'archive dans une seule demande. Pour cet exercice, vous spécifiez un fichier dont la taille est plus petite. Pour les fichiers plus volumineux, le chargement partitionné est plus approprié. Pour de plus amples informations, veuillez consulter [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).

**Topics**
+ [Téléchargez une archive dans un coffre-fort d'Amazon Glacier à l'aide du AWS SDK pour Java](getting-started-upload-archive-java.md)
+ [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)

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

L'exemple de code Java suivant utilise l'API de haut niveau du AWS SDK pour Java pour télécharger un exemple d'archive dans le coffre-fort. Dans l'exemple de code, notez les éléments suivants : 
+ L' exemple crée une instance de la classe `AmazonGlacierClient`. 
+ L'exemple utilise l'opération d'API `upload` de la classe `ArchiveTransferManager` issue de l'API de haut niveau d' AWS SDK pour Java. 
+ L'exemple utilise la région USA Ouest (Oregon) (`us-west-2`).

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 le nom du fichier d'archive que vous souhaitez charger.

**Note**  
Amazon Glacier conserve un inventaire de toutes les archives de vos coffres-forts. Lorsque vous chargez l'archive dans l'exemple suivant, elle ne s'affiche pas dans un coffre dans la console de gestion tant que l'inventaire du coffre n'a pas été mis à jour. Cette mise à jour a lieu habituellement une fois par jour. 

**SDK pour Java 2.x**  
 Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/glacier#code-examples). 

```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.glacier.GlacierClient;
import software.amazon.awssdk.services.glacier.model.UploadArchiveRequest;
import software.amazon.awssdk.services.glacier.model.UploadArchiveResponse;
import software.amazon.awssdk.services.glacier.model.GlacierException;
import java.io.File;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.io.FileInputStream;
import java.io.IOException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

/**
 * Before running this Java V2 code example, set up your development
 * environment, including your credentials.
 *
 * For more information, see the following documentation topic:
 *
 * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
 */
public class UploadArchive {

    static final int ONE_MB = 1024 * 1024;

    public static void main(String[] args) {
        final String usage = """

                Usage:   <strPath> <vaultName>\s

                Where:
                   strPath - The path to the archive to upload (for example, C:\\AWS\\test.pdf).
                   vaultName - The name of the vault.
                """;

        if (args.length != 2) {
            System.out.println(usage);
            System.exit(1);
        }

        String strPath = args[0];
        String vaultName = args[1];
        File myFile = new File(strPath);
        Path path = Paths.get(strPath);
        GlacierClient glacier = GlacierClient.builder()
                .region(Region.US_EAST_1)
                .build();

        String archiveId = uploadContent(glacier, path, vaultName, myFile);
        System.out.println("The ID of the archived item is " + archiveId);
        glacier.close();
    }

    public static String uploadContent(GlacierClient glacier, Path path, String vaultName, File myFile) {
        // Get an SHA-256 tree hash value.
        String checkVal = computeSHA256(myFile);
        try {
            UploadArchiveRequest uploadRequest = UploadArchiveRequest.builder()
                    .vaultName(vaultName)
                    .checksum(checkVal)
                    .build();

            UploadArchiveResponse res = glacier.uploadArchive(uploadRequest, path);
            return res.archiveId();

        } catch (GlacierException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
        return "";
    }

    private static String computeSHA256(File inputFile) {
        try {
            byte[] treeHash = computeSHA256TreeHash(inputFile);
            System.out.printf("SHA-256 tree hash = %s\n", toHex(treeHash));
            return toHex(treeHash);

        } catch (IOException ioe) {
            System.err.format("Exception when reading from file %s: %s", inputFile, ioe.getMessage());
            System.exit(-1);

        } catch (NoSuchAlgorithmException nsae) {
            System.err.format("Cannot locate MessageDigest algorithm for SHA-256: %s", nsae.getMessage());
            System.exit(-1);
        }
        return "";
    }

    public static byte[] computeSHA256TreeHash(File inputFile) throws IOException,
            NoSuchAlgorithmException {

        byte[][] chunkSHA256Hashes = getChunkSHA256Hashes(inputFile);
        return computeSHA256TreeHash(chunkSHA256Hashes);
    }

    /**
     * Computes an SHA256 checksum for each 1 MB chunk of the input file. This
     * includes the checksum for the last chunk, even if it's smaller than 1 MB.
     */
    public static byte[][] getChunkSHA256Hashes(File file) throws IOException,
            NoSuchAlgorithmException {

        MessageDigest md = MessageDigest.getInstance("SHA-256");
        long numChunks = file.length() / ONE_MB;
        if (file.length() % ONE_MB > 0) {
            numChunks++;
        }

        if (numChunks == 0) {
            return new byte[][] { md.digest() };
        }

        byte[][] chunkSHA256Hashes = new byte[(int) numChunks][];
        FileInputStream fileStream = null;

        try {
            fileStream = new FileInputStream(file);
            byte[] buff = new byte[ONE_MB];

            int bytesRead;
            int idx = 0;

            while ((bytesRead = fileStream.read(buff, 0, ONE_MB)) > 0) {
                md.reset();
                md.update(buff, 0, bytesRead);
                chunkSHA256Hashes[idx++] = md.digest();
            }

            return chunkSHA256Hashes;

        } finally {
            if (fileStream != null) {
                try {
                    fileStream.close();
                } catch (IOException ioe) {
                    System.err.printf("Exception while closing %s.\n %s", file.getName(),
                            ioe.getMessage());
                }
            }
        }
    }

    /**
     * Computes the SHA-256 tree hash for the passed array of 1 MB chunk
     * checksums.
     */
    public static byte[] computeSHA256TreeHash(byte[][] chunkSHA256Hashes)
            throws NoSuchAlgorithmException {

        MessageDigest md = MessageDigest.getInstance("SHA-256");
        byte[][] prevLvlHashes = chunkSHA256Hashes;
        while (prevLvlHashes.length > 1) {
            int len = prevLvlHashes.length / 2;
            if (prevLvlHashes.length % 2 != 0) {
                len++;
            }

            byte[][] currLvlHashes = new byte[len][];
            int j = 0;
            for (int i = 0; i < prevLvlHashes.length; i = i + 2, j++) {

                // If there are at least two elements remaining.
                if (prevLvlHashes.length - i > 1) {

                    // Calculate a digest of the concatenated nodes.
                    md.reset();
                    md.update(prevLvlHashes[i]);
                    md.update(prevLvlHashes[i + 1]);
                    currLvlHashes[j] = md.digest();

                } else { // Take care of the remaining odd chunk
                    currLvlHashes[j] = prevLvlHashes[i];
                }
            }

            prevLvlHashes = currLvlHashes;
        }

        return prevLvlHashes[0];
    }

    /**
     * Returns the hexadecimal representation of the input byte array
     */
    public static String toHex(byte[] data) {
        StringBuilder sb = new StringBuilder(data.length * 2);
        for (byte datum : data) {
            String hex = Integer.toHexString(datum & 0xFF);

            if (hex.length() == 1) {
                // Append leading zero.
                sb.append("0");
            }
            sb.append(hex);
        }
        return sb.toString().toLowerCase();
    }
}
```
+  Pour plus de détails sur l'API, reportez-vous [UploadArchive](https://docs.aws.amazon.com/goto/SdkForJavaV2/glacier-2012-06-01/UploadArchive)à la section *Référence des AWS SDK for Java 2.x API*. 

# Téléchargez une archive dans un coffre-fort d'Amazon Glacier à l'aide du AWS SDK pour .NET
<a name="getting-started-upload-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 un exemple d'archive dans le coffre-fort. 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é.
+ Cet exemple utilise la région USA Ouest (Oregon) (`us-west-2`). 
+ L'exemple utilise l'opération d'API `Upload` de la classe `ArchiveTransferManager` pour charger votre archive. Pour les petites archives, cette opération télécharge l'archive directement sur Amazon Glacier. Pour les archives plus volumineuses, cette opération utilise l'opération d'API de téléchargement en plusieurs parties dans Amazon Glacier pour diviser le téléchargement en plusieurs parties afin de mieux corriger les erreurs, si des erreurs se produisent lors de la diffusion des données vers Amazon Glacier.

Pour step-by-step obtenir des instructions sur la façon d'exécuter l'exemple suivant, 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 le nom de votre coffre et le nom du fichier d'archive à charger.  

**Note**  
Amazon Glacier conserve un inventaire de toutes les archives de vos coffres-forts. Lorsque vous chargez l'archive dans l'exemple suivant, elle n'apparaît pas dans un coffre dans la console de gestion tant que l'inventaire du coffre n'a pas été mis à jour. Cette mise à jour a lieu habituellement une fois par jour. 

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

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

namespace glacier.amazon.com.rproxy.govskope.ca.docsamples
{
    class ArchiveUploadHighLevel_GettingStarted
    {
        static string vaultName = "examplevault";
        static string archiveToUpload = "*** Provide file name (with full path) to upload ***";

        public static void Main(string[] args)
        {
            try
            {
                var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2);
                // Upload an archive.
                string archiveId = manager.Upload(vaultName, "getting started archive test", archiveToUpload).ArchiveId;
                Console.WriteLine("Copy and save the following Archive ID for the next step."); 
                Console.WriteLine("Archive ID: {0}", archiveId);
                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();
        }
    }
}
```

# É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.ca.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);
            }
        }
    }
}
```

# Étape 5 : Supprimer une archive d'un coffre-fort dans Amazon Glacier
<a name="getting-started-delete-archive"></a>

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

**Important**  
Vous ne pouvez pas supprimer une archive à l'aide de la console Amazon Glacier. 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. Pour télécharger des données, telles que des photos, des vidéos et d'autres documents, vous devez utiliser le code AWS CLI ou écrire du code pour effectuer des demandes, en utilisant soit 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). 

Supprimez l'archive d'exemple en suivant l'une des méthodes suivantes SDKs ou en suivant AWS CLI : 
+ [Supprimer une archive d'un coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour Java](getting-started-delete-archive-java.md)
+ [Supprimer une archive d'un coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour .NET](getting-started-delete-archive-dotnet.md)
+ [Supprimer une archive dans Amazon Glacier à l'aide du AWS CLI](getting-started-delete-archive-cli.md)

## Sections connexes
<a name="getting-started-delete-archive-related-sections"></a>

 
+ [Étape 3 : télécharger une archive dans un coffre-fort d'Amazon Glacier](getting-started-upload-archive.md)
+ [Supprimer une archive dans Amazon Glacier](deleting-an-archive.md)

# Supprimer une archive d'un coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour Java
<a name="getting-started-delete-archive-java"></a>

L'exemple de code suivant utilise le AWS SDK pour Java pour supprimer l'archive. Dans le code, notez les éléments suivants :

 
+ L'objet `DeleteArchiveRequest` décrit la demande de suppression, y compris le nom du coffre où se trouve l'archive et l'ID de l'archive.
+ L'opération `deleteArchive` d'API envoie la demande à Amazon Glacier pour supprimer l'archive. 
+ L'exemple utilise la région USA Ouest (Oregon) (`us-west-2`). 

Pour step-by-step obtenir des instructions sur la façon d'exécuter cet exemple, consultez[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 — Suppression d'une archive à l'aide du AWS SDK pour Java**  <a name="GS_ExampleDeleteArchiveJava"></a>

```
import java.io.IOException;

import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.glacier.AmazonGlacierClient;
import com.amazonaws.services.glacier.model.DeleteArchiveRequest;

public class AmazonGlacierDeleteArchive_GettingStarted {

    public static String vaultName = "examplevault";
    public static String archiveId = "*** provide archive ID***";
    public static AmazonGlacierClient client;
    
    public static void main(String[] args) throws IOException {
        
    	
    	ProfileCredentialsProvider credentials = new ProfileCredentialsProvider();

        client = new AmazonGlacierClient(credentials);
        client.setEndpoint("https://glacier.us-west-2.amazonaws.com/");        

        try {

            // Delete the archive.
            client.deleteArchive(new DeleteArchiveRequest()
                .withVaultName(vaultName)
                .withArchiveId(archiveId));
            
            System.out.println("Deleted archive successfully.");
            
        } catch (Exception e) {
            System.err.println("Archive not deleted.");
            System.err.println(e);
        }
    }
}
```

# Supprimer une archive d'un coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour .NET
<a name="getting-started-delete-archive-dotnet"></a>

L'exemple de code C\$1 suivant utilise l'API de haut niveau du AWS SDK pour .NET pour supprimer l'archive que vous avez télé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 `ArchiveTransferManager` classe pour le point de terminaison Amazon Glacier Region spécifié.
+ Cet exemple utilise la région USA Ouest (Oregon) (`us-west-2`). 
+ Cet exemple utilise l'opération d'API `Delete` de la classe `ArchiveTransferManager` fournie par l'API de haut niveau d' AWS SDK pour .NET. 

Pour step-by-step obtenir des instructions sur la façon d'exécuter cet exemple, reportez-vous à[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 — Suppression d'une archive à l'aide de l'API de haut niveau du AWS SDK pour .NET**  <a name="GS_ExampleDeleteArchiveDotNet"></a>

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

namespace glacier.amazon.com.rproxy.govskope.ca.docsamples
{
  class ArchiveDeleteHighLevel_GettingStarted
  {
    static string vaultName = "examplevault";
    static string archiveId = "*** Provide archive ID ***";

    public static void Main(string[] args)
    {
      try
      {
        var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2);
        manager.DeleteArchive(vaultName, archiveId);
      }
      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();
    }
  }
}
```

# Supprimer une archive dans Amazon Glacier à l'aide du AWS CLI
<a name="getting-started-delete-archive-cli"></a>

Vous pouvez supprimer des archives dans Amazon Glacier en utilisant le AWS Command Line Interface (AWS CLI).

**Topics**
+ [(Prérequis) Configuration du AWS CLI](#Creating-Vaults-CLI-Setup)
+ [Exemple : suppression d'une archive à l'aide du AWS CLI](#getting-started-Deleting-Archives-CLI-Implementation)

## (Prérequis) Configuration du AWS CLI
<a name="Creating-Vaults-CLI-Setup"></a>

1. Téléchargez et configurez l’interface AWS CLI. Pour obtenir des instructions, consultez les rubriques suivantes dans le *Guide de l’utilisateur de l’interface AWS Command Line Interface * : 

    [Installation du AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) 

   [Configuration du AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)

1. Vérifiez votre AWS CLI configuration en saisissant les commandes suivantes à l'invite de commande. Ces commandes ne fournissent pas directement d'informations d'identification, par conséquent ce sont les informations du profil par défaut qui sont utilisées.
   + Essayez d'utiliser la commande help.

     ```
     aws help
     ```
   + Pour obtenir la liste des coffres-forts Amazon Glacier sur le compte configuré, utilisez la `list-vaults` commande. *123456789012*Remplacez-le par votre Compte AWS identifiant.

     ```
     aws glacier list-vaults --account-id 123456789012
     ```
   + Pour voir les données de configuration actuelles pour le AWS CLI, utilisez la `aws configure list` commande.

     ```
     aws configure list
     ```

## Exemple : suppression d'une archive à l'aide du AWS CLI
<a name="getting-started-Deleting-Archives-CLI-Implementation"></a>

1. Utilisez la commande `initiate-job` pour démarrer une tâche d’extraction d'inventaire. Pour plus d'informations sur la commande `initiate-job`, consultez [Lancement d'une tâche](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-initiate-job-post.html).

   ```
   aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters "{\"Type\": \"inventory-retrieval\"}"
   ```

    Sortie attendue :

   ```
   {
       "location": "/111122223333/vaults/awsexamplevault/jobs/*** jobid ***", 
       "jobId": "*** jobid ***"
   }
   ```

1. Utilisez la commande `describe-job` pour vérifier le statut de la tâche d'extraction précédente. Pour plus d'informations sur la commande `describe-job`, consultez [Description d'une tâche](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-describe-job-get.html).

   ```
   aws glacier describe-job --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid ***
   ```

    Sortie attendue :

   ```
   {
       "InventoryRetrievalParameters": {
           "Format": "JSON"
       }, 
       "VaultARN": "*** vault arn ***", 
       "Completed": false, 
       "JobId": "*** jobid ***", 
       "Action": "InventoryRetrieval", 
       "CreationDate": "*** job creation date ***", 
       "StatusCode": "InProgress"
   }
   ```

1. Attendez que la tâche soit terminée.

   Vous devez attendre que la sortie de la tâche soit prête pour pouvoir effectuer le téléchargement. Si vous avez défini une configuration de notification sur le coffre-fort ou si vous avez spécifié une rubrique Amazon Simple Notification Service (Amazon SNS) lorsque vous avez lancé la tâche, Amazon Glacier envoie un message à la rubrique une fois la tâche terminée. 

   Vous pouvez définir la configuration des notifications pour des événements spécifiques concernant le coffre. Pour de plus amples informations, veuillez consulter [Configuration des notifications de coffre-fort dans Amazon Glacier](configuring-notifications.md). Amazon Glacier envoie un message à la rubrique Amazon SNS spécifiée chaque fois que l'événement spécifique se produit.

1. Une fois la tâche terminée, utilisez la commande `get-job-output` pour télécharger la tâche d'extraction dans le fichier `output.json`. Pour plus d'informations sur la commande `get-job-output`, consultez [Obtention de la sortie d'une tâche](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-job-output-get.html).

   ```
   aws glacier get-job-output --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid *** output.json
   ```

   Cette commande produit un fichier avec les champs suivants.

   ```
   {
   "VaultARN":"arn:aws:glacier:region:111122223333:vaults/awsexamplevault",
   "InventoryDate":""*** job completion date ***"",
   "ArchiveList":[{
   {"ArchiveId":""*** archiveid ***"",
   "ArchiveDescription":"*** archive description (if set) ***",
   "CreationDate":""*** archive creation date ***"",
   "Size":""*** archive size (in bytes) ***"",
   "SHA256TreeHash":"*** archive hash ***"
   }],
   "ArchiveId": 123456789
   
   }
   ```

1. Utilisez la commande `delete-archive` pour supprimer chaque archive d'un coffre jusqu'à ce qu'il n’en reste aucune.

   ```
   aws glacier delete-archive --vault-name awsexamplevault --account-id 111122223333 --archive-id="*** archiveid ***"
   ```

 Pour plus d'informations sur la commande `delete-archive`, consultez [Suppression d'une archive](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-delete.html).

# Étape 6 : supprimer un coffre-fort dans Amazon Glacier
<a name="getting-started-delete-vault"></a>

Un coffre-fort est un conteneur pour le stockage d'archives. Pour supprimer un coffre-fort Amazon Glacier, vous devez d'abord supprimer toutes les archives existantes dans le coffre-fort depuis le dernier inventaire calculé par Amazon Glacier.

Vous pouvez supprimer un coffre-fort par programmation ou à l'aide de la console Amazon Glacier. Pour plus d'informations sur la suppression d'un coffre par programme, consultez la page [Supprimer un coffre-fort dans Amazon Glacier](deleting-vaults.md).

**Important**  
Si vous avez chargé une archive sur un coffre ou supprimé une archive d'un coffre au cours des dernières 24 heures, vous devez attendre que le dernier inventaire du coffre soit mis à jour avant qu'il affiche les informations les plus récentes. Amazon Glacier prépare régulièrement un inventaire pour chaque coffre, toutes les 24 heures.

**Pour supprimer un coffre vide**

1. Connectez-vous à la console Amazon Glacier AWS Management Console et ouvrez-la [https://console.aws.amazon.com/glacier/chez](https://console.aws.amazon.com/glacier/home) vous.

1. Dans le menu **Sélectionnez une région**, choisissez Région AWS le coffre que vous souhaitez supprimer.

   Dans cet exercice de démarrage, l'exemple de coffre se trouve dans la région USA Ouest (Oregon).

1. Sélectionnez la case d'option située en regard du coffre vide que vous souhaitez supprimer. Si le coffre n'est pas vide, vous devez supprimer toutes les archives avant de supprimer le coffre. Pour de plus amples informations, veuillez consulter [Supprimer une archive dans Amazon Glacier](deleting-an-archive.md). 
**Important**  
La suppression d'un coffre ne peut pas être annulée. 

1. Sélectionnez **Delete (Supprimer)**. 

1. La boîte de dialogue **Supprimer le coffre** s'affiche. Sélectionnez **Delete (Supprimer)**.

**Pour supprimer un coffre non vide**

1. Si vous supprimez un coffre non vide, vous devez d'abord supprimer toutes les archives qu'il contient. Vous pouvez le faire en écrivant du code pour effectuer une demande de suppression d'archive à l'aide de l'API REST, du AWS SDK pour Java, du AWS SDK pour .NET ou du AWS CLI. Pour plus d'informations sur la suppression d'archives, consultez la section [Étape 5 : Supprimer une archive d'un coffre-fort dans Amazon Glacier](getting-started-delete-archive.md). 

1. Après avoir vidé le coffre, suivez les étapes permettant de supprimer un coffre vide dans la procédure précédente. 

# Comment procéder ensuite ?
<a name="getting-started-where-do-i-go-next"></a>

Maintenant que vous avez essayé l'exercice de démarrage, vous pouvez explorer les sections suivantes pour en savoir plus sur Amazon Glacier.

 
+ [Utilisation des coffres-forts dans Amazon Glacier](working-with-vaults.md)
+ [Utilisation des archives dans Amazon Glacier](working-with-archives.md)