Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 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 sections Classes de stockage S3 Glacier et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent Amazon S3API, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de chiffrement optionnelles avancées, etc.

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.

Extraction des métadonnées d'un coffre dans Amazon S3 Glacier à l'aide de l'AWS SDK for Java

Extraire des métadonnées de coffre pour un coffre

Vous pouvez extraire les métadonnées d'un coffre spécifique ou de tous les coffres d'une région AWS 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.

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());

Extraire les métadonnées de coffre pour tous les coffres dans une région

Vous pouvez également utiliser la méthode listVaults pour extraire les métadonnées de tous les coffres d'une région AWS 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'appels listVaults pour extraire la liste de tous les coffres de la région AWS.

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 valeur de Limit dans la demande, S3 Glacier renvoie jusqu'à 10 coffres, tel que défini par l'API S3 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.

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 à l'aide de l’AWS SDK for Java. L'exemple de code Java crée un coffre et extrait les métadonnées de celui-ci.