**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.
# Récupération des métadonnées du coffre-fort dans Amazon Glacier
Vous pouvez extraire les informations d'un coffre telles que sa date de création, le nombre d'archives qu'il contient et la taille totale de toutes ses archives. Amazon Glacier (Amazon Glacier) fournit des appels d'API vous permettant de récupérer ces informations pour un coffre-fort spécifique ou pour tous les coffres-forts d'une AWS région spécifique dans votre compte.
Si vous récupérez une liste de coffres-forts, Amazon Glacier renvoie la liste triée en fonction des valeurs ASCII des noms de coffres-forts. La liste peut contenir jusqu'à 1 000 coffres. Vous devez toujours vérifier dans la réponse le marqueur à partir duquel poursuivre l'affichage de la liste ; s'il n'y a plus d'éléments, la valeur du champ marker est `null`. Vous pouvez éventuellement limiter le nombre de coffres renvoyés dans la réponse. S'il existe d'autres coffres que ceux renvoyés dans la réponse, le résultat est paginé. Vous devez envoyer des demandes supplémentaires afin d'extraire l'ensemble de coffres suivant.
**Topics**
+ [Récupération des métadonnées du coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour Java](retrieving-vault-info-sdk-java.md)
+ [Récupération des métadonnées du coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour .NET](retrieving-vault-info-sdk-dotnet.md)
+ [Extraction de métadonnées de coffre à l'aide de l'API REST](listing-vaults-rest-api.md)
+ [Récupération des métadonnées du coffre-fort dans Amazon Glacier à l'aide du AWS Command Line Interface](retrieving-vault-info-cli.md)
# Récupération des métadonnées du coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour Java
**Topics**
+ [Extraire des métadonnées de coffre pour un coffre](#retrieve-vault-info-sdk-java-lowlevel-one-vault)
+ [Extraire les métadonnées de coffre pour tous les coffres dans une région](#retrieve-vault-info-sdk-java-lowlevel-all-vaults)
+ [Exemple : Extraction des métadonnées d'un coffre à l'aide du kit SDK Amazon pour Java](#retrieving-vault-info-sdk-java-example)
## Extraire des métadonnées de coffre pour un coffre
Vous pouvez récupérer les métadonnées d'un coffre-fort spécifique ou de tous les coffres-forts d'une AWS région spécifique. La procédure ci-dessous détaille les étapes à suivre pour extraire les métadonnées d'un coffre spécifique à l'aide de l'API de bas niveau du kit SDK Amazon pour Java.
1. Créez une instance de la classe `AmazonGlacierClient` (le client).
Vous devez spécifier AWS la région dans laquelle se trouve le coffre. Toutes les opérations que vous effectuez à l'aide de ce client s'appliquent à cette AWS région.
1. Fournissez les informations de demande en créant une instance de la classe `DescribeVaultRequest`.
Amazon Glacier (Amazon Glacier) vous demande de fournir un nom de coffre-fort et votre numéro de compte. Si vous n'indiquez pas d'ID de compte, l'ID de compte associé aux informations d'identification que vous avez indiquées pour signer la demande est pris en compte. Pour de plus amples informations, veuillez consulter [Utilisation du AWS SDK pour Java avec Amazon Glacier](using-aws-sdk-for-java.md).
1. Exécutez la méthode `describeVault` en fournissant l'objet de demande comme paramètre.
Les informations de métadonnées du coffre renvoyées par Amazon Glacier sont disponibles dans l'`DescribeVaultResult`objet.
L'extrait de code Java suivant illustre les étapes précédentes.
```
DescribeVaultRequest request = new DescribeVaultRequest()
.withVaultName("*** provide vault name***");
DescribeVaultResult result = client.describeVault(request);
System.out.print(
"\nCreationDate: " + result.getCreationDate() +
"\nLastInventoryDate: " + result.getLastInventoryDate() +
"\nNumberOfArchives: " + result.getNumberOfArchives() +
"\nSizeInBytes: " + result.getSizeInBytes() +
"\nVaultARN: " + result.getVaultARN() +
"\nVaultName: " + result.getVaultName());
```
**Note**
Pour obtenir des informations sur l'API REST sous-jacente, consultez la section [Description de coffre (GET vault)](api-vault-get.md).
## Extraire les métadonnées de coffre pour tous les coffres dans une région
Vous pouvez également utiliser `listVaults` cette méthode pour récupérer les métadonnées de tous les coffres-forts d'une AWS région spécifique.
L'extrait de code Java suivant extrait la liste des coffres dans la région `us-west-2`. La demande limite à 5 le nombre de coffres renvoyés dans la réponse. L'extrait de code effectue ensuite une série d'`listVaults`appels pour récupérer la liste complète des coffres-forts dans la AWS région.
```
AmazonGlacierClient client;
client.setEndpoint("https://glacier.us-west-2.amazonaws.com/");
String marker = null;
do {
ListVaultsRequest request = new ListVaultsRequest()
.withLimit("5")
.withMarker(marker);
ListVaultsResult listVaultsResult = client.listVaults(request);
List vaultList = listVaultsResult.getVaultList();
marker = listVaultsResult.getMarker();
for (DescribeVaultOutput vault : vaultList) {
System.out.println(
"\nCreationDate: " + vault.getCreationDate() +
"\nLastInventoryDate: " + vault.getLastInventoryDate() +
"\nNumberOfArchives: " + vault.getNumberOfArchives() +
"\nSizeInBytes: " + vault.getSizeInBytes() +
"\nVaultARN: " + vault.getVaultARN() +
"\nVaultName: " + vault.getVaultName());
}
} while (marker != null);
```
Dans le segment de code précédent, si vous ne spécifiez pas la `Limit` valeur dans la demande, Amazon Glacier renvoie jusqu'à 10 coffres-forts, tels que définis par l'API Amazon Glacier. Si un plus grand nombre de coffres doivent figurer dans la liste, le champ `marker` de la réponse contient l'Amazon Resource Name (ARN) du coffre à partir duquel vous pouvez poursuivre la liste avec une nouvelle demande. Si tel n'est pas le cas, le champ `marker` est null.
Notez que les informations renvoyées pour chaque coffre de la liste sont identiques à celles que vous obtenez en appelant la méthode `describeVault` pour un coffre spécifique.
**Note**
La méthode `listVaults` appelle l'API REST sous-jacente (consultez [Affichage des coffres (GET vaults)](api-vaults-get.md)).
## Exemple : Extraction des métadonnées d'un coffre à l'aide du kit SDK Amazon pour Java
Pour obtenir un exemple de code pratique, consultez la section [Exemple : création d'un coffre-fort à l'aide du AWS SDK pour Java](creating-vaults-sdk-java.md#creating-vaults-sdk-java-example). L'exemple de code Java crée un coffre et extrait les métadonnées de celui-ci.
# Récupération des métadonnées du coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour .NET
**Topics**
+ [Extraire des métadonnées de coffre pour un coffre](#retrieve-vault-info-sdk-dotnet-lowlevel-one-vault)
+ [Extraire les métadonnées de coffre pour tous les coffres dans une région](#retrieve-vault-info-sdk-dotnet-lowlevel-all-vaults)
+ [Exemple : extraction des métadonnées du coffre-fort à l'aide de l'API de bas niveau du AWS SDK pour .NET](#creating-vaults-sdk-dotnet-example)
## Extraire des métadonnées de coffre pour un coffre
Vous pouvez récupérer les métadonnées d'un coffre-fort spécifique ou de tous les coffres-forts d'une AWS région spécifique. Voici les étapes d'extraction de métadonnées de coffre pour un coffre spécifique à l'aide de l'API de bas niveau du kit AWS SDK pour .NET.
1. Créez une instance de la classe `AmazonGlacierClient` (le client).
Vous devez spécifier AWS la région dans laquelle se trouve le coffre. Toutes les opérations que vous effectuez à l'aide de ce client s'appliquent à cette AWS région.
1. Fournissez les informations de demande en créant une instance de la classe `DescribeVaultRequest`.
Amazon Glacier (Amazon Glacier) vous demande de fournir un nom de coffre-fort et votre numéro de compte. Si vous n'indiquez pas d'ID de compte, l'ID de compte associé aux informations d'identification que vous avez indiquées pour signer la demande est pris en compte. Pour de plus amples informations, veuillez consulter [Utilisation du AWS SDK pour .NET avec Amazon Glacier](using-aws-sdk-for-dot-net.md).
1. Exécutez la méthode `DescribeVault` en fournissant l'objet de demande comme paramètre.
Les informations de métadonnées du coffre renvoyées par Amazon Glacier sont disponibles dans l'`DescribeVaultResult`objet.
L'extrait de code C\$1 suivant illustre les étapes précédentes. L'extrait de code extrait les informations de métadonnées d'un coffre existant dans la région USA Ouest (Oregon).
```
AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);
DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest()
{
VaultName = "*** Provide vault name ***"
};
DescribeVaultResponse describeVaultResponse = client.DescribeVault(describeVaultRequest);
Console.WriteLine("\nVault description...");
Console.WriteLine(
"\nVaultName: " + describeVaultResponse.VaultName +
"\nVaultARN: " + describeVaultResponse.VaultARN +
"\nVaultCreationDate: " + describeVaultResponse.CreationDate +
"\nNumberOfArchives: " + describeVaultResponse.NumberOfArchives +
"\nSizeInBytes: " + describeVaultResponse.SizeInBytes +
"\nLastInventoryDate: " + describeVaultResponse.LastInventoryDate
);
```
**Note**
Pour obtenir des informations sur l'API REST sous-jacente, consultez la section [Description de coffre (GET vault)](api-vault-get.md).
## Extraire les métadonnées de coffre pour tous les coffres dans une région
Vous pouvez également utiliser `ListVaults` cette méthode pour récupérer les métadonnées de tous les coffres-forts d'une AWS région spécifique.
L'extrait de code C\$1 suivant extrait la liste des coffres de la région USA Ouest (Oregon). La demande limite à 5 le nombre de coffres renvoyés dans la réponse. L'extrait de code effectue ensuite une série d'`ListVaults`appels pour récupérer la liste complète des coffres-forts dans la AWS région.
```
AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);
string lastMarker = null;
Console.WriteLine("\n List of vaults in your account in the specific AWS Region ...");
do
{
ListVaultsRequest request = new ListVaultsRequest()
{
Limit = 5,
Marker = lastMarker
};
ListVaultsResponse response = client.ListVaults(request);
foreach (DescribeVaultOutput output in response.VaultList)
{
Console.WriteLine("Vault Name: {0} \tCreation Date: {1} \t #of archives: {2}",
output.VaultName, output.CreationDate, output.NumberOfArchives);
}
lastMarker = response.Marker;
} while (lastMarker != null);
```
Dans le segment de code précédent, si vous ne spécifiez pas la `Limit` valeur dans la demande, Amazon Glacier renvoie jusqu'à 10 coffres-forts, tels que définis par l'API Amazon Glacier.
Notez que les informations renvoyées pour chaque coffre de la liste sont identiques à celles que vous obtenez en appelant la méthode `DescribeVault` pour un coffre spécifique.
**Note**
La méthode `ListVaults` appelle l'API REST sous-jacente (consultez [Affichage des coffres (GET vaults)](api-vaults-get.md)).
## Exemple : extraction des métadonnées du coffre-fort à l'aide de l'API de bas niveau du AWS SDK pour .NET
Pour obtenir un exemple de code pratique, consultez la section [Exemple : opérations de coffre-fort à l'aide de l'API de bas niveau du AWS SDK pour .NET](creating-vaults-dotnet-sdk.md#vault-operations-example-dotnet-lowlevel). L'exemple de code C\$1 crée un coffre et extrait les métadonnées de coffre.
# Extraction de métadonnées de coffre à l'aide de l'API REST
Pour afficher les coffres à l'aide de l'API REST, consultez la section [Affichage des coffres (GET vaults)](api-vaults-get.md). Pour décrire un coffre, consultez la section [Description de coffre (GET vault)](api-vault-get.md).
# Récupération des métadonnées du coffre-fort dans Amazon Glacier à l'aide du AWS Command Line Interface
Cet exemple montre comment récupérer les informations et les métadonnées du coffre-fort dans Amazon Glacier (Amazon Glacier) à l'aide du AWS Command Line Interface (AWS CLI).
**Topics**
+ [(Prérequis) Configuration du AWS CLI](#Creating-Vaults-CLI-Setup)
+ [Exemple : extraction des métadonnées du coffre-fort à l'aide du AWS CLI](#Retrieving-Vault-Metadata-CLI-Implementation)
## (Prérequis) Configuration du AWS CLI
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 : extraction des métadonnées du coffre-fort à l'aide du AWS CLI
+ Utilisez la `describe-vault` commande pour décrire un coffre-fort nommé *awsexamplevault* sous « compte *111122223333* ».
```
aws glacier describe-vault --vault-name awsexamplevault --account-id 111122223333
```