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

Cette page s'adresse uniquement aux clients existants du service S3 Glacier utilisant Vaults et l'API REST d'origine datant 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 l'API Amazon S3, 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

Une fois que vous avez chargé votre première archive sur le coffre, Amazon S3 Glacier (S3 Glacier) crée automatiquement un inventaire du coffre et le met ensuite à jour environ une fois par jour. Une fois que S3 Glacier a créé le premier inventaire, il faut généralement attendre entre une demi-journée et une journée complète avant de pouvoir extraire cet inventaire. Vous pouvez extraire un inventaire de coffre de S3 Glacier en effectuant les deux étapes suivantes :

  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 d'extraction de données S3 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 d'extraction, S3 Glacier crée une tâche et renvoie un ID de tâche dans la réponse. Une fois que S3 Glacier a terminé la tâche, vous pouvez obtenir la sortie correspondante, les octets d'archive ou les données d'inventaire du coffre.

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 tâche : vous pouvez spécifier une rubrique Amazon Simple Notification Service (AmazonSNS) sur laquelle S3 Glacier peut publier une notification une fois la tâche terminée. Vous pouvez définir le SNS sujet Amazon à l'aide des méthodes suivantes :

    • Spécifiez un SNS sujet Amazon par poste.

      Lorsque vous lancez une tâche, vous pouvez éventuellement spécifier un SNS sujet Amazon.

    • 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 dans Amazon S3 Glacier). S3 Glacier envoie un message au SNS sujet spécifié 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 SNS rubrique Amazon lorsque vous lancez une tâche, S3 Glacier envoie un message de fin de tâche aux deux rubriques.

    Vous pouvez configurer le SNS sujet pour qu'il vous avertisse par e-mail ou pour stocker le message dans un Amazon Simple Queue Service (AmazonSQS) que votre application pourra 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.

  • Demander explicitement les informations sur la tâche : S3 Glacier propose également une opération de description de tâche (Description de la tâche (GET JobID)) qui vous permet de demander des informations sur la tâche. Vous pouvez envoyer régulièrement cette demande pour obtenir des informations sur la tâche. Cependant, l'utilisation SNS des notifications Amazon est l'option recommandée.

Note

Les informations que vous recevez par SNS notification sont les mêmes que celles que vous obtenez en appelant Describe Job.

Rubriques

A propos de l'inventaire

S3 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, S3 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 que S3 Glacier a créé le premier inventaire pour le coffre, il faut généralement attendre entre une demi-journée et une journée complète avant de pouvoir extraire cet inventaire.

Vous ne trouverez peut-être pas utile d'extraire un inventaire de coffre pour chaque chargement d'archive. Cependant, supposez que vous tenez à jour une base de données côté client associant des métadonnées sur les archives que vous chargez sur S3 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 renvoyé sous deux formats : valeurs séparées par des virgules (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 estJSON. Pour plus d'informations sur les champs de données renvoyés dans la sortie d'une tâche d'inventaire, consultez Corps de la réponse la section Get Job Output API.