**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.
# Lancement d'une tâche (POST jobs)
Cette opération lance les types de tâches Amazon Glacier (Amazon Glacier) suivants :
+ `archive-retrieval` : extrait une archive
+ `inventory-retrieval` : inventorie un coffre
**Topics**
+ [Initialisation d'une tâche d'extraction d'archive ou d'inventaire de coffre](#api-initiate-job-post-description)
+ [Requêtes](#api-initiate-job-post-requests)
+ [Réponses](#api-initiate-job-post-responses)
+ [Exemples](#api-initiate-job-post-examples)
+ [Sections connexes](#more-info-api-initiate-job-post)
## Initialisation d'une tâche d'extraction d'archive ou d'inventaire de coffre
L'extraction d'une archive ou d'un inventaire de coffre sont des opérations asynchrones qui exigent que vous lanciez une tâche. Une fois lancée, la tâche ne peut pas être annulée. L'extraction est un processus en deux étapes :
1. Initiez une tâche d'extraction à l'aide de l'opération [Lancement d'une tâche (POST jobs)](#api-initiate-job-post).
**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 `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](data-retrieval-policy.md). Pour plus d'informations sur l'exception `PolicyEnforcedException`, consultez la section [Réponses d’erreur](api-error-responses.md).
1. 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)](api-job-output-get.md).
La demande d'extraction est exécutée de manière asynchrone. Lorsque vous lancez une tâche d’extraction, Amazon Glacier crée une tâche et renvoie un ID 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 (archives ou données d'inventaire). Pour plus d'informations sur l'obtention de la sortie de la tâche, consultez l'opération [Génération de sortie de tâche (GET output)](api-job-output-get.md).
Pour recevoir la sortie de la tâche, la tâche doit être terminée. Pour déterminer si une tâche est terminée, vous disposez des options suivantes :
+ **Utiliser une notification Amazon SNS :** vous pouvez spécifier une rubrique Amazon SNS sur laquelle Amazon Glacier peut publier une notification une fois la tâche terminée. Vous pouvez spécifier une rubrique SNS par demande de tâche. La notification n'est envoyée qu'une fois qu'Amazon Glacier a terminé le travail. En plus de spécifier une rubrique SNS par demande de tâche, vous pouvez configurer des notifications de coffre pour un coffre afin que les notifications de tâche soient envoyées pour toutes les extractions. Pour de plus amples informations, veuillez consulter [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md).
+ **Obtenir les détails de la tâche –** Vous pouvez effectuer une demande [Description de la tâche (GET JobID)](api-describe-job-get.md) pour obtenir les informations concernant le statut de la tâche pendant que celle-ci est en cours. Cependant, il est préférable d'utiliser une notification Amazon SNS pour déterminer à quel moment une tâche se termine.
**Note**
Les informations que vous obtenez via une notification sont identiques à celles que vous obtenez en appelant [Description de la tâche (GET JobID)](api-describe-job-get.md).
Si, pour un événement spécifique, vous ajoutez à la fois la configuration des notifications dans le coffre et que vous spécifiez une rubrique SNS dans votre demande de travail d'initiation, Amazon Glacier envoie les deux notifications. Pour de plus amples informations, veuillez consulter [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md).
### L'inventaire du coffre
Amazon Glacier met à jour l'inventaire d'un coffre-fort environ 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.
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. 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](api-job-output-get.md#api-job-output-get-responses-elements).
### Extraction d'un inventaire par plage
Vous pouvez limiter le nombre d'éléments dans l'inventaire en filtrant par date de création de l'archive ou en définissant une limite.
**Filtrage par la date de création de l'archive**
Vous pouvez extraire des éléments d'inventaire pour des archives créées entre la valeur de `StartDate` et la valeur de `EndDate` en spécifiant les valeurs de ces paramètres dans la demande **Lancement d'une tâche**. Les archives créées à la ou après la `StartDate` et avant la `EndDate` sont renvoyées. Si vous n'indiquez que le paramètre `StartDate` sans le paramètre `EndDate`, vous extrayez l'inventaire pour toutes les archives créées à la ou après la `StartDate`. Si vous n'indiquez que le paramètre `EndDate` sans le paramètre `StartDate`, vous recevez l'inventaire correspondant à toutes les archives créées avant la `EndDate`.
**Limitation des éléments de l'inventaire par extraction**
Vous pouvez limiter le nombre d'éléments d'inventaire renvoyés en définissant le paramètre `Limit` dans la demande **Lancement d'une tâche**. La sortie de la tâche d'inventaire contient tous les éléments d'inventaire jusqu'à la valeur `Limit` spécifiée. Si plusieurs éléments d'inventaire sont disponibles, le résultat est paginé. Une fois qu'une tâche est terminée, vous pouvez utiliser l'opération [Description de la tâche (GET JobID)](api-describe-job-get.md) pour obtenir un marqueur que vous utiliserez dans une demande **Lancement d'une tâche** ultérieure. Le marqueur indique le point de départ de l'extraction de la prochaine série d'éléments d'inventaire. Vous pouvez parcourir l'ensemble de votre inventaire en faisant des demandes de **Lancement d'une tâche** avec le marqueur de la sortie **Description de la tâche** précédente. Vous procédez ainsi jusqu'à ce que vous obteniez un marqueur de **Description de la tâche** renvoyant la valeur null, ce qui indique qu'il ne reste plus d'élément d'inventaire disponible.
Vous pouvez utiliser le paramètre `Limit` avec les paramètres de plage de dates.
### Extraction d'une plage d'archive
Vous pouvez lancer l'extraction d'une archive pour l'archive entière ou une plage de l'archive. Pour extraire une plage d'archive, vous spécifiez une plage d'octets à renvoyer ou l'archive entière. Si ce champ est spécifié, la plage d'octets doit être alignée en termes de méga-octets (1024\$11024). Autrement dit, la valeur de début de la plage doit être divisible par 1 Mo et la valeur de fin de la plage plus 1 doit être divisible par 1 Mo ou égale à la fin de l'archive. Si l'extraction de la plage de l'archive n'est pas alignée en termes de méga-octets, cette opération renvoie une réponse `400`. En outre, afin de garantir que vous obteniez les valeurs de total de contrôle pour les données que vous téléchargez à l'aide de la demande **Génération de sortie de tâche** ([Génération de sortie de tâche (GET output)](api-job-output-get.md)), la plage doit être 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).
### Niveau Rapide, Standard et Groupé
Lorsque vous lancez une tâche d'extraction d'archive, vous pouvez spécifier l'une des options suivantes dans le champ `Tier` du corps de la demande :
+ **`Expedited`** : cette option vous permet d'accéder rapidement à vos données lorsque des demandes urgentes occasionnelles de restauration d'archives sont nécessaires. Pour toutes les archives à l'exception des plus volumineuses (plus de 250 Mo), les données auxquelles vous accédez du niveau Rapide sont généralement disponibles en 1 à 5 minutes.
+ **`Standard`** : cette option vous permet d'accéder à vos archives en quelques heures. L'accès aux données à l'aide du niveau Standard est généralement rendu disponible en 3 à 5 heures. Cette option par défaut correspond aux demandes de tâches qui ne spécifient pas l'option de niveau.
+ **`Bulk`**— Le stockage en masse est le niveau le moins coûteux pour Amazon Glacier. Il vous permet de récupérer de grandes quantités, voire des pétaoctets, de données à moindre coût par jour. L'accès aux données à l'aide du niveau Groupé est généralement rendu disponible en 5 à 12 heures.
Pour plus d'informations sur les récupérations rapides et en bloc, consultez [Récupération des archives Amazon Glacier](downloading-an-archive-two-steps.md).
## Requêtes
Pour lancer une tâche, vous utilisez la méthode HTTP `POST` et limitez la portée de la demande à la sous-ressource `jobs` du coffre. Vous spécifiez les détails de la demande de tâche dans le document JSON de votre demande. Le type de tâche est spécifié dans le champ `Type`. Vous pouvez éventuellement spécifier un `SNSTopic` champ pour indiquer une rubrique Amazon SNS sur laquelle Amazon Glacier peut publier une notification une fois la tâche terminée.
**Note**
Pour publier une notification dans Amazon SNS, vous devez créer la rubrique vous-même si elle n'existe pas déjà. Amazon Glacier ne crée pas le sujet pour vous. Le sujet doit être autorisé à recevoir des publications depuis un coffre-fort Amazon Glacier. Amazon Glacier ne vérifie pas si le coffre-fort est autorisé à publier sur le sujet. Si les autorisations ne sont pas configurées de façon appropriée, vous risquez de ne pas recevoir la notification même lorsque la tâche est terminée.
### Syntaxe
Voici la syntaxe de la requête pour l'initiation d'une tâche.
```
1. POST /AccountId/vaults/VaultName/jobs HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6.
7. {
8. "jobParameters": {
9. "ArchiveId": "string",
10. "Description": "string",
11. "Format": "string",
12. "InventoryRetrievalParameters": {
13. "EndDate": "string",
14. "Limit": "string",
15. "Marker": "string",
16. "StartDate": "string"
17. },
18. "OutputLocation": {
19. "S3": {
20. "AccessControlList": [
21. {
22. "Grantee": {
23. "DisplayName": "string",
24. "EmailAddress": "string",
25. "ID": "string",
26. "Type": "string",
27. "URI": "string"
28. },
29. "Permission": "string"
30. }
31. ],
32. "BucketName": "string",
33. "CannedACL": "string",
34. "Encryption": {
35. "EncryptionType": "string",
36. "KMSContext": "string",
37. "KMSKeyId": "string"
38. },
39. "Prefix": "string",
40. "StorageClass": "string",
41. "Tagging": {
42. "string" : "string"
43. },
44. "UserMetadata": {
45. "string" : "string"
46. }
47. }
48. },
49. "RetrievalByteRange": "string",
50. "SelectParameters": {
51. "Expression": "string",
52. "ExpressionType": "string",
53. "InputSerialization": {
54. "csv": {
55. "Comments": "string",
56. "FieldDelimiter": "string",
57. "FileHeaderInfo": "string",
58. "QuoteCharacter": "string",
59. "QuoteEscapeCharacter": "string",
60. "RecordDelimiter": "string"
61. }
62. },
63. "OutputSerialization": {
64. "csv": {
65. "FieldDelimiter": "string",
66. "QuoteCharacter": "string",
67. "QuoteEscapeCharacter": "string",
68. "QuoteFields": "string",
69. "RecordDelimiter": "string"
70. }
71. }
72. },
73. "SNSTopic": "string",
74. "Tier": "string",
75. "Type": "string"
76. }
77. }
```
**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 (« - »).
### Corps de la requête
La demande accepte les données suivantes au format JSON dans le corps de la demande.
jobParameters
Fournit des options de spécification des informations d'une tâche.
*Type* : objet [jobParameters](api-jobParameters.md)
*Obligatoire* : oui
## Réponses
Amazon Glacier crée l'emploi. Dans la réponse, il retourne l'URI de la tâche.
### Syntaxe
```
1. HTTP/1.1 202 Accepted
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Location: location
5. x-amz-job-id: jobId
6. x-amz-job-output-path: jobOutputPath
```
### En-têtes de réponse
| En-tête | Description |
| --- | --- |
| Location | Le chemin d'accès par URI relatif de la tâche. Vous pouvez utiliser ce chemin d'accès par URI pour trouver l'état de la tâche. Pour de plus amples informations, veuillez consulter [Description de la tâche (GET JobID)](api-describe-job-get.md). Type : Chaîne Par défaut : aucun |
| x-amz-job-id | L'ID de la tâche. Cette valeur fait également partie de l'en-tête `Location`. Type : Chaîne Par défaut : aucun |
| x-amz-job-output-path | Chemin vers l'emplacement auquel les résultats de tâches de sélection sont stockés. Type : Chaîne Par défaut : aucun |
### Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
### Erreurs
Cette opération inclut l'erreur ou les erreurs suivantes, en plus des erreurs possibles communes à toutes les opérations Amazon Glacier. Pour plus d'informations sur les erreurs Amazon Glacier et obtenir la liste des codes d'erreur, consultez[Réponses d’erreur](api-error-responses.md).
| Code | Description | HTTP Status Code | Type |
| --- | --- | --- | --- |
| InsufficientCapacityException | Retournée s'il existe une capacité insuffisante pour traiter cette demande rapide. Cette erreur s'applique uniquement aux récupérations rapides et non aux récupérations standard ou en bloc. | 503 Service Unavailable | Serveur |
## Exemples
### Exemple de demande : Lancement d'une tâche d'extraction d'archive
```
1. POST /-/vaults/examplevault/jobs 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
6.
7. {
8. "Type": "archive-retrieval",
9. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId",
10. "Description": "My archive description",
11. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example",
12. "Tier" : "Bulk"
13. }
```
Voici un exemple de corps d'une demande qui spécifie une plage de l'archive à extraire à l'aide du champ `RetrievalByteRange`.
```
{
"Type": "archive-retrieval",
"ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId",
"Description": "My archive description",
"RetrievalByteRange": "2097152-4194303",
"SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example",
"Tier" : "Bulk"
}
```
### Exemple de réponse
```
1. HTTP/1.1 202 Accepted
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
```
### Exemple de demande : Lancement d'une tâche d'extraction d'inventaire
La demande suivante lance une tâche d'extraction d'inventaire pour obtenir une liste d'archives du coffre `examplevault`. Le paramètre `Format` défini sur `CSV` dans le corps de la demande indique que l'inventaire est renvoyé au format CSV.
```
1. POST /-/vaults/examplevault/jobs HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Content-Type: application/x-www-form-urlencoded
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
7.
8. {
9. "Type": "inventory-retrieval",
10. "Description": "My inventory job",
11. "Format": "CSV",
12. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example"
13. }
```
### Exemple de réponse
```
1. HTTP/1.1 202 Accepted
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
```
### Exemples de demandes : Initier une tâche d'extraction d'inventaire à l'aide d'un filtrage par date avec une limité définie, et demande consécutive d'extraction de la page suivante des éléments de l'inventaire.
La demande suivante lance une tâche d'extraction d'inventaire en utilisant le filtrage de dates et en définissant une limite.
```
1. {
2. "ArchiveId": null,
3. "Description": null,
4. "Format": "CSV",
5. "RetrievalByteRange": null,
6. "SNSTopic": null,
7. "Type": "inventory-retrieval",
8. "InventoryRetrievalParameters": {
9. "StartDate": "2013-12-04T21:25:42Z",
10. "EndDate": "2013-12-05T21:25:42Z",
11. "Limit" : "10000"
12. },
13. }
```
La demande suivante est un exemple de demande suivante d'extraction de la page suivante des éléments de l'inventaire à l'aide d'un marqueur obtenu de [Description de la tâche (GET JobID)](api-describe-job-get.md).
```
1. {
2. "ArchiveId": null,
3. "Description": null,
4. "Format": "CSV",
5. "RetrievalByteRange": null,
6. "SNSTopic": null,
7. "Type": "inventory-retrieval",
8. "InventoryRetrievalParameters": {
9. "StartDate": "2013-12-04T21:25:42Z",
10. "EndDate": "2013-12-05T21:25:42Z",
11. "Limit": "10000",
12. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0"
13. },
14. }
```
### Exemple de réponse
```
1. HTTP/1.1 202 Accepted
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID
6. x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/
```
## Sections connexes
+ [Description de la tâche (GET JobID)](api-describe-job-get.md)
+ [Génération de sortie de tâche (GET output)](api-job-output-get.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)