**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](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'accepte plus de nouveaux clients. 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](https://aws.amazon.com/s3/storage-classes/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](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). 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. # Génération de sortie de tâche (GET output) ## Description Cette opération télécharge la sortie de la tâche que vous avez lancée à l'aide de l'opération [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md). Selon le type de tâche que vous avez spécifié lors du lancement de la tâche, la sortie représente le contenu d'une archive ou d'un inventaire de coffre. Vous pouvez télécharger la totalité de la sortie d'une tâche ou une partie seulement de la sortie en spécifiant une plage d'octets. Pour les tâches d'extraction d'archive et les tâches d'extraction d'inventaire, vous devez comparer la taille téléchargée à la taille renvoyée dans les en-têtes de la réponse **Génération de sortie de tâche**. Pour les tâches d'extraction d'archive, vous devez également vérifier que la taille obtenue est conforme à ce que vous aviez prévu. Si vous téléchargez une partie de la sortie, la taille prévue est basée sur la plage d'octets que vous avez spécifiée. Par exemple, si vous spécifiez la plage `bytes=0-1048575`, vous devez vérifier que la taille de votre téléchargement est 1 048 576 octets. Si vous téléchargez une archive complète, la taille attendue est la taille de l'archive lorsque vous l'avez chargée sur Amazon Glacier (Amazon Glacier). La taille prévue est également renvoyée dans les en-têtes de la réponse **Génération de sortie de tâche**. Dans le cas d'une tâche de récupération d'archives, en fonction de la plage d'octets que vous spécifiez, Amazon Glacier renvoie la somme de contrôle pour la partie des données. Afin de vous assurer que la partie téléchargée est correcte, calculez le total de contrôle sur le client et vérifiez que les valeurs correspondent et que la taille est conforme à ce que vous aviez prévu. Un identifiant de tâche n'expire pas pendant au moins 24 heures après qu'Amazon Glacier ait terminé la tâche. En d'autres termes, vous pouvez télécharger le résultat de la tâche dans les 24 heures suivant la fin de la tâche par Amazon Glacier. ## Requêtes ### Syntaxe Pour extraire une sortie de tâche, vous envoyez la demande HTTP `GET` à l'URI de la sortie `output` de la tâche spécifique. ``` 1. GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Range: ByteRangeToRetrieve 6. x-amz-glacier-version: 2012-06-01 ``` **Note** La `AccountId` valeur est l' Compte AWS ID du compte propriétaire du coffre-fort. Vous pouvez spécifier un Compte AWS identifiant ou éventuellement un seul « `-` » (trait d'union), auquel cas Amazon Glacier utilise l' Compte AWS identifiant associé aux informations d'identification utilisées pour signer la demande. Si vous utilisez un ID de compte, évitez d'y inclure des traits d'union (« - »). ### Paramètres de demande Cette opération n'utilise pas les paramètres de demande. ### En-têtes de demande Cette opération utilise les en-têtes de demande suivants, en plus de ceux communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez [En-têtes de demande communs](api-common-request-headers.md). | Nom | Description | Obligatoire | | --- | --- | --- | | Range | Plage d'octets à extraire de la sortie. Par exemple, si vous souhaitez télécharger les 1 048 576 premiers octets, spécifiez la plage `bytes=0-1048575`. Pour plus d'informations, consultez le document [Range Header Field Definition](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35). La plage est relative par rapport à n'importe quelle plage spécifiée dans la demande de lancement de tâche. Par défaut, cette opération télécharge la totalité de la sortie. Si la sortie de la tâche est volumineuse, vous pouvez utiliser l'en-tête de demande `Range` pour extraire une partie de la sortie. Cela vous permet de télécharger la totalité de la sortie en blocs d'octets plus petits. Imaginons par exemple que vous souhaitiez télécharger une sortie de tâche de 1 Go et que vous décidiez d'effectuer ce téléchargement par blocs de 128 Mo via huit demandes de génération de sortie de tâche au total. Vous allez utiliser le processus suivant pour télécharger la sortie de la tâche : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/amazonglacier/latest/dev/api-job-output-get.html) Type : Chaîne Par défaut : aucun Contraintes: Aucune | Non | ### Corps de la requête Cette opération n'a pas de corps de demande. ## Réponses ### Syntaxe Pour une demande d'extraction qui renvoie toutes les données d'une tâche, la réponse de la sortie de tâche renvoie le code de réponse `200 OK`. Lorsqu'un contenu partiel est demandé, par exemple, si vous avez spécifié l'en-tête `Range` dans la demande, le code de réponse `206 Partial Content` est renvoyé. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: ContentType 5. Content-Length: Length 6. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier 7. 8. [Body containing job output.] ``` ### En-têtes de réponse | En-tête | Description | | --- | --- | | Content-Range | La plage d'octets renvoyée par Amazon Glacier. Si seule une partie de la sortie est téléchargée, la réponse fournit la plage d'octets renvoyée par Amazon Glacier. Par exemple, `bytes 0-1048575/8388608` renvoie le premier bloc de 1 Mo des 8 Mo. Pour plus d'informations sur l'en-tête `Content-Range`, consultez le document [Content-Range Header Field Definition](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Type : Chaîne | | Content-Type | L'en-tête Content-Type varie selon que la sortie de tâche est une archive ou un inventaire de coffre. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/amazonglacier/latest/dev/api-job-output-get.html) Type : Chaîne | | x-amz-sha256-tree-hash​ | Somme de contrôle des données dans la réponse. Cet en-tête est renvoyé uniquement lors de l'extraction de la sortie pour une tâche d'extraction d'archive. En outre, cet en-tête s'affiche lorsque la plage de données extraite demandée dans la demande de lancement de tâche est alignée avec le hachage d'arborescence et que la plage à télécharger demandée dans la demande de génération de sortie de tâche est également alignée avec le hachage d'arborescence. Pour plus d'informations sur les plages alignées avec le hachage d'arborescence, consultez la section [Réception des totaux de contrôle lors du téléchargement de données](checksum-calculations-range.md). Par exemple, si dans votre demande de lancement de tâche, vous avez spécifié une plage à extraire qui est alignée avec le hachage d'arborescence (incluant la totalité de l'archive), vous recevrez le total de contrôle des données que vous téléchargez dans les conditions suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/amazonglacier/latest/dev/api-job-output-get.html) Type : Chaîne | ### Corps de la réponse Amazon Glacier renvoie le résultat de la tâche dans le corps de la réponse. Selon le type de tâche spécifié, la sortie représente un contenu d'archive ou un inventaire de coffre. Dans le cas d'un inventaire de coffre, par défaut, la liste de l'inventaire est renvoyée sous la forme du corps JSON suivant. ``` 1. { 2. "VaultARN": String, 3. "InventoryDate": String, 4. "ArchiveList": [ 5. {"ArchiveId": String, 6. "ArchiveDescription": String, 7. "CreationDate": String, 8. "Size": Number, 9. "SHA256TreeHash": String 10. }, 11. ... 12. ] 13. } ``` Si vous avez spécifié le format de sortie CSV lors du lancement de la tâche d'inventaire de coffre, l'inventaire de coffre est renvoyé au format CSV dans le corps. Le format CSV comporte cinq colonnes ArchiveId « », ArchiveDescription « », CreationDate « Size » et « SHA256 TreeHash » avec les mêmes définitions que les champs JSON correspondants. **Note** Dans le format CSV renvoyé, la totalité du contenu de certains champs renvoyés peut être placé entre guillemets. Les champs renvoyés qui contiennent une virgule ou des guillemets sont toujours placés entre guillemets. Par exemple, `my archive description,1` est renvoyé comme suit : `"my archive description,1"`. Les guillemets présents dans les champs renvoyés entre guillemets sont *placés dans une séquence d'échappement* et précédés d'une barre oblique inverse. Par exemple, `my archive description,1"2` est renvoyé comme suit : `"my archive description,1\"2"` et `my archive description,1\"2` est renvoyé comme suit : `"my archive description,1\\"2"`. La barre oblique inverse n'est pas placée dans une séquence d'échappement. Le corps de réponse JSON contient les champs JSON suivants. **ArchiveDescription** Description d'une archive. *Type* : chaîne **ArchiveId** ID d'une archive. *Type* : chaîne **ArchiveList** Tableau de métadonnées d'archive. Chaque objet du tableau représente les métadonnées d'une archive contenue dans le coffre. *Type* : tableau **CreationDate** Date et heure de création de l'archive, exprimées en heure UTC (temps universel coordonné). *Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`. **InventoryDate** Date et heure UTC du dernier inventaire du coffre réalisé après que des modifications aient été apportées à celui-ci. Même si Amazon Glacier prépare un inventaire du coffre une fois par jour, la date d'inventaire n'est mise à jour que s'il y a eu des ajouts ou des suppressions d'archives dans le coffre depuis le dernier inventaire. *Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`. **SHA256TreeHash** Hachage d'arborescence de l'archive. *Type* : chaîne **Taille** Taille de l'archive, exprimée en octets. *Type* : nombre **VaultARN** Amazon Resource Name (ARN) à partir duquel l'extraction d'archive a été demandée. *Type* : chaîne ### Erreurs Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultez[Réponses d’erreur](api-error-responses.md). ## Exemples L'exemple suivant illustre une demande de tâche visant à extraire une archive. ### Exemple 1 : Téléchargement d'une sortie Cet exemple extrait les données préparées par Amazon Glacier en réponse à votre demande de lancement d'une tâche de récupération d'archives. #### Exemple de requête ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### Exemple de réponse Voici un exemple de réponse à une tâche d'extraction d'archive. Notez que l'en-tête `Content-Type` est `application/octet-stream` et que l'en-tête `x-amz-sha256-tree-hash` est inclus dans la réponse, ce qui signifie que toutes les données de la tâche sont renvoyées. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 4. Date: Wed, 10 Feb 2017 12:00:00 GMT 5. Content-Type: application/octet-stream 6. Content-Length: 1048576 7. 8. [Archive data.] ``` Voici un exemple de réponse à une tâche d'extraction d'inventaire. Notez que l'en-tête `Content-Type` est `application/json`. Notez également que l'en-tête `x-amz-sha256-tree-hash` ne figure pas dans la réponse. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 906 6. 7. { 8. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault", 9. "InventoryDate": "2011-12-12T14:19:01Z", 10. "ArchiveList": [ 11. { 12. "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA", 13. "ArchiveDescription": "my archive1", 14. "CreationDate": "2012-05-15T17:19:46.700Z", 15. "Size": 2140123, 16. "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62" 17. }, 18. { 19. "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA", 20. "ArchiveDescription": "my archive2", 21. "CreationDate": "2012-05-15T17:21:39.339Z", 22. "Size": 2140123, 23. "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3" 24. } 25. ] 26. } ``` ### Exemple 2 : Téléchargement d'une sortie partielle Cet exemple ne récupère qu'une partie de l'archive préparée par Amazon Glacier en réponse à votre demande initiale de récupération d'archives. La demande utilise l'en-tête `Range` facultatif pour extraire uniquement les 1 024 premiers octets. #### Exemple de requête ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Range: bytes=0-1023 5. x-amz-glacier-version: 2012-06-01 6. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### Exemple de réponse La réponse positive suivante contient la réponse `206 Partial Content`. Dans ce cas, la réponse inclut également un `Content-Range` en-tête qui indique la plage d'octets renvoyée par Amazon Glacier. ``` 1. HTTP/1.1 206 Partial Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range: bytes 0-1023/8388608 5. Content-Type: application/octet-stream 6. Content-Length: 1024 7. 8. [Archive data.] ``` ## Sections connexes + [Description de la tâche (GET JobID)](api-describe-job-get.md) + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) + [Identity and Access Management pour Amazon Glacier](security-iam.md)