Si vous débutez dans le stockage d'archives dans Amazon Simple Storage Service (Amazon S3), nous vous recommandons dans un premier temps de vous familiariser avec les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour plus d'informations, consultez les sections Classes de stockage 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.
Description de la tâche (GET JobID)
Description
Cette opération renvoie des informations sur une tâche que vous avez lancée précédemment, notamment la date de lancement de la tâche, l'utilisateur qui a lancé la tâche, le code/message de statut et la rubrique Amazon Simple Notification Service (Amazon SNS) à notifier après qu'Amazon S3 Glacier (S3 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).
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 lancement de tâche pour permettre à S3 Glacier de notifier la rubrique après avoir terminé la tâche.
Un ID de tâche n'expire pas avant au moins 24 heures après que S3 Glacier a 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 identique à celui que S3 Glacier vous a renvoyé au moment où vous avez lancé la tâche.
GET /
AccountID
/vaults/VaultName
/jobs/JobID
HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:date
Authorization:signatureValue
x-amz-glacier-version: 2012-06-01
Note
La valeur de AccountId
est l'ID de Compte AWS du compte propriétaire du coffre. Vous pouvez spécifier un ID de Compte AWS ou éventuellement un simple « -
» (trait d'union), auquel cas Amazon S3 Glacier utilise l'ID de Compte AWS 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).
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.
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.
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
ouSelect
.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
- ArchiveSHA256TreeHash
-
Hachage d'arborescence SHA256 de l'archive entière pour une tâche d'extraction. 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âcheInventoryRetrieval
, la valeur estnull
.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).
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
- 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âcheArchiveRetrieval
ouSelect
, la valeur estnull
.Type : nombre
- JobDescription
-
La description de tâche que vous avez fournie lorsque vous avez lancé la tâche.
Type : chaîne
- JobId
-
ID qui identifie la tâche dans S3 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
- RetrievalByteRange
-
Plage d'octets extraite pour les tâches d'extraction d'archive sous la forme «
StartByteValue
-EndByteValue
». Si vous ne spécifiez aucune plage dans la demande d'extraction de l'archive, celle-ci est extraite en sa totalité ; de plus, la valeur StartByteValue est égale à 0 et la valeur de EndByteValue est égale à la taille de l'archive moins 1. Pour les tâches d'extraction d'inventaire ou de sélection, ce champ estnull
.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
- SHA256TreeHash
-
Valeur de hachage d'arborescence SHA256 relative à la plage demandée pour une archive. Si la demande Lancement d'une tâche (POST jobs) 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.
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
|Succeeded
|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
|Expedited
|Standard
Type : chaîne
- VaultARN
-
Amazon Resource Name (ARN) du coffre dont la tâche est une sous-ressource.
Type : chaîne
Erreurs
Pour en savoir plus sur les exceptions et les messages d'erreur Amazon S3 Glacier, consultez Réponses d'erreur.
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
GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 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
estArchiveRetrieval
. -
Le champ
ArchiveSizeInBytes
affiche la taille de l'archive demandée dans la tâche d'extraction d'archive. -
Le champ
ArchiveSHA256TreeHash
affiche le hachage d'arborescence SHA256 pour la totalité 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 champ
SHA256TreeHash
affiche le hachage d'arborescence SHA256 pour la plage demandée dans la demande de lancement de tâche. Dans cet exemple, il est identique au champArchiveSHA256TreeHash
, ce qui signifie que l'archive entière a été demandée. -
La valeur du champ
InventorySizeInBytes
estnull
, car elle ne s'applique pas à une tâche d'extraction d'archive.
HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: 419 { "Action": "ArchiveRetrieval", "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", "ArchiveSizeInBytes": 16777216, "ArchiveSHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", "Completed": false, "CompletionDate": null, "CreationDate": "2012-05-15T17:21:39.339Z", "InventorySizeInBytes": null, "JobDescription": "My ArchiveRetrieval Job", "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", "RetrievalByteRange": "0-16777215", "SHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "StatusCode": "InProgress", "StatusMessage": "Operation in progress.", "Tier": "Bulk", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" }
Voici un exemple de réponse pour une tâche d'extraction d'inventaire. Notez ce qui suit :
-
La valeur du champ
Action
estInventoryRetrieval
. -
Les valeurs de champ
ArchiveSizeInBytes
,ArchiveSHA256TreeHash
etRetrievalByteRange
sont nulles, car ces champs ne s'appliquent pas à une tâche d'extraction d'inventaire. -
La valeur de champ
InventorySizeInBytes
estnull
, 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