Téléchargement d'un inventaire de coffre dans Amazon S3 Glacier à l'aide de l'AWS Command Line Interface - Amazon S3 Glacier
(Prérequis) Configuration de l’AWS CLIExemple : téléchargement d'un inventaire de coffre à l'aide de l'AWS CLI

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.

Téléchargement d'un inventaire de coffre dans Amazon S3 Glacier à l'aide de l'AWS Command Line Interface

Pour télécharger un inventaire de coffre dans Amazon S3 Glacier (S3 Glacier) à l'aide de l'AWS Command Line Interface (AWS CLI), procédez comme suit.

(Prérequis) Configuration de l’AWS CLI

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

    Installation du AWS Command Line Interface

    Configuration de l'AWS Command Line Interface

  2. Vérifiez la configuration de votre interface AWS CLI 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 S3 Glacier du compte configuré, utilisez la commande list-vaults. Remplacez 123456789012 par l'ID de votre Compte AWS.

      aws glacier list-vaults --account-id 123456789012

    • Pour voir les données de configuration actuelles de l'interface AWS CLI, utilisez la commande aws configure list.

      aws configure list

Exemple : téléchargement d'un inventaire de coffre à l'aide de l'AWS CLI

  1. Utilisez la commande initiate-job pour démarrer une tâche d’extraction d'inventaire.

    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 ***"
}

  2. Utilisez la commande describe-job pour vérifier le statut de la tâche d'extraction précédente.

    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"
}

  3. Attendez que la tâche se termine.

    Vous devez attendre que la sortie de la tâche soit prête pour pouvoir effectuer le téléchargement. L'ID de tâche n'expire pas avant au moins 24 heures après que S3 Glacier a terminé la tâche. Si vous avez défini une configuration de notifications pour le coffre ou spécifié une rubrique Amazon Simple Notification Service (Amazon SNS) au moment où vous avez lancé la tâche, S3 Glacier envoie un message à cette rubrique une fois qu'il a terminé la tâche.

    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 dans Amazon S3 Glacier. S3 Glacier envoie un message à la rubrique SNS spécifiée chaque fois que les événements en question se produisent.

  4. Une fois l'opération terminée, utilisez la commande get-job-output pour télécharger le travail d’extraction dans le fichier output.json.

    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":
...
]}