Téléchargement d'un inventaire de coffre-fort dans Amazon Glacier - Amazon Glacier
A propos de l'inventaire

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

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-fort dans Amazon Glacier

Une fois que vous avez chargé votre première archive dans votre coffre-fort, Amazon Glacier (Amazon Glacier) crée automatiquement un inventaire du coffre-fort, puis le met à jour environ une fois par jour. Une fois qu'Amazon Glacier a créé le premier inventaire, il faut généralement une demi-journée et jusqu'à un jour avant que ce stock ne soit disponible pour être extrait. Vous pouvez récupérer l'inventaire d'un coffre auprès d'Amazon Glacier en suivant le processus en deux étapes suivant :

  1. Lancez une tâche d'extraction d'inventaire à l'aide de l'opération Lancement d'une tâche (POST jobs).

    Important

    Une stratégie d'extraction de données peut entraîner l'échec de votre demande de lancement de tâche d'extraction et générer une exception PolicyEnforcedException. Pour plus d'informations sur les stratégies d'extraction de données, consultez la section Politiques de récupération des données Amazon Glacier. Pour plus d'informations sur l'exception PolicyEnforcedException, consultez la section Réponses d’erreur.

  2. Une fois la tâche terminée, téléchargez les octets à l'aide de l'opération Génération de sortie de tâche (GET output).

Par exemple, l'extraction d'une archive ou d'un inventaire de stock implique le lancement d'une tâche d'extraction en premier lieu. La demande de tâche est exécutée de façon asynchrone. Lorsque vous lancez une tâche de récupération, Amazon Glacier crée une tâche et renvoie un identifiant de tâche dans la réponse. Lorsque Amazon Glacier a terminé la tâche, vous pouvez obtenir le résultat de la tâche, les octets d'archive ou les données d'inventaire du coffre-fort.

Pour recevoir la sortie de la tâche, la tâche doit être terminée. Pour déterminer l'état de la tâche, vous disposez des options suivantes :

  • Attendre la notification de fin de la tâche : vous pouvez spécifier une rubrique Amazon Simple Notification Service (Amazon SNS) sur laquelle Amazon Glacier pourra publier une notification une fois la tâche terminée. Vous pouvez spécifier une rubrique Amazon SNS en employant l'une des méthodes suivantes :

    • Spécifiez une rubrique Amazon SNS par tâche.

      Lorsque vous lancez une tâche, vous avez la possibilité de spécifier une rubrique Amazon SNS.

    • Définissez la configuration des notifications pour le coffre.

      Vous pouvez définir une configuration de notifications pour des événements spécifiques liés au coffre (consultez Configuration des notifications de coffre-fort dans Amazon Glacier). Amazon Glacier envoie un message à la rubrique SNS spécifiée chaque fois que l'événement spécifique se produit.

    Si la configuration des notifications est définie dans le coffre et que vous spécifiez également une rubrique Amazon SNS lorsque vous lancez une tâche, Amazon Glacier envoie un message de fin de tâche aux deux rubriques.

    Vous pouvez configurer la rubrique SNS de sorte qu'elle vous envoie une notification par e-mail ou qu'elle stocke le message dans une file d'attente Amazon Simple Queue Service (Amazon SQS) que votre application peut interroger. Lorsqu'un message apparaît dans la file d'attente, vous pouvez vérifier si la tâche s'est correctement achevée, puis télécharger la sortie correspondante.

  • Demandez des informations sur le poste de manière explicite : Amazon Glacier fournit également une description de l'opération de travail (Description de la tâche (GET JobID)) qui vous permet de demander des informations sur le poste. Vous pouvez envoyer régulièrement cette demande pour obtenir des informations sur la tâche. Toutefois, il est préférable d'utiliser des notifications Amazon SNS.

Note

Les informations que vous obtenez par le biais de la notification SNS sont identiques à celles obtenues en appelant une opération de description de tâche.

Rubriques

A propos de l'inventaire

Amazon Glacier met à jour l'inventaire d'un coffre-fort au moins une fois par jour, à compter du jour où vous chargez une archive dans le coffre-fort pour la première fois. Si aucun ajout ou aucune suppression d'archive n'a été effectué dans le coffre depuis le dernier inventaire, la date de l'inventaire n'est pas mise à jour. Lorsque vous lancez une tâche pour un inventaire de coffre-fort, Amazon Glacier renvoie le dernier inventaire généré, qui est un point-in-time instantané et non des données en temps réel. Notez qu'une fois qu'Amazon Glacier a créé le premier inventaire pour le coffre, il faut généralement une demi-journée, voire un jour, avant que cet inventaire ne soit disponible pour extraction.

Vous ne trouverez peut-être pas utile d'extraire un inventaire de coffre pour chaque chargement d'archive. Supposons toutefois que vous mainteniez une base de données côté client associant des métadonnées relatives aux archives que vous chargez sur Amazon Glacier. Ensuite, vous trouverez peut-être l'inventaire de coffre très utile pour rapprocher, au besoin, les informations contenues dans votre base de données avec l'inventaire de coffre réel. Vous pouvez limiter le nombre d'éléments de l'inventaire récupérés en filtrant par date de création de l'archive ou en définissant une limite. Pour plus d'informations sur les limites de l'extraction d'inventaire, consultez la page Extraction d'un inventaire par plage.

L'inventaire peut être retourné dans deux formats : valeurs séparées par une virgule (CSV) ou JSON. Vous avez également la possibilité de spécifier le format lorsque vous lancez la tâche d'inventaire. Le format par défaut est JSON. Pour plus d'informations sur les champs de données retournés dans un sortie de tâche d'inventaire, consultez la page Corps de la réponse de l'API d'obtention de la sortie de tâche.