**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.
# Description de la tâche (GET JobID)
## Description
Cette opération renvoie des informations sur une tâche que vous avez initiée précédemment, notamment la date de lancement de la tâche, l'utilisateur qui a initié la tâche, le code/message de statut de la tâche et la rubrique Amazon Simple Notification Service (Amazon SNS) à laquelle vous devez vous informer une fois qu'Amazon Glacier (Amazon Glacier) a terminé la tâche. Pour plus d'informations sur le lancement d'une tâche, consultez [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md).
**Note**
Cette opération vous permet de vérifier l'état de votre tâche. Cependant, nous vous recommandons vivement de configurer une rubrique Amazon SNS et de la spécifier dans votre demande de travail d'initiation afin qu'Amazon Glacier puisse informer le sujet une fois la tâche terminée.
Un identifiant de tâche n'expirera pas pendant au moins 24 heures après qu'Amazon Glacier ait terminé la tâche.
## Requêtes
### Syntaxe
Pour obtenir des informations sur une tâche, utilisez la méthode `GET` HTTP et limitez la portée de la demande à la tâche spécifique. Notez que le chemin d'URI relatif est le même que celui qu'Amazon Glacier vous a renvoyé lorsque vous avez lancé la tâche.
```
1. GET /AccountID/vaults/VaultName/jobs/JobID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: date
4. Authorization: signatureValue
5. 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 (« - »).
**Note**
Dans la demande, si vous omettez le `JobID`, la réponse renvoie la liste de toutes les tâches actives sur le coffre spécifié. Pour plus d'informations sur l'affichage de la liste des tâches, consultez [Affichage des tâches (GET jobs)](api-jobs-get.md).
### Paramètres de demande
Cette opération n'utilise pas les paramètres de demande.
### En-têtes de demande
Cette opération utilise uniquement les en-têtes de demande qui sont 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).
### Corps de la requête
Cette opération n'a pas de corps de demande.
## Réponses
### Syntaxe
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
"Action": "string",
"ArchiveId": "string",
"ArchiveSHA256TreeHash": "string",
"ArchiveSizeInBytes": number,
"Completed": boolean,
"CompletionDate": "string",
"CreationDate": "string",
"InventoryRetrievalParameters": {
"EndDate": "string",
"Format": "string",
"Limit": "string",
"Marker": "string",
"StartDate": "string"
},
"InventorySizeInBytes": number,
"JobDescription": "string",
"JobId": "string",
"JobOutputPath": "string",
"OutputLocation": {
"S3": {
"AccessControlList": [
{
"Grantee": {
"DisplayName": "string",
"EmailAddress": "string",
"ID": "string",
"Type": "string",
"URI": "string"
},
"Permission": "string"
}
],
"BucketName": "string",
"CannedACL": "string",
"Encryption": {
"EncryptionType": "string",
"KMSContext": "string",
"KMSKeyId": "string"
},
"Prefix": "string",
"StorageClass": "string",
"Tagging": {
"string": "string"
},
"UserMetadata": {
"string": "string"
}
}
},
"RetrievalByteRange": "string",
"SelectParameters": {
"Expression": "string",
"ExpressionType": "string",
"InputSerialization": {
"csv": {
"Comments": "string",
"FieldDelimiter": "string",
"FileHeaderInfo": "string",
"QuoteCharacter": "string",
"QuoteEscapeCharacter": "string",
"RecordDelimiter": "string"
}
},
"OutputSerialization": {
"csv": {
"FieldDelimiter": "string",
"QuoteCharacter": "string",
"QuoteEscapeCharacter": "string",
"QuoteFields": "string",
"RecordDelimiter": "string"
}
}
},
"SHA256TreeHash": "string",
"SNSTopic": "string",
"StatusCode": "string",
"StatusMessage": "string",
"Tier": "string",
"VaultARN": "string"
}
```
### En-têtes de réponse
Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez [En-têtes de réponse communs](api-common-response-headers.md).
### Corps de la réponse
Le corps de la réponse contient les champs JSON suivants.
**Action**
Le type de tâche. Il s'agit de `ArchiveRetrieval`, `InventoryRetrieval` ou `Select`.
*Type* : chaîne
**ArchiveId**
ID d'archive demandé pour une tâche de sélection ou d'extraction d'archive. Sinon, ce champ est `null`.
*Type* : chaîne
**ArchivageSHA256TreeHash**
Le hachage SHA256 arborescent de l'ensemble de l'archive pour une tâche de récupération d'archives. Pour les tâches d'extraction d'inventaire, ce champ est `null`.
*Type* : chaîne
**ArchiveSizeInBytes**
Pour une tâche `ArchiveRetrieval`, il s'agit de la taille en octets de l'archive demandée au téléchargement. Pour la tâche `InventoryRetrieval`, la valeur est `null`.
*Type* : nombre
**Terminé**
L'état de la tâche. Lorsqu'une tâche d'extraction d'archive ou d'inventaire est terminée, vous obtenez la sortie de la tâche à l'aide de [Génération de sortie de tâche (GET output)](api-job-output-get.md).
*Type* : valeur booléenne
**CompletionDate**
La date UTC lors de la fin de la demande de tâche. Lorsque la tâche est en cours, cette valeur est null.
*Type* : chaîne
**CreationDate**
L'heure UTC à laquelle la tâche a été créée.
*Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**InventoryRetrievalParameters**
Paramètres d'entrée utilisés pour l'extraction d'un inventaire par plage.
*Type* : objet [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md)
**InventorySizeInBytes**
Pour une tâche `InventoryRetrieval`, il s'agit de la taille en octets de l'inventaire dont le téléchargement est demandé. Pour la tâche `ArchiveRetrieval` ou `Select`, la valeur est `null`.
*Type* : nombre
**JobDescription**
La description de tâche que vous avez fournie lorsque vous avez lancé la tâche.
*Type* : chaîne
**JobId**
ID identifiant la tâche dans Amazon Glacier.
*Type* : chaîne
**JobOutputPath**
Contient l'emplacement de la sortie de la tâche.
*Type* : chaîne
**OutputLocation**
Objet qui contient des informations sur l'emplacement auquel les erreurs et résultats de tâches de sélection sont stockés.
*Type* : objet [OutputLocation](api-OutputLocation.md)
**RetrievalByteRange**
La plage d'octets récupérée pour les tâches de récupération d'archives sous la forme « *StartByteValue* - »*EndByteValue*. Si vous ne spécifiez pas de plage dans la récupération de l'archive, l'archive entière est récupérée ; elle est également *StartByteValue*égale à 0 et *EndByteValue*égale à la taille de l'archive moins 1. Pour les tâches d'extraction d'inventaire ou de sélection, ce champ est `null`.
*Type* : chaîne
**SelectParameters**
Objet qui contient les informations sur les paramètres utilisés pour une tâche de sélection.
*Type* : objet [SelectParameters](api-SelectParameters.md)
**SHA256TreeHash**
La valeur de hachage de l' SHA256 arbre pour la plage demandée d'une archive. Si la demande [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) définie pour une archive spécifiait une plage alignée avec le hachage d'arborescence, ce champ renvoie une valeur. Pour plus d'informations sur l'alignement avec le hachage d'arborescence dans le cas d'extractions par plage d'archive, consultez [Réception des totaux de contrôle lors du téléchargement de données](checksum-calculations-range.md).
Lorsque la totalité de l'archive est extraite, cette valeur est identique à celle de `ArchiveSHA256TreeHash`.
La valeur de ce champ est `null` dans les cas suivants :
+ Tâches d'extraction d'archive qui spécifient une plage qui n'est pas alignée avec le hachage d'arborescence.
+ Tâches d'archivage qui spécifient une plage qui correspond à la totalité de l'archive et dont l'état est `InProgress`.
+ Tâches d'inventaire.
+ Tâches de sélection.
*Type* : chaîne
**SNSTopic**
Rubrique Amazon SNS qui reçoit une notification.
*Type* : chaîne
**StatusCode**
Code indiquant l'état de la tâche.
*Valeurs Valides* : `InProgress` \$1 `Succeeded` \$1 `Failed`
*Type* : chaîne
**StatusMessage**
Message convivial qui décrit l'état de la tâche.
*Type* : chaîne
**Palier**
Niveau d'accès aux données à utiliser pour la tâche de sélection ou d'extraction d'archive.
*Valeurs Valides* : `Bulk` \$1 `Expedited` \$1 `Standard`
*Type* : chaîne
**VaultARN**
Amazon Resource Name (ARN) du coffre dont la tâche est une sous-ressource.
*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 de demande : Obtention de la description de la tâche
```
1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 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
Le corps de réponse inclut du code JSON qui décrit la tâche spécifiée. Notez que les champs JSON sont identiques pour la tâche d'extraction d'inventaire et la tâche d'extraction d'archive. Cependant, lorsqu'un champ ne s'applique pas au type de tâche, sa valeur est `null`. Voici un exemple de réponse pour une tâche d'extraction d'archive. Notez ce qui suit :
+ La valeur du champ `Action` est `ArchiveRetrieval`.
+ Le champ `ArchiveSizeInBytes` affiche la taille de l'archive demandée dans la tâche d'extraction d'archive.
+ Le `ArchiveSHA256TreeHash` champ indique le hachage de l' SHA256 arborescence pour l'ensemble de l'archive.
+ Le champ `RetrievalByteRange` affiche la plage demandée dans la demande de lancement de tâche. Dans cet exemple, l'archive entière est demandée.
+ Le `SHA256TreeHash` champ indique le hachage SHA256 arborescent pour la plage demandée dans la demande Initiate Job. Dans cet exemple, il est identique au champ `ArchiveSHA256TreeHash`, ce qui signifie que l'archive entière a été demandée.
+ La valeur du champ `InventorySizeInBytes` est `null`, car elle ne s'applique pas à une tâche d'extraction d'archive.
```
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: 419
6. {
7. "Action": "ArchiveRetrieval",
8. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId",
9. "ArchiveSizeInBytes": 16777216,
10. "ArchiveSHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60",
11. "Completed": false,
12. "CompletionDate": null,
13. "CreationDate": "2012-05-15T17:21:39.339Z",
14. "InventorySizeInBytes": null,
15. "JobDescription": "My ArchiveRetrieval Job",
16. "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID",
17. "RetrievalByteRange": "0-16777215",
18. "SHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60",
19. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic",
20. "StatusCode": "InProgress",
21. "StatusMessage": "Operation in progress.",
22. "Tier": "Bulk",
23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
24. }
```
Voici un exemple de réponse pour une tâche d'extraction d'inventaire. Notez ce qui suit :
+ La valeur du champ `Action` est `InventoryRetrieval`.
+ Les valeurs de champ `ArchiveSizeInBytes`, `ArchiveSHA256TreeHash` et `RetrievalByteRange` sont nulles, car ces champs ne s'appliquent pas à une tâche d'extraction d'inventaire.
+ La valeur de champ `InventorySizeInBytes` est `null`, car la tâche est encore en cours et n'a pas encore entièrement préparé l'inventaire au téléchargement. Si la tâche était terminée avant votre demande de description de la tâche, ce champ vous indiquerait la taille de la sortie.
```
{
"Action": "InventoryRetrieval",
"ArchiveId": null,
"ArchiveSizeInBytes": null,
"ArchiveSHA256TreeHash": null,
"Completed": false,
"CompletionDate": null,
"CreationDate": "2012-05-15T23:18:13.224Z",
"InventorySizeInBytes": null,
"JobDescription": "Inventory Description",
"JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID",
"RetrievalByteRange": null,
"SHA256TreeHash": null,
"SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic",
"StatusCode": "InProgress",
"StatusMessage": "Operation in progress.",
"VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
}
```
Voici un exemple de réponse pour une tâche d'extraction d'inventaire terminée qui contient un marqueur utilisé pour poursuivre la pagination de l'extraction de l'inventaire du coffre.
```
{
"Action": "InventoryRetrieval",
"ArchiveId": null,
"ArchiveSHA256TreeHash": null,
"ArchiveSizeInBytes": null,
"Completed": true,
"CompletionDate": "2013-12-05T21:51:13.591Z",
"CreationDate": "2013-12-05T21:51:12.281Z",
"InventorySizeInBytes": 777062,
"JobDescription": null,
"JobId": "sCC2RZNBF2nildYD_roe0J9bHRdPQUbDRkmTdg-mXi2u3lc49uW6TcEhDF2D9pB2phx-BN30JaBru7PMyOlfXHdStzu8",
"NextInventoryRetrievalMarker": null,
"RetrievalByteRange": null,
"SHA256TreeHash": null,
"SNSTopic": null,
"StatusCode": "Succeeded",
"StatusMessage": "Succeeded",
"Tier": "Bulk",
"VaultARN": "arn:aws:glacier-devo:us-west-2:836579025725:vaults/inventory-icecube-2",
"InventoryRetrievalParameters": {
"StartDate": "2013-11-12T13:43:12Z",
"EndDate": "2013-11-20T08:12:45Z",
"Limit": "120000",
"Format": "JSON",
"Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0"
},
}
```
## Sections connexes
+ [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)