**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. # Opérations de tâche Les opérations de travail disponibles dans Amazon Glacier sont les suivantes. **Topics** + [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) + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) + [Affichage des tâches (GET jobs)](api-jobs-get.md) # 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) # 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) # 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) # Affichage des tâches (GET jobs) ## Description Cette opération affiche la liste des tâches relatives à un coffre, y compris les tâches en cours et les tâches récemment terminées. **Note** Amazon Glacier (Amazon Glacier) conserve les tâches récemment terminées pendant un certain temps avant de les supprimer ; toutefois, il finit par supprimer les tâches terminées. La sortie des tâches terminées peut être extraite. Les tâches terminées étant conservées pendant un certain temps, vous pouvez ainsi obtenir les sorties correspondantes si vous manquez la notification d'achèvement de ces tâches ou si votre première tentative de téléchargement de ces tâches échoue. Par exemple, imaginons que vous démarriez une tâche d'extraction d'archive afin de télécharger une archive. Une fois la tâche terminée, vous commencez à télécharger l'archive, mais une erreur réseau se produit. Dans ce scénario, vous pouvez réessayer de télécharger l'archive tant que la tâche existe. L'opération `List Jobs` prend en charge la pagination. Vous devez toujours vérifier le champ `Marker` de la réponse. S'il n'y a pas d'autres tâches à afficher, le champ `Marker` est défini sur `null`. S'il y a d'autres tâches à afficher, le champ `Marker` est défini sur une valeur non null que vous pouvez utiliser afin de poursuivre la pagination de la liste. Pour renvoyer une liste de tâches à partir d'une tâche donnée, définissez le paramètre de demande `marker` sur la valeur `Marker` pour la tâche que vous avez obtenue à partir d'une demande `List Jobs` précédente. Vous pouvez définir une limite maximale pour le nombre de tâches renvoyées dans la réponse en spécifiant le paramètre `limit` dans la demande. La limite par défaut est de 50. Il peut arriver que le nombre de tâches renvoyées soit inférieur à la limite, mais il ne sera jamais supérieur à cette valeur. En outre, vous pouvez filtrer la liste des tâches renvoyées en spécifiant le paramètre facultatif `statuscode` ou `completed`, ou les deux. Le paramètre `statuscode` vous permet de demander à ce que seules les tâches qui correspondent à l'état `InProgress`, `Succeeded` ou `Failed` soient retournées. Le paramètre `completed` vous permet de demander à ce que seules les tâches terminées (`true`) ou non terminées (`false`) soient retournées. ## Requêtes ### Syntaxe Pour renvoyer une liste de tâches de tous types, envoyez une demande `GET` à l'URI de la sous-ressource `jobs` du coffre. ``` 1. GET /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 ``` **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 | Nom | Description | Obligatoire | | --- | --- | --- | | completed | L'état des tâches à renvoyer. Vous pouvez spécifier `true` ou `false`. Type : Boolean Contraintes: Aucune | Non | | limit | Le nombre maximum de tâches à renvoyer. La limite par défaut est de 50. Il peut arriver que le nombre de tâches renvoyées soit inférieur à la limite spécifiée, mais il ne sera jamais supérieur à cette valeur. Type : Chaîne Contraintes : la valeur d'entier minimale est 1. La valeur d'entier maximale est 50. | Non | | marker | Chaîne opaque utilisée pour la pagination afin de spécifier la tâche à partir de laquelle l'affichage de la liste de tâches doit débuter. Vous obtenez la valeur du paramètre `marker` à partir d'une réponse à une demande `List Jobs` précédente. Vous ne devez inclure la valeur `marker` que si vous poursuivez la pagination de résultats commencée dans une demande `List Jobs` précédente. Type : Chaîne Contraintes: Aucune | Non | | statuscode | Le type de l'état de tâche à renvoyer. Type : Chaîne Contraintes : l'une des valeurs suivantes : `InProgress`, `Succeeded` ou`Failed`. | Non | ### En-têtes de demande 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 requête Cette opération n'a pas de corps de demande. ## Réponses ### Syntaxe ``` HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location Content-Type: application/json Content-Length: Length { "JobList": [ { "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" } ], "Marker": "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. **JobList** Liste d'objets de tâche. Chaque objet de tâche contient des métadonnées décrivant la tâche. *Type* : tableau d'objets [GlacierJobDescription](api-GlacierJobDescription.md) **Marker** Chaîne opaque représentant l'endroit à partir duquel poursuivre la pagination des résultats. Vous utilisez la valeur `marker` dans une nouvelle demande ` List Jobs` afin d'obtenir davantage de tâches dans la liste. S'il n'y a pas d'autres tâches à afficher, cette valeur est `null`. *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 Les exemples suivants décrivent comment renvoyer des informations relatives à des tâches de coffre. Le premier exemple renvoie une liste comprenant deux tâches et le deuxième exemple renvoie un sous-ensemble de tâches. ### Exemple : Renvoi de toutes les tâches #### Exemple de requête La demande `GET` suivante renvoie les tâches associées à un coffre. ``` 1. GET /-/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 ``` #### Exemple de réponse La réponse suivante inclut une tâche d'extraction d'archive et une tâche d'extraction d'inventaire qui contient un marqueur permettant de poursuivre la pagination de l'extraction d'inventaire de coffre. La réponse illustre également le champ `Marker` défini sur `null`, ce qui signifie qu'il n'y a pas d'autres tâches à afficher. ``` 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: 1444 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "BDfaUQul0dVzYwAMr8YSa_6_8abbhZq-i1oT69g8ByClfJyBgAGBkWl2QbF5os851P7Y7KdZDOHWJIn4rh1ZHaOYD3MgFhK_g0oDPesW34uHQoVGwoIqubf6BgUEfQm_wrU4Jlm3cA", 12. "ArchiveSizeInBytes": 1048576, 13. "ArchiveSHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:00:09.304Z", 16. "CreationDate": "2012-05-01T00:00:06.663Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": null, 19. "JobId": "hDe9t9DTHXqFw8sBGpLQQOmIM0-JrGtu1O_YFKLnzQ64548qJc667BRWTwBLZC76Ygy1jHYruqXkdcAhRsh0hYv4eVRU", 20. "RetrievalByteRange": "0-1048575", 21. "SHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "InventoryRetrieval", 30. "ArchiveId": null, 31. "ArchiveSizeInBytes": null, 32. "ArchiveSHA256TreeHash": null, 33. "Completed": true, 34. "CompletionDate": "2013-05-11T00:25:18.831Z", 35. "CreationDate": "2013-05-11T00:25:14.981Z", 36. "InventorySizeInBytes": 1988, 37. "JobDescription": null, 38. "JobId": "2cvVOnBL36btzyP3pobwIceiaJebM1bx9vZOOUtmNAr0KaVZ4WkWgVjiPldJ73VU7imlm0pnZriBVBebnqaAcirZq_C5", 39. "RetrievalByteRange": null, 40. "SHA256TreeHash": null, 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 45. "InventoryRetrievalParameters": { 46. "StartDate": "2013-11-12T13:43:12Z", 47. "EndDate": "2013-11-20T08:12:45Z", 48. "Limit": "120000", 49. "Format": "JSON", 50. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 51. } 52. ], 53. "Marker": null 54. } ``` ### Exemple : Renvoi d'une liste partielle de tâches #### Exemple de requête La demande `GET` suivante renvoie la tâche spécifiée par le paramètre `marker`. Définir le paramètre `limit` avec la valeur permet de spécifier que deux tâches au maximum peuvent être renvoyées.`2` ``` 1. GET /-/vaults/examplevault/jobs?marker=HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID&limit=2 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 La réponse suivante illustre deux tâches renvoyées et le champ `Marker` défini sur une valeur non null qui peut être utilisée afin de poursuivre la pagination de la liste de tâches. ``` 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: 1744 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "58-3KpZfcMPUznvMZNPaKyJx9wODCsWTnqcjtx2CjKZ6b-XgxEuA8yvZOYTPQfd7gWR4GRm2XR08gcnWbLV4VPV_kDWtZJKi0TFhKKVPzwrZnA4-FXuIBfViYUIVveeiBE51FO4bvg", 12. "ArchiveSizeInBytes": 8388608, 13. "ArchiveSHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:25:20.043Z", 16. "CreationDate": "2012-05-01T00:25:16.344Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": "aaabbbccc", 19. "JobId": "s4MvaNHIh6mOa1f8iY4ioG2921SDPihXxh3Kv0FBX-JbNPctpRvE4c2_BifuhdGLqEhGBNGeB6Ub-JMunR9JoVa8y1hQ", 20. "RetrievalByteRange": "0-8388607", 21. "SHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "ArchiveRetrieval", 30. "ArchiveId": "2NVGpf83U6qB9M2u-Ihh61yoFLRDEoh7YLZWKBn80A2i1xG8uieBwGjAr4RkzOHA0E07ZjtI267R03Z-6Hxd8pyGQkBdciCSH1-Lw63Kx9qKpZbPCdU0uTW_WAdwF6lR6w8iSyKdvw", 31. "ArchiveSizeInBytes": 1048576, 32. "ArchiveSHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 33. "Completed": true, 34. "CompletionDate": "2012-05-01T16:59:48.444Z", 35. "CreationDate": "2012-05-01T16:59:42.977Z", 36. "InventorySizeInBytes": null, 37. "JobDescription": "aaabbbccc", 38. "JobId": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG", 39. "RetrievalByteRange": "0-1048575", 40. "SHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "Tier": "Standard", 45. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 46. } 47. ], 48. "Marker": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG" 49. } ``` ## Sections connexes + [Description de la tâche (GET JobID)](api-describe-job-get.md) + [Identity and Access Management pour Amazon Glacier](security-iam.md)