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
Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'acceptera plus de nouveaux clients à compter du 15 décembre 2025, sans aucune incidence sur les clients existants. 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
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 à l'aide du AWS SDK pour Java
Rubriques
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.
-
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.
-
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.
-
Exécutez la méthode
describeVaulten 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'
DescribeVaultResultobjet.
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).
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'listVaultsappels 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<DescribeVaultOutput> 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)).
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. L'exemple de code Java crée un coffre et extrait les métadonnées de celui-ci.