**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.
# Référence d'API pour Amazon Glacier
Amazon Glacier prend en charge un ensemble d'opérations, en particulier un ensemble d'appels d' RESTfulAPI, qui vous permettent d'interagir avec le service.
Vous pouvez utiliser n'importe quelle bibliothèque de programmation capable d'envoyer des requêtes HTTP pour envoyer vos requêtes REST à Amazon Glacier. Lorsque vous envoyez une demande REST, Amazon Glacier exige que vous authentifiiez chaque demande en la signant. En outre, lorsque vous chargez une archive, vous devez également calculer le total de contrôle de la charge utile et l'inclure dans votre demande. Pour de plus amples informations, veuillez consulter [Signature des requêtes](amazon-glacier-signing-requests.md).
En cas d'erreur, vous devez savoir quelle réponse d'erreur Amazon Glacier envoie afin de pouvoir la traiter. En plus de documenter les opérations REST, cette section fournit toutes les informations vous permettant d'effectuer des appels d'API REST directement.
Vous pouvez soit utiliser directement les appels d'API REST, soit utiliser Amazon SDKs qui fournit des bibliothèques d'encapsulation. Ces bibliothèques signent chaque demande que vous envoyez et calculent le total de contrôle de la charge utile indiquée dans votre demande. Par conséquent, l'utilisation d'Amazon SDKs simplifie votre tâche de codage. Ce guide du développeur fournit des exemples pratiques d'opérations de base sur Amazon Glacier à l'aide de AWS SDK pour Java et .NET. Pour plus d'informations, voir,[Utilisation du AWS SDKs avec Amazon Glacier](using-aws-sdk.md).
**Topics**
+ [
# En-têtes de demande communs
](api-common-request-headers.md)
+ [
# En-têtes de réponse communs
](api-common-response-headers.md)
+ [
# Signature des requêtes
](amazon-glacier-signing-requests.md)
+ [
# Calcul des totaux de contrôle
](checksum-calculations.md)
+ [
# Réponses d’erreur
](api-error-responses.md)
+ [
# Opérations de coffre
](vault-operations.md)
+ [
# Opérations d'archivage
](archive-operations.md)
+ [
# Opérations de chargement partitionné
](multipart-archive-operations.md)
+ [
# Opérations de tâche
](job-operations.md)
+ [
# Types de données utilisés dans les opérations de tâche
](api-data-types.md)
+ [
# Opérations de récupération des données
](data-retrieval-policy-operations.md)
# En-têtes de demande communs
Les demandes REST Amazon Glacier (Amazon Glacier) incluent des en-têtes contenant des informations de base sur la demande. Le tableau suivant décrit les en-têtes qui peuvent être utilisés par toutes les requêtes REST Amazon Glacier.
| Nom de l’en-tête | Description | Obligatoire |
| --- | --- | --- |
| Authorization | En-tête nécessaire à la signature des demandes. Amazon Glacier nécessite la version 4 de Signature. Pour de plus amples informations, veuillez consulter [Signature des requêtes](amazon-glacier-signing-requests.md). Type : String | Oui |
| Content-Length | Longueur du corps de la demande (sans les en-têtes). Type : String Condition : nécessaire uniquement pour l'API [Chargement d'archive (POST archive)](api-archive-post.md). | Conditionnel |
| Date | Date qui peut être utilisée pour créer la signature contenue dans l'en-tête `Authorization`. Si l'en-tête `Date` doit être utilisé pour la signature, il doit être spécifié au format de base ISO 8601. Dans ce cas, l'en-tête `x-amz-date` n'est pas nécessaire. Notez que lorsque `x-amz-date` est présent, il remplace toujours la valeur de l'en-tête `Date`. Si l'en-tête Date n'est pas utilisé pour la signature, il peut se présenter sous l'un des formats de date complets spécifiés par [RFC 2616](http://tools.ietf.org/html/rfc2616#section-3.3), section 3.3. Par exemple, la date/heure suivante `Wed, 10 Feb 2017 12:00:00 GMT` est un date/time en-tête valide à utiliser avec Amazon Glacier. Si vous utilisez l'en-tête `Date` pour la signature, il doit être au format de base ISO 8601`YYYYMMDD'T'HHMMSS'Z'`. Type : String Condition : si `Date`est spécifié, mais n'est pas au format de base ISO 8601 base, vous devez également inclure l'en-tête `x-amz-date`. Si `Date` est spécifié au format de base ISO 8601, cela suffit pour signer les demandes et l'en-tête `x-amz-date` n'est pas nécessaire. Pour plus d'informations, consultez la page [Gestion des dates dans Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html) dans le *Glossaire Amazon Web Services*. | Conditionnel |
| Host | Cet en-tête spécifie le point de terminaison de service auquel vous envoyez vos demandes. La valeur doit être de la forme `glacier.region.amazonaws.com` « », *region* remplacée par une désignation de AWS région telle que`us-west-2`. Type : String | Oui |
| x-amz-content-sha256 | SHA256 Somme de contrôle calculée d'une charge utile complète téléchargée avec ou[Chargement d'archive (POST archive)](api-archive-post.md). [Partie chargement (PUT uploadID)](api-upload-part.md) Cet en-tête n'est pas identique à l'en-tête `x-amz-sha256-tree-hash` bien que les valeurs soient identiques pour quelques petites charges utiles. Lorsque `x-amz-content-sha256` est obligatoire, aussi bien `x-amz-content-sha256` que `x-amz-sha256-tree-hash` doit être spécifié. Type : String Condition : obligatoire pour l'API de streaming, [Chargement d'archive (POST archive)](api-archive-post.md) et [Partie chargement (PUT uploadID)](api-upload-part.md). | Conditionnel |
| x-amz-date | Date utilisée pour créer la signature dans l'en-tête Authorization. Le format doit correspondre à la norme ISO 8601 de base au format `YYYYMMDD'T'HHMMSS'Z'`. Par exemple, ce qui suit date/time `20170210T120000Z` est valide `x-amz-date` pour une utilisation avec Amazon Glacier. Type : String Condition : `x-amz-date` est un en-tête facultatif pour toutes les demandes. Il peut être utilisé pour signer les demandes. Si l'en-tête `Date` est spécifié au format de base ISO 8601, `x-amz-date` n'est pas nécessaire. Lorsque `x-amz-date` est présent, il remplace toujours la valeur de l'en-tête `Date`. Pour plus d'informations, consultez la page [Gestion des dates dans Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html) dans le *Glossaire Amazon Web Services*. | Conditionnel |
| x-amz-glacier-version | Version de l'API Amazon Glacier à utiliser. La version actuelle est `2012-06-01`. Type : String | Oui |
| x-amz-sha256-tree-hash | Somme de contrôle calculée SHA256 par hachage arborescent pour une archive ([Chargement d'archive (POST archive)](api-archive-post.md)) ou une partie d'archive () téléchargée. [Partie chargement (PUT uploadID)](api-upload-part.md) Pour plus d'informations sur le calcul de ce total de contrôle, consultez la section [Calcul des totaux de contrôle](checksum-calculations.md). Type : String Par défaut : aucun Condition : Obligatoire pour [Chargement d'archive (POST archive)](api-archive-post.md) et [Partie chargement (PUT uploadID)](api-upload-part.md). | Conditionnel |
# En-têtes de réponse communs
Le tableau suivant décrit les en-têtes de réponse communs à la plupart des réponses d'API.
| Nom | Description |
| --- | --- |
| Content-Length | Longueur en octets du corps de la réponse. Type : String |
| Date | La date et l'heure de réponse d'Amazon Glacier (Amazon Glacier), par exemple,`Wed, 10 Feb 2017 12:00:00 GMT`. Le format de la date doit être l'un des formats de date complète spécifiés par [RFC 2616](https://datatracker.ietf.org/doc/html/rfc2616#section-3.3), section 3.3. Notez que la valeur `Date` renvoyée peut être légèrement décalée par rapport aux autres dates. Par exemple, la date renvoyée par une demande [Chargement d'archive (POST archive)](api-archive-post.md) peut ne pas correspondre à celle qui est indiquée pour l'archive dans une liste d'inventaire pour le coffre. Type : String |
| x-amzn-RequestId | Une valeur créée par Amazon Glacier qui identifie de manière unique votre demande. Si vous rencontrez un problème avec Amazon Glacier, vous AWS pouvez utiliser cette valeur pour le résoudre. Il est recommandé d'enregistrer ces valeurs. Type : String |
| x-amz-sha256-tree-hash | Somme de contrôle SHA256 arborescente de l'archive ou du corps de l'inventaire. Pour plus d'informations sur le calcul de ce total de contrôle, consultez la section [Calcul des totaux de contrôle](checksum-calculations.md). Type : String |
# Signature des requêtes
Amazon Glacier exige que vous authentifiiez chaque demande que vous envoyez en signant la demande. Pour signer une demande, vous calculez une signature numérique à l’aide d’une fonction de hachage cryptographique. Un hachage cryptographique est une fonction qui renvoie une valeur de hachage unique basée sur l’entrée. L’entrée de la fonction de hachage contient le texte de la demande et votre clé d’accès secrète. La fonction de hachage renvoie une valeur de hachage que vous incluez dans la demande comme votre signature. La signature fait partie de l’en-tête `Authorization` de votre demande.
Après réception de votre demande, Amazon Glacier recalcule la signature en utilisant la même fonction de hachage et les mêmes entrées que celles que vous avez utilisées pour signer la demande. Si la signature obtenue correspond à celle de la demande, Amazon Glacier traite la demande. Sinon, la demande est rejetée.
Amazon Glacier prend en charge l'authentification à l'aide de [AWS Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). Le processus de calcul d’une signature peut être divisé en trois tâches :
+ [Tâche 1 : créer une demande canonique](https://docs.aws.amazon.com/general/latest/gr/sigv4-create-canonical-request.html)
Réorganiser votre demande HTTP dans un format canonique. L'utilisation d'un formulaire canonique est nécessaire car Amazon Glacier utilise le même formulaire canonique lorsqu'il recalcule une signature pour la comparer à celle que vous avez envoyée.
+ [Tâche 2 : créer une chaîne de connexion](https://docs.aws.amazon.com/general/latest/gr/sigv4-create-string-to-sign.html)
Créez une chaîne que vous utiliserez comme une des valeurs d’entrée pour votre fonction de hachage cryptographique. La chaîne, appelée la *chaîne de connexion*, est une concaténation du nom de l’algorithme de hachage, de la date de la demande, d’une chaîne d’*informations d’identification* et de la demande convertie sous forme canonique de la tâche précédente. La chaîne d'*étendue des informations d'identification* elle-même est une concaténation d'informations de date, de AWS région et de service.
+ [Tâche 3 : créer une signature](https://docs.aws.amazon.com/general/latest/gr/sigv4-calculate-signature.html)
Créez une signature pour votre demande à l’aide d’une fonction de hachage cryptographique qui accepte deux chaînes d’entrée : votre *chaîne de connexion* et une *clé dérivée*. La *clé dérivée* est calculée en commençant par votre clé d'accès secrète et en utilisant la chaîne de *portée des informations d'identification* pour créer une série de codes d'authentification des messages basés sur le hachage ()HMACs. Notez que la fonction de hachage utilisée dans cette étape de signature n'est pas l'algorithme de hachage arborescent utilisé dans Amazon Glacier pour charger les données. APIs
**Topics**
+ [
## Exemple de calcul de signature
](#example-signature-calculation)
+ [
## Calcul des Signatures pour les opérations de streaming
](#signature-calculation-streaming)
## Exemple de calcul de signature
L'exemple suivant vous guide à travers les détails de la création d'une signature pour [Création de coffre (PUT vault)](api-vault-put.md). L’exemple peut être utilisé comme référence pour vérifier votre méthode de calcul de signature. Pour plus d'informations, consultez la section [Signature des demandes AWS d'API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) dans le *guide de l'utilisateur IAM*.
Dans cet exemple il est supposé que :
+ L'horodatage de la demande est `Fri, 25 May 2012 00:24:53 GMT`.
+ Le point de terminaison est la région USA Est (Virginie du Nord), ` us-east-1`.
La syntaxe générale de la demande (y compris le corps JSON) est :
```
PUT /-/vaults/examplevault HTTP/1.1
Host: glacier.us-east-1.amazonaws.com
Date: Fri, 25 May 2012 00:24:53 GMT
Authorization: SignatureToBeCalculated
x-amz-glacier-version: 2012-06-01
```
La forme canonique de la demande calculée pour [Tâche 1 : Créer une demande canonique](#SignatureCalculationTask1) est :
```
PUT
/-/vaults/examplevault
host:glacier.us-east-1.amazonaws.com
x-amz-date:20120525T002453Z
x-amz-glacier-version:2012-06-01
host;x-amz-date;x-amz-glacier-version
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
```
La dernière ligne de la demande canonique est le hachage du corps de la demande. Notez également la troisième ligne vide dans la demande canonique. Elle provient du fait qu'il n'y a aucun paramètre de requête pour cette API.
La *chaîne de connexion* pour la [tâche 2 : créer une chaîne de connexion](#SignatureCalculationTask2) est :
```
AWS4-HMAC-SHA256
20120525T002453Z
20120525/us-east-1/glacier/aws4_request
5f1da1a2d0feb614dd03d71e87928b8e449ac87614479332aced3a701f916743
```
La première ligne de la *chaîne de connexion* est l'algorithme, la deuxième ligne est l'horodatage, la troisième ligne est les *informations d'identification*, et la dernière ligne est un hachage de la demande canonique issu de la [tâche 1 : créer une demande canonique](#SignatureCalculationTask1). Le nom du service à utiliser dans les informations d'identification est `glacier`.
Pour la [tâche 3 : créer une signature](#SignatureCalculationTask3), la *clé dérivée* peut être représentée sous la forme :
```
derived key = HMAC(HMAC(HMAC(HMAC("AWS4" + YourSecretAccessKey,"20120525"),"us-east-1"),"glacier"),"aws4_request")
```
Si la clé d'accès secrète `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY` est utilisée, la signature calculée est :
```
3ce5b2f2fffac9262b4da9256f8d086b4aaf42eba5f111c21681a65a127b7c2a
```
L’étape finale consiste à construire l’en-tête `Authorization`. Pour la clé d'accès de la démonstration `AKIAIOSFODNN7EXAMPLE`, l'en-tête (avec les sauts de ligne ajoutés pour faciliter la lecture) est :
```
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-east-1/glacier/aws4_request,
SignedHeaders=host;x-amz-date;x-amz-glacier-version,
Signature=3ce5b2f2fffac9262b4da9256f8d086b4aaf42eba5f111c21681a65a127b7c2a
```
## Calcul des Signatures pour les opérations de streaming
[Chargement d'archive (POST archive)](api-archive-post.md) et [Partie chargement (PUT uploadID)](api-upload-part.md) sont des opérations de streaming qui exigent d'inclure un en-tête supplémentaire `x-amz-content-sha256` lors de la signature et de l'envoi de votre demande. Les étapes de signature pour les opérations de streaming sont identiques à celles des autres opérations, mais comprennent aussi l'ajout de l'en-tête de streaming.
Le calcul de l'en-tête de diffusion `x-amz-content-sha256` est basé sur le SHA256 hachage de l'ensemble du contenu (charge utile) à télécharger. Notez que ce calcul est différent de l' SHA256 arbre hash ([Calcul des totaux de contrôle](checksum-calculations.md)). Hormis les cas triviaux, la valeur de hachage SHA 256 des données de charge utile sera différente du hachage SHA256 arborescent des données de charge utile.
Si les données de charge utile sont spécifiées sous forme de tableau d'octets, vous pouvez utiliser l'extrait de code Java suivant pour calculer le hachage. SHA256
```
public static byte[] computePayloadSHA256Hash2(byte[] payload) throws NoSuchAlgorithmException, IOException {
BufferedInputStream bis =
new BufferedInputStream(new ByteArrayInputStream(payload));
MessageDigest messageDigest = MessageDigest.getInstance("SHA-256");
byte[] buffer = new byte[4096];
int bytesRead = -1;
while ( (bytesRead = bis.read(buffer, 0, buffer.length)) != -1 ) {
messageDigest.update(buffer, 0, bytesRead);
}
return messageDigest.digest();
}
```
De même, en C\$1, vous pouvez calculer le SHA256 hachage des données de charge utile comme indiqué dans l'extrait de code suivant.
```
public static byte[] CalculateSHA256Hash(byte[] payload)
{
SHA256 sha256 = System.Security.Cryptography.SHA256.Create();
byte[] hash = sha256.ComputeHash(payload);
return hash;
}
```
### Exemple de calcul de signature pour l'API de streaming
L'exemple suivant explique en détail comment créer une signature pour l'un des deux [Chargement d'archive (POST archive)](api-archive-post.md) types de diffusion en continu APIs dans Amazon Glacier. Dans cet exemple il est supposé que :
+ L'horodatage de la demande est `Mon, 07 May 2012 00:00:00 GMT`.
+ Le point de terminaison est la région USA Est (Virginie du Nord), us-east-1.
+ La charge utile du contenu est une chaîne « Bienvenue sur Amazon Glacier ».
La syntaxe de demande générale (y compris le corps JSON) est illustrée dans l'exemple ci-dessous. Notez que l'en-tête ` x-amz-content-sha256` est inclus. Dans cet exemple simplifié, le paramètre `x-amz-sha256-tree-hash` et le paramètre `x-amz-content-sha256` ont la même valeur. Cependant, ce n'est pas le cas pour les téléchargements d'archives supérieures à 1 Mo.
```
POST /-/vaults/examplevault HTTP/1.1
Host: glacier.us-east-1.amazonaws.com
Date: Mon, 07 May 2012 00:00:00 GMT
x-amz-archive-description: my archive
x-amz-sha256-tree-hash: SHA256 tree hash
x-amz-content-sha256: SHA256 payload hash
Authorization: SignatureToBeCalculated
x-amz-glacier-version: 2012-06-01
```
La forme canonique de la demande calculée pour la [tâche 1 : créer une demande canonique](#SignatureCalculationTask1) est illustrée ci-dessous : Notez que l'en-tête de streaming `x-amz-content-sha256` est inclus avec sa valeur. Cela signifie que vous devez d'abord lire la charge utile et calculer le SHA256 hachage, puis calculer la signature.
```
POST
/-/vaults/examplevault
host:glacier.us-east-1.amazonaws.com
x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
x-amz-date:20120507T000000Z
x-amz-glacier-version:2012-06-01
host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version
726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
```
Le reste du calcul de la signature suit les étapes décrites dans [Exemple de calcul de signature](#example-signature-calculation). L'en-tête `Authorization` qui utilise la clé d'accès secrète `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY` et la clé d'accès `AKIAIOSFODNN7EXAMPLE` est illustré ci-dessous (avec des sauts de ligne ajoutés pour faciliter la lecture) :
```
Authorization=AWS4-HMAC-SHA256
Credential=AKIAIOSFODNN7EXAMPLE/20120507/us-east-1/glacier/aws4_request,
SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,
Signature=b092397439375d59119072764a1e9a144677c43d9906fd98a5742c57a2855de6
```
# Calcul des totaux de contrôle
Lors du chargement d'une archive, vous devez inclure les deux en-têtes `x-amz-sha256-tree-hash` et `x-amz-content-sha256`. L'en-tête `x-amz-sha256-tree-hash` est un total de contrôle de la charge utile dans le corps de votre demande. Cette rubrique explique comment calculer l'en-tête `x-amz-sha256-tree-hash`. L'en-tête `x-amz-content-sha256` est un hachage de la totalité de la charge utile et est obligatoire pour l'autorisation. Pour de plus amples informations, veuillez consulter [Exemple de calcul de signature pour l'API de streaming](amazon-glacier-signing-requests.md#example-signature-calculation-streaming).
La charge utile de votre demande peut être :
+ **Une archive entière –** Lorsque vous chargez une archive dans une même demande à l'aide de l'API de chargement d'archive, vous envoyez l'archive entière dans le corps de la demande. Dans ce cas, vous devez inclure le total de contrôle de l'intégralité de l'archive.
+ **Une partie d'archive –** Lorsque vous chargez une archive en plusieurs parties à l'aide de l'API de chargement partitionné, vous envoyez seulement une partie de l'archive dans le corps de la demande. Dans ce cas, vous incluez le total de contrôle de la partie de l'archive. Et, une fois que vous avez chargé toutes les parties, vous envoyez une demande d'achèvement de chargement partitionné qui doit inclure le total de contrôle de la totalité de l'archive.
Le total de contrôle de la charge utile est un hachage d'arborescence SHA-256. Il est appelé hachage d'arborescence car dans le processus de calcul du total de contrôle, vous calculez une arborescence des valeurs de hachage SHA-256. La valeur de hachage située à la racine est le total de contrôle de la totalité de l'archive.
**Note**
Cette section décrit une procédure permettant de calculer le hachage d'arborescence SHA-256. Vous pouvez toutefois utiliser n'importe quelle autre procédure à condition que celle-ci génère le même résultat.
Pour calculer le hachage d'arborescence SHA-256, procédez comme suit :
1. Pour chaque bloc de 1 Mo des données de charge utile, calculez le hachage SHA-256. Le dernier bloc de données peut être inférieur à 1 Mo. Par exemple, si vous chargez une archive de 3,2 Mo, vous calculez les valeurs de hachage SHA-256 pour chacun des trois premiers blocs de 1 Mo de données, puis vous calculez le hachage SHA-256 pour le dernier bloc de 0,2 Mo de données. Ces valeurs de hachage constituent les nœuds terminaux de l'arborescence.
1. Créez le niveau suivant de l'arborescence.
1. Concaténez deux valeurs de hachage de nœud enfant consécutives et calculez le hachage SHA-256 des valeurs de hachage concaténées. Cette concaténation et la génération du hachage SHA-256 produisent un nœud parent pour les deux nœuds enfants.
1. S'il ne reste qu'un nœud enfant, faites remonter cette valeur de hachage au niveau supérieur dans l'arborescence.
1. Répétez l'étape 2 jusqu'à ce que l'arborescence obtenue possède une racine. La racine de l'arborescence fournit un hachage de la totalité de l'archive et une racine de la sous-arborescence appropriée fournit le hachage pour la partie dans le cadre d'un chargement partitionné.
**Topics**
+ [
## Exemple de hachage d'arborescence 1 : Chargement d'une archive dans le cadre d'une seule demande
](#checksum-calculations-upload-archive-in-single-payload)
+ [
## Exemple de hachage d'arborescence 2 : chargement d'une archive à l'aide d'un chargement partitionné
](#checksum-calculations-upload-archive-using-mpu)
+ [
## Calcul du hachage d'arborescence d'un fichier
](#checksum-calculations-examples)
+ [
# Réception des totaux de contrôle lors du téléchargement de données
](checksum-calculations-range.md)
## Exemple de hachage d'arborescence 1 : Chargement d'une archive dans le cadre d'une seule demande
Lorsque vous chargez une archive dans le cadre d'une seule demande à l'aide de l'API de chargement d'archive (consultez la section [Chargement d'archive (POST archive)](api-archive-post.md)), la charge utile de la demande comprend la totalité de l'archive. En conséquence, vous devez inclure le hachage d'arborescence de la totalité de l'archive dans l'en-tête de demande `x-amz-sha256-tree-hash`. Supposons que vous souhaitiez charger une archive de 6,5 Mo. Le schéma suivant illustre le processus de création du hachage SHA-256 de l'archive. Vous lisez l'archive et calculez le hachage SHA-256 pour chaque bloc de 1 Mo. Vous calculez également le hachage du dernier bloc de 0,5 Mo de données, puis vous créez l'arborescence comme indiqué dans la procédure précédente.
![\[Schéma illustrant un exemple de hachage arborescent lors du téléchargement d'une archive en une seule demande.\]](http://docs.aws.amazon.com/fr_fr/amazonglacier/latest/dev/images/TreeHash-ArchiveUploadSingleRequest.png)
## Exemple de hachage d'arborescence 2 : chargement d'une archive à l'aide d'un chargement partitionné
Le processus de calcul du hachage d'arborescence lors du chargement d'une archive à l'aide du chargement partitionné est identique à celui utilisé lors du chargement de l'archive dans le cadre d'une seule demande. La seule différence réside dans le fait que pour un chargement partitionné, vous ne chargez qu'une partie de l'archive dans chaque demande (à l'aide de l'API [Partie chargement (PUT uploadID)](api-upload-part.md)), et par conséquent, vous ne fournissez que le total de contrôle de la partie dans l'en-tête de demande `x-amz-sha256-tree-hash`. Cependant, une fois que vous avez chargé toutes les parties, vous devez envoyer la demande d'achèvement de chargement partitionné (consultez la section [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)) avec un hachage d'arborescence de la totalité de l'archive dans l'en-tête de demande `x-amz-sha256-tree-hash`.
![\[Schéma illustrant un exemple de hachage arborescent lors du téléchargement d'une archive à l'aide d'un téléchargement en plusieurs parties.\]](http://docs.aws.amazon.com/fr_fr/amazonglacier/latest/dev/images/TreeHash-MPU.png)
## Calcul du hachage d'arborescence d'un fichier
Les algorithmes présentés ici ont été sélectionnés à des fins de démonstration. Vous pouvez optimiser le code en fonction des besoins de votre scénario d'implémentation. Si vous utilisez un SDK Amazon pour programmer sur Amazon Glacier (Amazon Glacier), le calcul du hachage de l'arbre est effectué pour vous et il vous suffit de fournir la référence du fichier.
**Example 1 : Exemple Java**
L'exemple suivant montre comment calculer le hachage SHA256 arborescent d'un fichier à l'aide de Java. Vous pouvez exécuter cet exemple en fournissant un emplacement de fichier comme argument ou vous pouvez utiliser la méthode `TreeHashExample.computeSHA256TreeHash` directement à partir de votre code.
```
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
public class TreeHashExample {
static final int ONE_MB = 1024 * 1024;
/**
* Compute the Hex representation of the SHA-256 tree hash for the specified
* File
*
* @param args
* args[0]: a file to compute a SHA-256 tree hash for
*/
public static void main(String[] args) {
if (args.length < 1) {
System.err.println("Missing required filename argument");
System.exit(-1);
}
File inputFile = new File(args[0]);
try {
byte[] treeHash = computeSHA256TreeHash(inputFile);
System.out.printf("SHA-256 Tree Hash = %s\n", toHex(treeHash));
} catch (IOException ioe) {
System.err.format("Exception when reading from file %s: %s", inputFile,
ioe.getMessage());
System.exit(-1);
} catch (NoSuchAlgorithmException nsae) {
System.err.format("Cannot locate MessageDigest algorithm for SHA-256: %s",
nsae.getMessage());
System.exit(-1);
}
}
/**
* Computes the SHA-256 tree hash for the given file
*
* @param inputFile
* a File to compute the SHA-256 tree hash for
* @return a byte[] containing the SHA-256 tree hash
* @throws IOException
* Thrown if there's an issue reading the input file
* @throws NoSuchAlgorithmException
*/
public static byte[] computeSHA256TreeHash(File inputFile) throws IOException,
NoSuchAlgorithmException {
byte[][] chunkSHA256Hashes = getChunkSHA256Hashes(inputFile);
return computeSHA256TreeHash(chunkSHA256Hashes);
}
/**
* Computes a SHA256 checksum for each 1 MB chunk of the input file. This
* includes the checksum for the last chunk even if it is smaller than 1 MB.
*
* @param file
* A file to compute checksums on
* @return a byte[][] containing the checksums of each 1 MB chunk
* @throws IOException
* Thrown if there's an IOException when reading the file
* @throws NoSuchAlgorithmException
* Thrown if SHA-256 MessageDigest can't be found
*/
public static byte[][] getChunkSHA256Hashes(File file) throws IOException,
NoSuchAlgorithmException {
MessageDigest md = MessageDigest.getInstance("SHA-256");
long numChunks = file.length() / ONE_MB;
if (file.length() % ONE_MB > 0) {
numChunks++;
}
if (numChunks == 0) {
return new byte[][] { md.digest() };
}
byte[][] chunkSHA256Hashes = new byte[(int) numChunks][];
FileInputStream fileStream = null;
try {
fileStream = new FileInputStream(file);
byte[] buff = new byte[ONE_MB];
int bytesRead;
int idx = 0;
int offset = 0;
while ((bytesRead = fileStream.read(buff, offset, ONE_MB)) > 0) {
md.reset();
md.update(buff, 0, bytesRead);
chunkSHA256Hashes[idx++] = md.digest();
offset += bytesRead;
}
return chunkSHA256Hashes;
} finally {
if (fileStream != null) {
try {
fileStream.close();
} catch (IOException ioe) {
System.err.printf("Exception while closing %s.\n %s", file.getName(),
ioe.getMessage());
}
}
}
}
/**
* Computes the SHA-256 tree hash for the passed array of 1 MB chunk
* checksums.
*
* This method uses a pair of arrays to iteratively compute the tree hash
* level by level. Each iteration takes two adjacent elements from the
* previous level source array, computes the SHA-256 hash on their
* concatenated value and places the result in the next level's destination
* array. At the end of an iteration, the destination array becomes the
* source array for the next level.
*
* @param chunkSHA256Hashes
* An array of SHA-256 checksums
* @return A byte[] containing the SHA-256 tree hash for the input chunks
* @throws NoSuchAlgorithmException
* Thrown if SHA-256 MessageDigest can't be found
*/
public static byte[] computeSHA256TreeHash(byte[][] chunkSHA256Hashes)
throws NoSuchAlgorithmException {
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[][] prevLvlHashes = chunkSHA256Hashes;
while (prevLvlHashes.length > 1) {
int len = prevLvlHashes.length / 2;
if (prevLvlHashes.length % 2 != 0) {
len++;
}
byte[][] currLvlHashes = new byte[len][];
int j = 0;
for (int i = 0; i < prevLvlHashes.length; i = i + 2, j++) {
// If there are at least two elements remaining
if (prevLvlHashes.length - i > 1) {
// Calculate a digest of the concatenated nodes
md.reset();
md.update(prevLvlHashes[i]);
md.update(prevLvlHashes[i + 1]);
currLvlHashes[j] = md.digest();
} else { // Take care of remaining odd chunk
currLvlHashes[j] = prevLvlHashes[i];
}
}
prevLvlHashes = currLvlHashes;
}
return prevLvlHashes[0];
}
/**
* Returns the hexadecimal representation of the input byte array
*
* @param data
* a byte[] to convert to Hex characters
* @return A String containing Hex characters
*/
public static String toHex(byte[] data) {
StringBuilder sb = new StringBuilder(data.length * 2);
for (int i = 0; i < data.length; i++) {
String hex = Integer.toHexString(data[i] & 0xFF);
if (hex.length() == 1) {
// Append leading zero.
sb.append("0");
}
sb.append(hex);
}
return sb.toString().toLowerCase();
}
}
```
**Example 2 : Exemple C\$1 .NET**
L'exemple suivant montre comment calculer le hachage SHA256 arborescent d'un fichier. Vous pouvez exécuter cet exemple en fournissant un emplacement de fichier comme argument.
```
using System;
using System.IO;
using System.Security.Cryptography;
namespace ExampleTreeHash
{
class Program
{
static int ONE_MB = 1024 * 1024;
/**
* Compute the Hex representation of the SHA-256 tree hash for the
* specified file
*
* @param args
* args[0]: a file to compute a SHA-256 tree hash for
*/
public static void Main(string[] args)
{
if (args.Length < 1)
{
Console.WriteLine("Missing required filename argument");
Environment.Exit(-1);
}
FileStream inputFile = File.Open(args[0], FileMode.Open, FileAccess.Read);
try
{
byte[] treeHash = ComputeSHA256TreeHash(inputFile);
Console.WriteLine("SHA-256 Tree Hash = {0}", BitConverter.ToString(treeHash).Replace("-", "").ToLower());
Console.ReadLine();
Environment.Exit(-1);
}
catch (IOException ioe)
{
Console.WriteLine("Exception when reading from file {0}: {1}",
inputFile, ioe.Message);
Console.ReadLine();
Environment.Exit(-1);
}
catch (Exception e)
{
Console.WriteLine("Cannot locate MessageDigest algorithm for SHA-256: {0}",
e.Message);
Console.WriteLine(e.GetType());
Console.ReadLine();
Environment.Exit(-1);
}
Console.ReadLine();
}
/**
* Computes the SHA-256 tree hash for the given file
*
* @param inputFile
* A file to compute the SHA-256 tree hash for
* @return a byte[] containing the SHA-256 tree hash
*/
public static byte[] ComputeSHA256TreeHash(FileStream inputFile)
{
byte[][] chunkSHA256Hashes = GetChunkSHA256Hashes(inputFile);
return ComputeSHA256TreeHash(chunkSHA256Hashes);
}
/**
* Computes a SHA256 checksum for each 1 MB chunk of the input file. This
* includes the checksum for the last chunk even if it is smaller than 1 MB.
*
* @param file
* A file to compute checksums on
* @return a byte[][] containing the checksums of each 1MB chunk
*/
public static byte[][] GetChunkSHA256Hashes(FileStream file)
{
long numChunks = file.Length / ONE_MB;
if (file.Length % ONE_MB > 0)
{
numChunks++;
}
if (numChunks == 0)
{
return new byte[][] { CalculateSHA256Hash(null, 0) };
}
byte[][] chunkSHA256Hashes = new byte[(int)numChunks][];
try
{
byte[] buff = new byte[ONE_MB];
int bytesRead;
int idx = 0;
while ((bytesRead = file.Read(buff, 0, ONE_MB)) > 0)
{
chunkSHA256Hashes[idx++] = CalculateSHA256Hash(buff, bytesRead);
}
return chunkSHA256Hashes;
}
finally
{
if (file != null)
{
try
{
file.Close();
}
catch (IOException ioe)
{
throw ioe;
}
}
}
}
/**
* Computes the SHA-256 tree hash for the passed array of 1MB chunk
* checksums.
*
* This method uses a pair of arrays to iteratively compute the tree hash
* level by level. Each iteration takes two adjacent elements from the
* previous level source array, computes the SHA-256 hash on their
* concatenated value and places the result in the next level's destination
* array. At the end of an iteration, the destination array becomes the
* source array for the next level.
*
* @param chunkSHA256Hashes
* An array of SHA-256 checksums
* @return A byte[] containing the SHA-256 tree hash for the input chunks
*/
public static byte[] ComputeSHA256TreeHash(byte[][] chunkSHA256Hashes)
{
byte[][] prevLvlHashes = chunkSHA256Hashes;
while (prevLvlHashes.GetLength(0) > 1)
{
int len = prevLvlHashes.GetLength(0) / 2;
if (prevLvlHashes.GetLength(0) % 2 != 0)
{
len++;
}
byte[][] currLvlHashes = new byte[len][];
int j = 0;
for (int i = 0; i < prevLvlHashes.GetLength(0); i = i + 2, j++)
{
// If there are at least two elements remaining
if (prevLvlHashes.GetLength(0) - i > 1)
{
// Calculate a digest of the concatenated nodes
byte[] firstPart = prevLvlHashes[i];
byte[] secondPart = prevLvlHashes[i + 1];
byte[] concatenation = new byte[firstPart.Length + secondPart.Length];
System.Buffer.BlockCopy(firstPart, 0, concatenation, 0, firstPart.Length);
System.Buffer.BlockCopy(secondPart, 0, concatenation, firstPart.Length, secondPart.Length);
currLvlHashes[j] = CalculateSHA256Hash(concatenation, concatenation.Length);
}
else
{ // Take care of remaining odd chunk
currLvlHashes[j] = prevLvlHashes[i];
}
}
prevLvlHashes = currLvlHashes;
}
return prevLvlHashes[0];
}
public static byte[] CalculateSHA256Hash(byte[] inputBytes, int count)
{
SHA256 sha256 = System.Security.Cryptography.SHA256.Create();
byte[] hash = sha256.ComputeHash(inputBytes, 0, count);
return hash;
}
}
}
```
# Réception des totaux de contrôle lors du téléchargement de données
Lorsque vous extrayez une archive à l'aide de l'API de lancement de tâche (consultez la section [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)), vous pouvez éventuellement spécifier une plage à extraire de l'archive. De même, lorsque vous téléchargez vos données à l'aide de l'API de génération de sortie de tâche (consultez la section [Génération de sortie de tâche (GET output)](api-job-output-get.md)), vous pouvez éventuellement spécifier une plage de données à télécharger. Vous devez comprendre deux caractéristiques essentielles de ces plages lorsque vous procédez à l'extraction et au téléchargement des données de votre archive. La plage à extraire doit être *alignée en termes de méga-octets* avec l'archive. La plage à extraire et la plage à télécharger doivent toutes les deux être *alignées avec le hachage d'arborescence* pour vous permettre de recevoir les valeurs de total de contrôle lorsque vous téléchargez vos données. Les définitions de ces deux types d'alignement de plage sont les suivantes :
+ Aligné en mégaoctets : une plage [*StartByte*, *EndBytes*] est alignée en mégaoctets (1024\$1 1024) lorsqu'elle *StartBytes*est divisible par 1 Mo et *EndBytes*plus 1 est divisible par 1 Mo ou est égale à la fin de l'archive spécifiée (taille d'octet d'archive moins 1). Une plage utilisée dans l'API de lancement de tâche, si elle est spécifiée, doit être alignée en termes de méga-octets.
+ Aligné par arbre - Une plage [*StartBytes*, *EndBytes*] est un hachage arborescent aligné par rapport à une archive si et seulement si la racine du hachage arborescent construit sur cette plage est équivalente à un nœud dans le hachage arborescent de l'ensemble de l'archive. La plage à extraire et la plage à télécharger doivent toutes les deux être alignées avec le hachage d'arborescence pour vous permettre de recevoir les valeurs de total de contrôle des données que vous téléchargez. Pour obtenir un exemple de plages et de leur relation avec le hachage d'arborescence d'une archive, consultez la section [Exemple de hachage d'arborescence : Extraction d'une plage d'une archive qui est alignée avec le hachage d'arborescence](#checksum-calculations-upload-archive-with-ranges).
Notez qu'une plage alignée avec le hachage d'arborescence est également alignée en termes de méga-octets. En revanche, une plage alignée en termes de méga-octets n'est pas nécessairement alignée avec le hachage d'arborescence.
Les cas suivants décrivent à quel moment vous recevez une valeur de total de contrôle lorsque vous téléchargez vos données archivées :
+ Si vous ne spécifiez pas de plage à extraire dans la demande de lancement de tâche et que vous téléchargez la totalité de l'archive dans la demande d'affichage de tâche.
+ Si vous ne spécifiez pas de plage à extraire dans la demande de lancement de tâche et que vous indiquez une plage à télécharger dans la demande d'affichage de tâche qui est alignée avec le hachage d'arborescence.
+ Si vous spécifiez une plage à extraire dans la demande de lancement de tâche qui est alignée avec le hachage d'arborescence et que vous téléchargez la totalité de la plage dans la demande d'affichage de tâche.
+ Si vous spécifiez une plage à extraire dans la demande de lancement de tâche qui est alignée avec le hachage d'arborescence et que vous indiquez une plage à télécharger dans la demande d'affichage de tâche qui est alignée avec le hachage d'arborescence.
Si vous spécifiez une plage à extraire dans la demande de lancement de tâche qui n'est pas alignée avec le hachage d'arborescence, vous pouvez tout de même obtenir vos données archivées, mais aucune valeur de total de contrôle n'est renvoyée lorsque vous téléchargez des données dans le cadre de la demande d'affichage de tâche.
## Exemple de hachage d'arborescence : Extraction d'une plage d'une archive qui est alignée avec le hachage d'arborescence
Imaginons que votre coffre contient une archive de 6,5 Mo et que vous souhaitez extraire 2 Mo de l'archive. La façon dont vous spécifiez la plage de 2 Mo dans la demande de lancement de tâche détermine si vous recevez des valeurs de total de contrôle de données lorsque vous téléchargez vos données. Le schéma suivant illustre deux plages de 2 Mo que vous pouvez télécharger pour l'archive de 6,5 Mo. Les deux plages sont alignées en termes de méga-octets, mais une seule est alignée avec le hachage d'arborescence.
![\[Schéma illustrant la récupération d'une plage d'archives alignée par hachage arborescent.\]](http://docs.aws.amazon.com/fr_fr/amazonglacier/latest/dev/images/TreeHash-ArchiveWithRanges.png)
## Spécification de plage alignée avec le hachage d'arborescence
Cette section fournit la spécification exacte d'une plage alignée avec le hachage d'arborescence. Les plages alignées avec le hachage d'arborescence sont essentielles lorsque vous téléchargez une partie d'une archive et que vous spécifiez la plage de données à extraire et la plage de données extraites à télécharger. Si ces deux plages sont alignées avec le hachage d'arborescence, vous recevez des valeurs de total de contrôle lorsque vous téléchargez les données.
Une plage [*A*, *B*] est *alignée avec le hachage d'arborescence* par rapport à une archive si et seulement si lorsqu'un nouveau hachage d'arborescence est créé sur [*A*, *B*], la racine du hachage d'arborescence de cette plage équivaut à un nœud du hachage de la totalité de l'archive. Pour obtenir une illustration, consultez le schéma dans la section [Exemple de hachage d'arborescence : Extraction d'une plage d'une archive qui est alignée avec le hachage d'arborescence](#checksum-calculations-upload-archive-with-ranges). Cette section fournit la spécification de l'alignement avec le hachage d'arborescence.
Prenez par exemple [*P*, *Q*) comme requête de plage pour une archive de *N* méga-octets (Mo) et *P* et *Q* comme multiples d'un Mo. Notez que la plage inclusive réelle est [*P* Mo, *Q* MB - 1 octet], mais pour simplifier, nous la présentons sous la forme [*P*, *Q*). Ces considérations étant présentées,
+ Si *P* est un nombre impair, il n'y a qu'une seule plage possible à être alignée sur le hachage d'arborescence, à savoir [*P*, *P* \$1 1 Mo).
+ Si *P* est un nombre pair et que *k* est le nombre maximal, où *P* peut être écrit sous la forme 2*k* \$1 *X*, il y a au maximum *k* plages alignées sur le hachage d'arborescence qui commencent par *P*. *X* est un entier supérieur à 0. Les plages alignées avec le hachage d'arborescence sont classées dans les catégories suivantes :
+ Pour chaque *i*, où (0 <= *i* <= *k*) et où *P* \$1 2*i* < *N*, [*P*, *Q* \$1 2*i*) est une plage alignée avec le hachage d'arborescence.
+ *P* = 0 est le cas spécial où *A* = 2[lgN]\$10
# Réponses d’erreur
En cas d'erreur, l'API retourne l'une des exceptions suivantes :
| Code | Description | HTTP Status Code | Type |
| --- | --- | --- | --- |
| AccessDeniedException | Renvoyé en cas de tentative d'accès à une ressource non autorisée par une politique Gestion des identités et des accès AWS (IAM) ou si un Compte AWS identifiant incorrect a été utilisé dans l'URI de la demande. Pour de plus amples informations, veuillez consulter [Identity and Access Management pour Amazon Glacier](security-iam.md). | 403 Forbidden | Client |
| BadRequest | Retourné si la demande ne peut pas être traitée. | 400 Bad Request | Client |
| ExpiredTokenException | Retourné si le jeton de sécurité utilisé dans la demande a expiré. | 403 Forbidden | Client |
| InsufficientCapacityException | Renvoyé si la capacité est insuffisante pour traiter la 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 |
| InvalidParameterValueException | Retourné si un paramètre de la demande n'a pas été spécifié correctement. | 400 Bad Request | Client |
| InvalidSignatureException | Retourné si la signature de la demande n'est pas valide. | 403 Forbidden | Client |
| LimitExceededException | Renvoyé si la demande dépasse l'une des limites suivantes : une limite de coffre, une limite de balise ou une limite de capacité allouée. | 400 Bad Request | Client |
| MissingAuthenticationTokenException | Retourné si les données d'authentification ne sont pas trouvées pour la demande. | 400 Bad Request | Client |
| MissingParameterValueException | Retourné si un en-tête ou un paramètre obligatoire n'apparaît pas dans la demande. | 400 Bad Request | Client |
| PolicyEnforcedException | Retourné si une tâche d'extraction va dépasser la limite actuelle définie pour le taux d'extraction de la stratégie de données. 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). | 400 Bad Request | Client |
| ResourceNotFoundException | Retourné si la ressource spécifiée, par exemple un coffre, un ID de chargement ou un ID de tâche n'existe pas. | 404 Not Found | Client |
| RequestTimeoutException | Renvoyé en cas de téléchargement d'une archive et si le délai d'attente d'Amazon Glacier (Amazon Glacier) expire pendant la réception du téléchargement. | 408 Request Timeout | Client |
| SerializationException | Retourné si le corps de la demande n'est pas valide. Si une charge utile JSON est incluse, vérifiez qu'elle est bien formée. | 400 Bad Request | Client |
| ServiceUnavailableException | Retourné si le service ne peut pas terminer la demande. | 500 Internal Server Error | Serveur |
| ThrottlingException | Renvoyé si vous devez réduire le taux de demandes adressées à Amazon Glacier. | 400 Bad Request | Client |
| UnrecognizedClientException | Retourné si l'ID de clé d'accès ou le jeton de sécurité n'est pas valide. | 400 Bad Request | Client |
Plusieurs Amazon Glacier APIs renvoient la même exception, mais avec des messages d'exception différents pour vous aider à résoudre l'erreur spécifique rencontrée.
Amazon Glacier renvoie les informations d'erreur dans le corps de la réponse. Les exemples suivants illustrent quelques réponses envoyées en cas d'erreur.
## Exemple 1 : Description d'une demande de tâche avec un ID de tâche qui n'existe pas
Supposons que vous envoyiez une demande [Description de la tâche (GET JobID)](api-describe-job-get.md) correspondant à une tâche qui n'existe pas. Cela signifie que vous spécifiez un ID de tâche qui n'existe pas.
```
1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. 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
```
En réponse, Amazon Glacier renvoie la réponse d'erreur suivante.
```
HTTP/1.1 404 Not Found
x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg
Content-Type: application/json
Content-Length: 185
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
"code": "ResourceNotFoundException",
"message": "The job ID was not found: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID",
"type": "Client"
}
```
Où :
**Code**
L'une des exceptions générales.
*Type* : chaîne
**Message**
Description générique de la condition d'erreur propre à l'API qui retourne l'erreur.
*Type* : chaîne
**Type**
Source de l'erreur. Ce champ peut comporter l'une des valeurs suivantes : `Client`, `Server` ou `Unknown`.
*Type* : chaîne.
Notez le point suivant dans la réponse précédente :
+ Pour la réponse à l'erreur, Amazon Glacier renvoie les valeurs du code d'état de `4xx` et`5xx`. Dans cet exemple, le code de statut est `404 Not Found`.
+ La valeur d'en-tête `Content-Type` `application/json` indique JSON dans le corps
+ Le JSON dans le corps fournit les informations relatives à l'erreur.
Dans la demande précédente, au lieu d'un ID de tâche erroné, supposons que vous ayez spécifié un coffre qui n'existe pas. La réponse retourne un message différent.
```
HTTP/1.1 404 Not Found
x-amzn-RequestId: AAABBeC9Zw0rp_5D0L8VfB3FA_WlTupqTKAUehMcPhdgni0
Content-Type: application/json
Content-Length: 154
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
"code": "ResourceNotFoundException",
"message": "Vault not found for ARN: arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
"type": "Client"
}
```
## Exemple 2 : Demande d'établissement d'une liste des tâches avec une valeur non valide pour le paramètre de demande
Dans cet exemple, vous envoyez une demande [Affichage des tâches (GET jobs)](api-jobs-get.md) pour extraire les tâches de coffre avec un `statuscode` spécifique et vous fournissez une valeur `statuscode` `finished` incorrecte au lieu des valeurs acceptables `InProgress`, `Succeeded` ou`Failed`.
```
GET /-/vaults/examplevault/jobs?statuscode=finished HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
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
```
Amazon Glacier renvoie le `InvalidParameterValueException` avec le message approprié.
```
HTTP/1.1 400 Bad Request
x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg
Content-Type: application/json
Content-Length: 141
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
"code": "InvalidParameterValueException",
"message": "The job status code is not valid: finished",
"type: "Client"
}
```
# Opérations de coffre
Les opérations de coffre-fort disponibles dans Amazon Glacier sont les suivantes.
**Topics**
+ [
# Interruption du verrouillage du coffre (DELETE lock-policy)
](api-AbortVaultLock.md)
+ [
# Ajout de balises à un coffre (POST tags add)
](api-AddTagsToVault.md)
+ [
# Création de coffre (PUT vault)
](api-vault-put.md)
+ [
# Achèvement du verrouillage du coffre (POST lockId)
](api-CompleteVaultLock.md)
+ [
# Suppression de coffre (DELETE vault)
](api-vault-delete.md)
+ [
# Suppression de la stratégie d'accès au coffre (DELETE access-policy)
](api-DeleteVaultAccessPolicy.md)
+ [
# Supprimer les notifications de coffre (DELETE notification-configuration)
](api-vault-notifications-delete.md)
+ [
# Description de coffre (GET vault)
](api-vault-get.md)
+ [
# Obtention de la stratégie d'accès au coffre (GET access-policy)
](api-GetVaultAccessPolicy.md)
+ [
# Obtenir le verrouillage de coffre (GET lock-policy)
](api-GetVaultLock.md)
+ [
# Obtenir les notifications de coffre (GET notification-configuration)
](api-vault-notifications-get.md)
+ [
# Lancement de verrouillage de coffre (POST lock-policy)
](api-InitiateVaultLock.md)
+ [
# Affichage des balises d'un coffre (GET tags)
](api-ListTagsForVault.md)
+ [
# Affichage des coffres (GET vaults)
](api-vaults-get.md)
+ [
# Suppression des balises d'un coffre (POST tags remove)
](api-RemoveTagsFromVault.md)
+ [
# Définir la stratégie d'accès au coffre (PUT access-policy)
](api-SetVaultAccessPolicy.md)
+ [
# Définition d'une configuration de notification de coffre (PUT notification-configuration)
](api-vault-notifications-put.md)
# Interruption du verrouillage du coffre (DELETE lock-policy)
## Description
Cette opération arrête le processus de verrouillage de coffre si l'état du verrouillage de coffre n'est pas `Locked`. Si l'état du verrouillage du coffre est `Locked` lorsque cette opération est demandée, l'opération renvoie une erreur `AccessDeniedException`. Si le processus de verrouillage de coffre est arrêté, la politique de verrouillage de coffre est supprimée du coffre spécifié.
Le verrouillage du coffre est passé à l'état `InProgress` en appelant [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md). Le verrouillage du coffre est passé à l'état `Locked` en appelant [Achèvement du verrouillage du coffre (POST lockId)](api-CompleteVaultLock.md). Vous pouvez obtenir l'état d'un verrouillage de coffre en appelant [Obtenir le verrouillage de coffre (GET lock-policy)](api-GetVaultLock.md). Pour plus d'informations sur le processus de verrouillage de coffre, consultez la section [Verrou Amazon Glacier Vault](vault-lock.md). Pour plus d'informations sur les stratégies de verrouillage de coffre, consultez la page [Stratégies de verrouillage de coffre](vault-lock-policy.md).
Cette opération est idempotente. Vous pouvez appeler avec succès cette opération plusieurs fois si le verrouillage du coffre a l'état `InProgress` ou si aucune stratégie n'est associée au coffre.
## Requêtes
Pour supprimer la stratégie de verrouillage du coffre, envoyez une demande HTTP `DELETE` à l'URI de la sous-ressource `lock-policy` du coffre.
### Syntaxe
```
1. DELETE /AccountId/vaults/vaultName/lock-policy 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. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
### 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
Si la politique est correctement supprimée, Amazon Glacier renvoie une `HTTP 204 No Content` réponse.
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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 montre comment arrêter le processus de verrouillage de coffre.
### Exemple de requête
Dans le cadre de cet exemple, une demande `DELETE` est envoyée à la sous-ressource `lock-policy` du coffre nommé **examplevault**.
```
1. DELETE /-/vaults/examplevault/lock-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. x-amz-glacier-version: 2012-06-01
```
### Exemple de réponse
Si la politique est correctement supprimée, Amazon Glacier renvoie une `HTTP 204 No Content` réponse, comme illustré dans l'exemple suivant.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Achèvement du verrouillage du coffre (POST lockId)](api-CompleteVaultLock.md)
+ [Obtenir le verrouillage de coffre (GET lock-policy)](api-GetVaultLock.md)
+ [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/abort-vault-lock.html)
# Ajout de balises à un coffre (POST tags add)
Cette opération ajoute les balises spécifiées à un coffre. Chaque balise est constituée d'une clé et d'une valeur. Chaque coffre peut comporter jusqu'à 50 balises. Si votre demande entraîne le dépassement de la limite de balise pour le coffre, l'erreur `LimitExceededException` est générée par l'opération.
Si une balise existe déjà sur le coffre sous une clé spécifiée, la valeur de clé existante est remplacée. Pour en savoir plus sur les identifications, consultez [Balisage des ressources Amazon Glacier](tagging.md).
## Syntaxe de la requête
Pour ajouter des balises à un coffre, envoyez une demande HTTP POST à l'URI des balises, comme illustré dans l'exemple de syntaxe suivant.
```
1. POST /AccountId/vaults/vaultName/tags?operation=add HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
7.
8. {
9. "Tags":
10. {
11. "string": "string",
12. "string": "string"
13. }
14. }
```
**Note**
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
## Paramètres de demande
| Nom | Description | Obligatoire |
| --- | --- | --- |
| operation=add | Paramètre de chaîne de requête unique `operation` doté de la valeur `add` pour le distinguer de l'opération [Suppression des balises d'un coffre (POST tags remove)](api-RemoveTagsFromVault.md). | Oui |
### 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
Le corps de la demande contient les champs JSON suivants.
**Balises**
Balises à ajouter au coffre. Chaque balise est constituée d'une clé et d'une valeur. La valeur peut être une chaîne vide.
*Type :* mappage chaîne/chaîne
*Contraintes de longueur :* longueur minimale fixée à 1. Longueur maximale fixée à 10.
*Obligatoire* : oui
## Réponses
Si la demande d'opération aboutit, le service renvoie une réponse HTTP `204 No Content`.
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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
### Exemple de requête
L'exemple suivant envoie une demande HTTP POST avec les balises à ajouter au coffre.
```
1. POST /-/vaults/examplevault/tags?operation=add HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
7.
8. {
9. "Tags":
10. {
11. "examplekey1": "examplevalue1",
12. "examplekey2": "examplevalue2"
13. }
14. }
```
### Exemple de réponse
Si la demande est acceptée, Amazon Glacier renvoie un`HTTP 204 No Content`, comme indiqué dans l'exemple suivant.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```
## Sections connexes
+ [Affichage des balises d'un coffre (GET tags)](api-ListTagsForVault.md)
+ [Suppression des balises d'un coffre (POST tags remove)](api-RemoveTagsFromVault.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/add-tags-to-vault.html)
# Création de coffre (PUT vault)
## Description
Cette opération crée un nouveau coffre avec le nom spécifié. Le nom du coffre doit être unique au sein d'une AWS région pour un Compte AWS. Vous pouvez créer jusqu'à 1 000 coffres par compte. Pour plus d'informations sur la création d'autres coffres-forts, rendez-vous sur la [page détaillée du produit Amazon Glacier](https://aws.amazon.com/glacier).
Vous devez utiliser les instructions suivantes pour nommer un coffre.
+ Les noms peuvent comporter entre 1 et 255 caractères.
+ Les caractères autorisés sont a-z, A-Z, 0-9, « \$1 » (trait de soulignement), « - » (trait d'union) et « . » (point).
Cette opération est idempotente, vous pouvez envoyer la même demande plusieurs fois et elle n'a aucun autre effet après la première création par Amazon Glacier (Amazon Glacier) du coffre spécifié.
## Requêtes
### Syntaxe
Pour créer un coffre, envoyez une demande HTTP PUT à l'URI du coffre à créer.
```
1. PUT /AccountId/vaults/VaultName HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
```
**Note**
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
### 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
Le corps de la demande pour cette opération doit être vide (0 octet).
## Réponses
### Syntaxe
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
```
### En-têtes de réponse
Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. 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).
| Nom | Description |
| --- | --- |
| `Location` | Chemin d'accès par URI relatif du coffre qui a été créé. Type : String |
### Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
### 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
### Exemple de requête
L'exemple suivant envoie une demande HTTP PUT pour créer un coffre nommé `examplevault`.
```
1. PUT /-/vaults/examplevault 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. Content-Length: 0
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
Amazon Glacier crée le coffre et renvoie le chemin URI relatif du coffre dans l'`Location`en-tête. L'ID de compte est toujours affiché dans l'en-tête `Location`, que la demande spécifie un ID de compte ou un trait d'union ('`-`').
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. Location: /111122223333/vaults/examplevault
```
## Sections connexes
+ [Affichage des coffres (GET vaults)](api-vaults-get.md)
+ [Suppression de coffre (DELETE vault)](api-vault-delete.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/create-vault.html)
# Achèvement du verrouillage du coffre (POST lockId)
## Description
Cette opération termine le processus de verrouillage du coffre en passant le verrouillage du coffre de l'état `InProgress` à l'état `Locked`, ce qui provoque l'immuabilité de la stratégie de verrouillage du coffre. Le verrouillage du coffre est passé à l'état `InProgress` en appelant [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md). Vous pouvez obtenir l'état du verrouillage du coffre en appelant [Obtenir le verrouillage de coffre (GET lock-policy)](api-GetVaultLock.md). Pour plus d'informations sur le processus de verrouillage de coffre, consultez la section [Verrou Amazon Glacier Vault](vault-lock.md).
Cette opération est idempotente. Cette demande aboutit toujours si l'état du verrouillage du coffre est `Locked` et que l'ID de verrouillage fourni correspond à l'ID de verrouillage utilisé initialement pour verrouiller le coffre.
Si un ID de verrouillage non valide est passé dans la demande lorsque le verrouillage du coffre a l'état `Locked`, l'opération renvoie une erreur `AccessDeniedException`. Si un ID de verrouillage non valide est passé dans la demande lorsque l'état du verrouillage du coffre est `InProgress`, l'opération génère une erreur `InvalidParameter`.
## Requêtes
Pour terminer le processus de verrouillage du coffre, envoyez une demande HTTP `POST` à l'URI de la sous-ressource `lock-policy` du coffre avec un ID de verrouillage valide.
### Syntaxe
```
1. POST /AccountId/vaults/vaultName/lock-policy/lockId HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
```
**Note**
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
La valeur `lockId` est l'ID de verrouillage obtenu d'une demande [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md).
### 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
Si la demande d'opération aboutit, le service renvoie une réponse HTTP `204 No Content`.
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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
### Exemple de requête
L'exemple suivant envoie une demande HTTP POST avec l'ID de verrouillage pour terminer le processus de verrouillage du coffre.
```
1. POST /-/vaults/examplevault/lock-policy/AE863rKkWZU53SLW5be4DUcW HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
```
### Exemple de réponse
Si la demande aboutit, Amazon Glacier (Amazon Glacier) renvoie une `HTTP 204 No Content` réponse, comme indiqué dans l'exemple suivant.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```
## Sections connexes
+ [Interruption du verrouillage du coffre (DELETE lock-policy)](api-AbortVaultLock.md)
+ [Obtenir le verrouillage de coffre (GET lock-policy)](api-GetVaultLock.md)
+ [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/complete-vault-lock.html)
# Suppression de coffre (DELETE vault)
## Description
Cette opération supprime un coffre. Amazon Glacier (Amazon Glacier) supprimera un coffre-fort uniquement s'il ne contient aucune archive selon le dernier inventaire et s'il n'y a eu aucune écriture dans le coffre-fort depuis le dernier inventaire. Si l'une de ces conditions n'est pas remplie, la suppression du coffre échoue (c'est-à-dire que le coffre n'est pas supprimé) et Amazon Glacier renvoie un message d'erreur.
Vous pouvez utiliser l'[Description de coffre (GET vault)](api-vault-get.md)opération qui fournit des informations sur le coffre-fort, notamment le nombre d'archives qu'il contient ; toutefois, les informations sont basées sur le dernier inventaire du coffre-fort généré par Amazon Glacier.
Cette opération est idempotente.
**Note**
Lorsque vous supprimez un coffre, la stratégie d'accès au coffre qui lui est attachée est également supprimée. Pour plus d'informations sur les stratégies d'accès au coffre, consultez la section [Politiques d'accès au coffre-fort](vault-access-policy.md).
## Requêtes
Pour supprimer un coffre, envoyez une demande `DELETE` à l'URI de ressource de coffre.
### Syntaxe
```
1. DELETE /AccountId/vaults/VaultName 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
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 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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
### Exemple de requête
L'exemple suivant supprime un coffre nommé `examplevault`. L'exemple de demande est une demande `DELETE` envoyée à l'URI de la ressource (le coffre) à supprimer.
```
1. DELETE /-/vaults/examplevault 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
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```
## Sections connexes
+ [Création de coffre (PUT vault)](api-vault-put.md)
+ [Affichage des coffres (GET vaults)](api-vaults-get.md)
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/delete-vault.html)
# Suppression de la stratégie d'accès au coffre (DELETE access-policy)
## Description
Cette opération supprime la stratégie d'accès associée au coffre spécifié. L'opération est finalement cohérente, c'est-à-dire qu'Amazon Glacier (Amazon Glacier) peut mettre un certain temps à supprimer complètement la politique d'accès, et vous pouvez toujours constater l'effet de cette politique pendant une courte période après avoir envoyé la demande de suppression.
Cette opération est idempotente. Vous pouvez appeler une suppression plusieurs fois même si aucune stratégie n'est associée au coffre. Pour plus d'informations sur les stratégies d'accès au coffre, consultez la section [Politiques d'accès au coffre-fort](vault-access-policy.md).
## Requêtes
Pour supprimer la stratégie d'accès au coffre actuelle, envoyez une demande HTTP `DELETE` à l'URI de la sous-ressource `access-policy` du coffre.
### Syntaxe
```
1. DELETE /AccountId/vaults/vaultName/access-policy 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
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
En réponse, Amazon Glacier renvoie `204 No Content` si la stratégie est supprimée avec succès.
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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 montre comment supprimer une stratégie d'accès au coffre.
### Exemple de requête
Dans le cadre de cet exemple, une demande `DELETE` est envoyée à la sous-ressource `access-policy` du coffre nommé **examplevault**.
```
1. DELETE /-/vaults/examplevault/access-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. x-amz-glacier-version: 2012-06-01
```
### Exemple de réponse
En réponse, si la politique est correctement supprimée, Amazon Glacier renvoie un`204 No Content`, comme indiqué dans l'exemple suivant.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Obtention de la stratégie d'accès au coffre (GET access-policy)](api-GetVaultAccessPolicy.md)
+ [Définir la stratégie d'accès au coffre (PUT access-policy)](api-SetVaultAccessPolicy.md)
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/delete-vault-access-policy.html)
# Supprimer les notifications de coffre (DELETE notification-configuration)
## Description
Cette opération supprime la configuration de notification définie pour un coffre [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md). L'opération est finalement cohérente, c'est-à-dire qu'Amazon Glacier (Amazon Glacier) peut mettre un certain temps à désactiver complètement les notifications, et il se peut que vous continuiez à recevoir certaines notifications pendant une courte période après avoir envoyé la demande de suppression.
## Requêtes
Pour supprimer la configuration d'une notification de coffre, envoyez une demande `DELETE`à la sous-ressource `notification-configuration` du coffre.
### Syntaxe
```
1. DELETE /AccountId/vaults/VaultName/notification-configuration 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
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 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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 la suppression de la configuration de la notification pour un coffre.
### Exemple de requête
Dans le cadre de cet exemple, une demande `DELETE` est envoyée à la sous-ressource `notification-configuration` du coffre nommé `examplevault`.
```
1. DELETE /111122223333/vaults/examplevault/notification-configuration 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
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Obtenir les notifications de coffre (GET notification-configuration)](api-vault-notifications-get.md)
+ [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/delete-vault-notifications.html)
# Description de coffre (GET vault)
## Description
Cette opération renvoie des informations sur un coffre, y compris son Amazon Resource Name (ARN), sa date de création, le nombre d'archives qu'il contient et la taille totale de toutes ces archives. Le nombre d'archives et leur taille totale sont ceux du dernier inventaire de coffres-forts généré par Amazon Glacier (Amazon Glacier) (voir[Utilisation des coffres-forts dans Amazon Glacier](working-with-vaults.md)). Amazon Glacier génère des inventaires de coffres-forts environ tous les jours. Cela signifie que si vous ajoutez ou retirez une archive dans un coffre et que vous envoyez immédiatement une demande de description de coffre, la réponse peut ne pas refléter les modifications.
## Requêtes
Pour obtenir des informations sur un coffre, envoyez une demande `GET` à l'URI de la ressource de coffre spécifique.
### Syntaxe
```
1. GET /AccountId/vaults/VaultName 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
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 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
"CreationDate" : String,
"LastInventoryDate" : String,
"NumberOfArchives" : Number,
"SizeInBytes" : Number,
"VaultARN" : String,
"VaultName" : 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.
**CreationDate**
Date UTC à laquelle le coffre a été créé.
*Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**LastInventoryDate**
Date UTC à laquelle Amazon Glacier a terminé le dernier inventaire du coffre. Pour plus d'informations sur le lancement d'un inventaire pour un coffre, consultez la section [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md).
*Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**NumberOfArchives**
Nombre d'archives présentes dans le coffre en fonction du dernier inventaire du coffre. Ce champ renvoie une valeur null si un inventaire n'a pas encore été exécuté sur le coffre, par exemple, si celui-ci vient d'être créé.
*Type* : nombre
**SizeInBytes**
Taille totale, exprimée en octets, des archives présentes dans le coffre, y compris l'éventuelle surcharge de chaque archive, à la date du dernier inventaire. Ce champ renvoie une valeur `null` si un inventaire n'a pas encore été exécuté sur le coffre, par exemple, si celui-ci vient d'être créé.
*Type* : nombre
**VaultARN**
Amazon Resource Name (ARN) du coffre.
*Type* : chaîne
**VaultName**
Nom de coffre qui a été spécifié au moment de la création. Le nom de coffre est également inclus dans l'ARN du coffre.
*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
### Exemple de requête
L'exemple suivant montre comment obtenir des informations concernant le coffre nommé `examplevault`.
```
GET /-/vaults/examplevault 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
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. Content-Type: application/json
5. Content-Length: 260
6.
7. {
8. "CreationDate" : "2012-02-20T17:01:45.198Z",
9. "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
10. "NumberOfArchives" : 192,
11. "SizeInBytes" : 78088912,
12. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
13. "VaultName" : "examplevault"
14. }
```
## Sections connexes
+ [Création de coffre (PUT vault)](api-vault-put.md)
+ [Affichage des coffres (GET vaults)](api-vaults-get.md)
+ [Suppression de coffre (DELETE vault)](api-vault-delete.md)
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/describe-vault.html)
# Obtention de la stratégie d'accès au coffre (GET access-policy)
## Description
Cette opération extrait la sous-ressource `access-policy` définie au niveau du coffre (pour plus d'informations sur la définition de cette sous-ressource, consultez [Définir la stratégie d'accès au coffre (PUT access-policy)](api-SetVaultAccessPolicy.md)). Si aucune stratégie d'accès n'est définie sur le coffre, l'opération renvoie une erreur `404 Not found`. Pour plus d'informations sur les stratégies d'accès au coffre, consultez la section [Politiques d'accès au coffre-fort](vault-access-policy.md).
## Requêtes
Pour renvoyer la stratégie d'accès au coffre actuelle, envoyez une demande HTTP `GET` à l'URI de la sous-ressource `access-policy` du coffre.
### Syntaxe
```
1. GET /AccountId/vaults/vaultName/access-policy 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
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
En réponse, Amazon Glacier (Amazon Glacier) renvoie la politique d'accès au coffre-fort au format JSON dans le corps de la réponse.
### Syntaxe
```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
"Policy": "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.
**Stratégie**
Stratégie d'accès aux coffres sous forme de chaîne JSON, qui utilise « \$1 » comme caractère d'échappement.
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 montre comment obtenir une stratégie d'accès au coffre.
### Exemple de requête
Dans cet exemple, une demande `GET` est envoyée à l'URI de la sous-ressource `access-policy` d'un coffre.
```
1. GET /-/vaults/examplevault/access-policy 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
Si la demande aboutit, Amazon Glacier renvoie la politique d'accès au coffre-fort sous forme de chaîne JSON dans le corps de la réponse. La chaîne JSON renvoyée utilise « \$1 » comme caractère d'échappement, comme illustré dans les exemples [Définir la stratégie d'accès au coffre (PUT access-policy)](api-SetVaultAccessPolicy.md). Toutefois, l'exemple suivant montre la chaîne JSON retournée sans caractères d'échappement pour faciliter la lecture.
```
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: length
6.
7. {
8. "Policy": "
9. {
10. "Version": "2012-10-17",
11. "Statement": [
12. {
13. "Sid": "allow-time-based-deletes",
14. "Principal": {
15. "AWS": "999999999999"
16. },
17. "Effect": "Allow",
18. "Action": "glacier:Delete*",
19. "Resource": [
20. "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
21. ],
22. "Condition": {
23. "DateGreaterThan": {
24. "aws:CurrentTime": "2018-12-31T00:00:00Z"
25. }
26. }
27. }
28. ]
29. }
30. "
31. }
```
## Sections connexes
+ [Suppression de la stratégie d'accès au coffre (DELETE access-policy)](api-DeleteVaultAccessPolicy.md)
+ [Définir la stratégie d'accès au coffre (PUT access-policy)](api-SetVaultAccessPolicy.md)
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-vault-access-policy.html)
# Obtenir le verrouillage de coffre (GET lock-policy)
## Description
Cette opération extrait les attributs suivants à partir de la sous-ressource `lock-policy` définie sur le coffre spécifié :
+ La stratégie de verrouillage de coffre définie sur le coffre.
+ L'état du verrouillage du coffre, qui est soit `InProgess` soit `Locked`.
+ Moment où l'ID de verrouillage arrive à expiration. L'ID de verrouillage est utilisé pour terminer le processus de verrouillage du coffre.
+ Le moment où le verrouillage du coffre a été lancé et s'est vu attribuer l'état `InProgress`.
Le verrouillage du coffre est passé à l'état `InProgress` en appelant [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md). Le verrouillage du coffre est passé à l'état `Locked` en appelant [Achèvement du verrouillage du coffre (POST lockId)](api-CompleteVaultLock.md). Vous pouvez arrêter le processus de verrouillage de coffre en appelant [Interruption du verrouillage du coffre (DELETE lock-policy)](api-AbortVaultLock.md). Pour plus d'informations sur le processus de verrouillage de coffre, consultez la section [Verrou Amazon Glacier Vault](vault-lock.md).
Si aucune stratégie de verrouillage de coffre n'est définie sur le coffre, l'opération renvoie une erreur `404 Not found`. Pour plus d'informations sur les stratégies de verrouillage de coffre, consultez la page [Stratégies de verrouillage de coffre](vault-lock-policy.md).
## Requêtes
Pour renvoyer la stratégie de verrouillage de coffre actuelle et d'autres attributs, envoyez une demande `GET` HTTP à l'URI de la sous-ressource `lock-policy` du coffre, comme illustré dans l'exemple de syntaxe suivant.
### Syntaxe
```
1. GET /AccountId/vaults/vaultName/lock-policy 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
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
En réponse, Amazon Glacier (Amazon Glacier) renvoie la politique d'accès au coffre-fort au format JSON dans le corps de la réponse.
### Syntaxe
```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
"Policy": "string",
"State": "string",
"ExpirationDate": "string",
"CreationDate":"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.
**Stratégie**
Stratégie de verrouillage de coffre sous la forme une chaîne JSON, qui utilise « \$1 » comme caractère d'échappement.
Type : Chaîne
**État**
État du verrouillage du coffre.
Type : Chaîne
Valeurs valides : `InProgress``|Locked`
**ExpirationDate**
Date et heure UTC auxquelles l'ID de verrouillage expire. Cette valeur peut être `null`si le verrouillage de coffre se trouve dans un état `Locked`.
*Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**CreationDate**
Date et heure UTC auxquelles le verrouillage de coffre est passé à l'état `InProgress`t.
*Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
### 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 montre comment obtenir une stratégie de verrouillage de coffre.
### Exemple de requête
Dans cet exemple, une demande `GET` est envoyée à l'URI de la sous-ressource `lock-policy` d'un coffre.
```
1. GET /-/vaults/examplevault/lock-policy 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
Si la demande aboutit, Amazon Glacier renvoie la politique d'accès au coffre-fort sous forme de chaîne JSON dans le corps de la réponse. La chaîne JSON renvoyée utilise « \$1 » comme caractère d'échappement, comme illustré dans l'exemple de demande [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md). Toutefois, l'exemple suivant montre la chaîne JSON retournée sans caractères d'échappement pour faciliter la lecture.
```
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: length
6.
7. {
8. "Policy": "
9. {
10. "Version": "2012-10-17",
11. "Statement": [
12. {
13. "Sid": "Define-vault-lock",
14. "Principal": {
15. "AWS": "arn:aws:iam::999999999999:root"
16. },
17. "Effect": "Deny",
18. "Action": "glacier:DeleteArchive",
19. "Resource": [
20. "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
21. ],
22. "Condition": {
23. "NumericLessThanEquals": {
24. "glacier:ArchiveAgeInDays": "365"
25. }
26. }
27. }
28. ]
29. }
30. ",
31. "State": "InProgress",
32. "ExpirationDate": "exampledate",
33. "CreationDate": "exampledate"
34. }
```
## Sections connexes
+ [Interruption du verrouillage du coffre (DELETE lock-policy)](api-AbortVaultLock.md)
+ [Achèvement du verrouillage du coffre (POST lockId)](api-CompleteVaultLock.md)
+ [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md)
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-vault-lock.html)
# Obtenir les notifications de coffre (GET notification-configuration)
## Description
Cette opération extrait la sous-ressource `notification-configuration` définie sur le coffre (voir la section [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md). Si la configuration des notifications pour un coffre n'est pas définie, l'opération retourne une erreur `404 Not Found`. Pour plus d'informations sur les notifications de coffre, consultez la page [Configuration des notifications de coffre-fort dans Amazon Glacier](configuring-notifications.md).
## Requêtes
Pour extraire les informations de configuration des notifications, envoyez une demande `GET` à l'URI de la sous-ressource `notification-configuration` d'un coffre.
### Syntaxe
```
1. GET /AccountId/vaults/VaultName/notification-configuration 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
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 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
"Events": [
String,
...
],
"SNSTopic": 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.
**Événements**
Liste d'un ou de plusieurs événements pour lesquels Amazon Glacier (Amazon Glacier) enverra une notification à la rubrique Amazon SNS spécifiée. Pour plus d'informations sur les événements de coffre pour lesquels vous pouvez configurer un coffre afin de publier des notifications, consultez la section [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md).
*Type* : tableau
**SNSTopic**
Amazon Resource Name (ARN) de la rubrique Amazon Simple Notification Service (Amazon SNS). Pour plus d'informations, consultez [Démarrage avec Amazon SNS](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html) dans le *Guide de démarrage Amazon Simple Notification Service*.
*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 l'extraction de la configuration de notification pour un coffre.
### Exemple de requête
Dans cet exemple, une demande `GET` est envoyée à la sous-ressource `notification-configuration` d'un coffre.
```
1. GET /-/vaults/examplevault/notification-configuration 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
Une réponse positive présente le document de configuration de la journalisation d'audit dans le corps de la réponse au format JSON. Dans cet exemple, la configuration montre que les notifications pour deux événements (`ArchiveRetrievalCompleted` et `InventoryRetrievalCompleted`) sont envoyées à la rubrique Amazon SNS `arn:aws:sns:us-west-2:012345678901:mytopic`.
```
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: 150
6.
7. {
8. "Events": [
9. "ArchiveRetrievalCompleted",
10. "InventoryRetrievalCompleted"
11. ],
12. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
13. }
```
## Sections connexes
+ [Supprimer les notifications de coffre (DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-vault-notifications.html)
# Lancement de verrouillage de coffre (POST lock-policy)
## Description
Cette opération lance le processus de verrouillage de coffre en procédant comme suit :
+ Installation d'une stratégie de verrouillage de coffre sur le coffre spécifié.
+ Affectation de l'état `InProgress` au verrouillage de coffre.
+ Renvoi d'un ID de verrouillage qui est utilisé pour terminer le processus de verrouillage de coffre.
Vous pouvez définir une stratégie de verrouillage de coffre pour chaque coffre et la taille de cette stratégie peut atteindre 20 Ko. Pour plus d'informations sur les stratégies de verrouillage de coffre, consultez la page [Stratégies de verrouillage de coffre](vault-lock-policy.md).
Vous devez terminer le processus de verrouillage de coffre dans un délai de 24 heures après le passage à l'état `InProgress` du verrouillage de coffre. Au terme de la fenêtre de 24 heures, l'ID de verrouillage expire, le coffre quitte automatiquement l'état `InProgress` et la stratégie de verrouillage de coffre est retirée du coffre. Vous appelez [Achèvement du verrouillage du coffre (POST lockId)](api-CompleteVaultLock.md) pour terminer le processus de verrouillage de coffre en affectant l'état `Locked` au verrouillage de coffre.
**Note**
Lorsqu'un verrouillage de coffre est à l'état `Locked`, vous ne pouvez pas lancer un nouveau verrouillage de coffre pour le coffre.
Vous pouvez arrêter le processus de verrouillage de coffre en appelant [Interruption du verrouillage du coffre (DELETE lock-policy)](api-AbortVaultLock.md). Vous pouvez obtenir l'état du verrouillage de coffre en appelant [Obtenir le verrouillage de coffre (GET lock-policy)](api-GetVaultLock.md). Pour plus d'informations sur le processus de verrouillage de coffre, consultez la section [Verrou Amazon Glacier Vault](vault-lock.md).
Si cette opération est appelée alors que le verrouillage de coffre est à l'état `InProgress`, l'opération renvoie une erreur `AccessDeniedException`. Lorsque le verrouillage de coffre est à l'état `InProgress`, vous devez appeler [Interruption du verrouillage du coffre (DELETE lock-policy)](api-AbortVaultLock.md) avant de pouvoir lancer une nouvelle stratégie de verrouillage de coffre.
## Requêtes
Pour lancer le processus de verrouillage de coffre, envoyez une demande HTTP `POST` à l'URI de la sous-ressource `lock-policy` du coffre, comme illustré dans l'exemple de syntaxe suivant.
### Syntaxe
```
1. POST /AccountId/vaults/vaultName/lock-policy HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
7.
8. {
9. "Policy": "string"
10. }
```
**Note**
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
### 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
Le corps de la demande contient les champs JSON suivants.
**Stratégie**
Stratégie de verrouillage de coffre sous la forme une chaîne JSON, qui utilise « \$1 » comme caractère d'échappement.
Type : String
Obligatoire : oui
## Réponses
Amazon Glacier (Amazon Glacier) renvoie une `HTTP 201 Created` réponse si la politique est acceptée.
### Syntaxe
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-lock-id: lockId
```
### En-têtes de réponse
Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. 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).
| Nom | Description |
| --- | --- |
| x-amz-lock-id | ID de verrouillage qui est utilisé pour terminer le processus de verrouillage de coffre. Type : String |
### Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
### 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
### Exemple de requête
L'exemple suivant envoie une demande HTTP `PUT` à l'URI de la sous-ressource `lock-policy` du coffre. La chaîne JSON `Policy` utilise « \$1 » comme caractère d'échappement.
```
1. PUT /-/vaults/examplevault/lock-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
7.
8. {"Policy":"{\"Version\":\"2012-10-17\", \"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}
```
### Exemple de réponse
Si la demande aboutit, Amazon Glacier renvoie une `HTTP 201 Created` réponse, comme illustré dans l'exemple suivant.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. x-amz-lock-id: AE863rKkWZU53SLW5be4DUcW
```
## Sections connexes
+ [Interruption du verrouillage du coffre (DELETE lock-policy)](api-AbortVaultLock.md)
+ [Achèvement du verrouillage du coffre (POST lockId)](api-CompleteVaultLock.md)
+ [Obtenir le verrouillage de coffre (GET lock-policy)](api-GetVaultLock.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/initiate-vault-lock.html)
# Affichage des balises d'un coffre (GET tags)
Cette opération affiche la liste de toutes les balises attachées à un coffre. En l'absence de balises, elle renvoie un mappage vide. Pour en savoir plus sur les identifications, consultez [Balisage des ressources Amazon Glacier](tagging.md).
## Syntaxe de la requête
Pour afficher la liste des balises attachées à un coffre, envoyez une demande HTTP GET à l'URI des balises, comme illustré dans l'exemple de syntaxe suivant.
```
1. GET /AccountId/vaults/vaultName/tags 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. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
## 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
Si l'opération aboutit, le service renvoie une réponse HTTP `200 OK`.
### Syntaxe de la réponse
```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
"Tags":
{
"string" : "string",
"string" : "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.
**Balises**
Balises attachées au coffre. Chaque balise est constituée d'une clé et d'une valeur.
*Type :* mappage chaîne/chaîne
*Obligatoire* : oui
### 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
### Exemple : Affichage de la liste des balises attachées à un coffre
L'exemple suivant affiche la liste des balises attachées à un coffre.
#### Exemple de requête
Dans cet exemple, une demande GET est envoyée pour extraire une liste de balises du coffre spécifié.
```
1. GET /-/vaults/examplevault/tags 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
Si la demande aboutit, Amazon Glacier (Amazon Glacier) renvoie un `HTTP 200 OK` contenant une liste de balises pour le coffre-fort, comme indiqué dans l'exemple suivant.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. Content-Type: application/json
5. Content-Length: length
6.
7. {
8. "Tags",
9. {
10. "examplekey1": "examplevalue1",
11. "examplekey2": "examplevalue2"
12. }
13. }
```
## Sections connexes
+ [Ajout de balises à un coffre (POST tags add)](api-AddTagsToVault.md)
+ [Suppression des balises d'un coffre (POST tags remove)](api-RemoveTagsFromVault.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/list-tags-for-vault.html)
# Affichage des coffres (GET vaults)
## Description
Cette opération affiche la liste de tous les coffres dont le compte de l'utilisateur appelant est propriétaire. La liste renvoyée dans la réponse est triée en fonction des valeurs ASCII des noms de coffre.
Par défaut, cette opération renvoie jusqu'à 10 éléments par demande. S'il existe d'autres coffres à afficher, le champ `marker` du corps de la réponse contient l'Amazon Resource Name (ARN) du coffre à partir duquel poursuivre l'affichage de la liste avec une nouvelle demande d'affichage des coffres ; sinon, la valeur du champ `marker` est `null`. Dans votre prochaine demande List Vaults, vous définissez le `marker` paramètre sur la valeur renvoyée par Amazon Glacier (Amazon Glacier) dans les réponses à votre précédente demande List Vaults. Vous pouvez également limiter le nombre de coffres renvoyés dans la réponse en spécifiant le paramètre `limit` dans la demande.
## Requêtes
Pour obtenir une liste de coffres, vous envoyez une demande `GET` à la ressource *vaults*.
### Syntaxe
```
1. GET /AccountId/vaults 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. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
### Paramètres de demande
Cette opération utilise les paramètres de demande suivants.
| Nom | Description | Obligatoire |
| --- | --- | --- |
| limit | Le nombre maximum de coffres à renvoyer. La limite par défaut est de 10. Il peut arriver que le nombre de coffres renvoyés soit inférieur à la limite spécifiée, mais il ne sera jamais supérieur à cette valeur. Type : String Contraintes : la valeur d'entier minimale est 1. La valeur d'entier maximale est 10. | Non |
| marker | Chaîne opaque utilisée pour la pagination. `marker` spécifie l'ARN du coffre à partir duquel l'affichage de la liste de coffres doit débuter. (Le coffre spécifié pour le paramètre `marker` n'est pas inclus dans la liste renvoyée.) Obtenez la valeur du paramètre `marker` à partir d'une réponse à une demande d'affichage des coffres précédente. Vous ne devez inclure la valeur du paramètre `marker` que si vous poursuivez la pagination de résultats commencée dans une demande d'affichage des coffres précédente. Si une valeur vide ("") est spécifiée pour le paramètre marker, la liste de coffres renvoyée débute à partir du premier coffre. Type : String Contraintes: Aucune | Non |
### 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 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
"Marker": String
"VaultList": [
{
"CreationDate": String,
"LastInventoryDate": String,
"NumberOfArchives": Number,
"SizeInBytes": Number,
"VaultARN": String,
"VaultName": 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.
**CreationDate**
Date à laquelle le coffre a été créé, exprimée en heure UTC (temps universel coordonné).
*Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**LastInventoryDate**
Date du dernier inventaire du coffre, exprimée en heure UTC (temps universel coordonné). Ce champ peut avoir une valeur null si un inventaire n'a pas encore été exécuté sur le coffre, par exemple, si celui-ci vient d'être créé. Pour plus d'informations sur le lancement d'un inventaire pour un coffre, consultez la section [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md).
*Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**Marker**
Champ `vaultARN` représentant l'endroit à partir duquel poursuivre la pagination des résultats. Vous utilisez la valeur du paramètre `marker` dans une autre demande d'affichage des coffres pour obtenir davantage de coffres dans la liste. S'il n'y a pas d'autres coffres, cette valeur est `null`.
*Type* : chaîne
**NumberOfArchives**
Nombre d'archives présentes dans le coffre à la date du dernier inventaire.
*Type* : nombre
**SizeInBytes**
Taille totale, exprimée en octets, de toutes les archives présentes dans le coffre, y compris l'éventuelle surcharge de chaque archive, à la date du dernier inventaire.
*Type* : nombre
**VaultARN**
Amazon Resource Name (ARN) du coffre.
*Type* : chaîne
**VaultList**
Tableau d'objets, chacun d'eux fournissant une description d'un coffre.
*Type* : tableau
**VaultName**
Nom du coffre.
*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
### Exemple : Affichage de la liste de tous les coffres
L'exemple suivant affiche la liste des coffres. Dans la mesure où les paramètres `marker` et `limit` ne sont pas spécifiés dans la demande, jusqu'à 10 coffres peuvent être renvoyés.
#### Exemple de requête
```
1. GET /-/vaults 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 valeur du champ `Marker` est `null`, ce qui signifie qu'il n'y a pas d'autres coffres à afficher.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. Content-Type: application/json
5. Content-Length: 497
6.
7. {
8. "Marker": null,
9. "VaultList": [
10. {
11. "CreationDate": "2012-03-16T22:22:47.214Z",
12. "LastInventoryDate": "2012-03-21T22:06:51.218Z",
13. "NumberOfArchives": 2,
14. "SizeInBytes": 12334,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
16. "VaultName": "examplevault1"
17. },
18. {
19. "CreationDate": "2012-03-19T22:06:51.218Z",
20. "LastInventoryDate": "2012-03-21T22:06:51.218Z",
21. "NumberOfArchives": 0,
22. "SizeInBytes": 0,
23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
24. "VaultName": "examplevault2"
25. },
26. {
27. "CreationDate": "2012-03-19T22:06:51.218Z",
28. "LastInventoryDate": "2012-03-25T12:14:31.121Z",
29. "NumberOfArchives": 0,
30. "SizeInBytes": 0,
31. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
32. "VaultName": "examplevault3"
33. }
34. ]
35. }
```
### Exemple : Affichage d'une liste partielle de coffres
L'exemple suivant renvoie deux coffres à partir du coffre spécifié par le paramètre `marker`.
#### Exemple de requête
```
1. GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 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
Deux coffres sont renvoyés dans la liste. Le champ `Marker` contient l'ARN de coffre à utiliser afin de poursuivre la pagination dans une autre demande d'affichage des coffres.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. Content-Type: application/json
5. Content-Length: 497
6.
7. {
8. "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
9. "VaultList": [
10. {
11. "CreationDate": "2012-03-16T22:22:47.214Z",
12. "LastInventoryDate": "2012-03-21T22:06:51.218Z",
13. "NumberOfArchives": 2,
14. "SizeInBytes": 12334,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
16. "VaultName": "examplevault1"
17. },
18. {
19. "CreationDate": "2012-03-19T22:06:51.218Z",
20. "LastInventoryDate": "2012-03-21T22:06:51.218Z",
21. "NumberOfArchives": 0,
22. "SizeInBytes": 0,
23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
24. "VaultName": "examplevault2"
25. }
26. ]
27. }
```
## Sections connexes
+ [Création de coffre (PUT vault)](api-vault-put.md)
+ [Suppression de coffre (DELETE vault)](api-vault-delete.md)
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/list-vaults.html)
# Suppression des balises d'un coffre (POST tags remove)
Cette opération supprime une ou plusieurs balises dans la série de balises attachées à un coffre. Pour en savoir plus sur les identifications, consultez [Balisage des ressources Amazon Glacier](tagging.md).
Cette opération est idempotente. L'opération aboutira même s'il n'y a pas de balises attachées au coffre.
## Syntaxe de la requête
Pour supprimer des balises d'un coffre, envoyez une demande HTTP POST à l'URI des balises, comme il est illustré dans l'exemple de syntaxe suivant.
```
POST /AccountId/vaults/vaultName/tags?operation=remove HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
{
"TagKeys": [
"string",
"string"
]
}
```
**Note**
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
## Paramètres de demande
| Nom | Description | Obligatoire |
| --- | --- | --- |
| operation=remove | Paramètre de chaîne de requête unique `operation` doté de la valeur `remove` pour le distinguer de l'opération [Ajout de balises à un coffre (POST tags add)](api-AddTagsToVault.md). | Oui |
### 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
Le corps de la demande contient les champs JSON suivants.
**TagKeys**
Une liste de clés de balise. Chaque balise correspondante est supprimée du coffre.
*Type :* tableau de chaînes
*Contrainte de longueur :* Minimum de 1 élément dans la liste. Maximum de 10 éléments dans la liste.
*Obligatoire* : oui
## Réponses
Si l'action aboutit, le service renvoie une réponse HTTP `204 No Content` avec un corps HTTP vide.
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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
### Exemple de requête
L'exemple suivant envoie une demande HTTP POST pour supprimer les balises spécifiées.
```
1. POST /-/vaults/examplevault/tags?operation=remove HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
7.
8. {
9. "TagsKeys": [
10. "examplekey1",
11. "examplekey2"
12. ]
13. }
```
### Exemple de réponse
Si la demande est acceptée, Amazon Glacier (Amazon Glacier) renvoie un `HTTP 204 No Content` comme indiqué dans l'exemple suivant.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```
## Sections connexes
+ [Ajout de balises à un coffre (POST tags add)](api-AddTagsToVault.md)
+ [Affichage des balises d'un coffre (GET tags)](api-ListTagsForVault.md)
## consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/remove-tags-from-vault.html)
# Définir la stratégie d'accès au coffre (PUT access-policy)
## Description
Cette opération configure une stratégie d'accès à un coffre et remplace toute stratégie existante. Pour configurer une stratégie d'accès aux coffres, envoyez une demande `PUT` à la sous-ressource `access-policy` du coffre. Vous pouvez définir une stratégie d'accès par coffre et cette stratégie peut atteindre 20 Ko. Pour plus d'informations sur les stratégies d'accès au coffre, consultez la section [Politiques d'accès au coffre-fort](vault-access-policy.md).
## Requêtes
### Syntaxe
Pour définir une stratégie d'accès aux coffres, envoyez une demande `PUT` HTTP à l'URI de la sous-ressource `access-policy` du coffre, comme illustré dans l'exemple de syntaxe suivant.
```
1. PUT /AccountId/vaults/vaultName/access-policy HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
7.
8. {
9. "Policy": "string"
10. }
```
**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 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
Le corps de la demande contient les champs JSON suivants.
**Stratégie**
Stratégie d'accès aux coffres sous forme de chaîne JSON, qui utilise « \$1 » comme caractère d'échappement.
Type : Chaîne
Obligatoire : oui
## Réponses
En réponse, Amazon Glacier revient `204 No Content` si la politique est acceptée.
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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
### Exemple de requête
L'exemple suivant envoie une demande HTTP `PUT` à l'URI de la sous-ressource `access-policy` du coffre. La chaîne JSON `Policy` utilise « \$1 » comme caractère d'échappement.
```
1. PUT /-/vaults/examplevault/access-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
7.
8. {"Policy":"{\"Version\":\"2012-10-17\", \"Statement\":[{\"Sid\":\"Define-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}"}
```
### Exemple de réponse
Si la demande aboutit, Amazon Glacier (Amazon Glacier) renvoie un `HTTP 204 No Content` comme indiqué dans l'exemple suivant.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```
## Sections connexes
+ [Suppression de la stratégie d'accès au coffre (DELETE access-policy)](api-DeleteVaultAccessPolicy.md)
+ [Obtention de la stratégie d'accès au coffre (GET access-policy)](api-GetVaultAccessPolicy.md)
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-access-policy.html)
# Définition d'une configuration de notification de coffre (PUT notification-configuration)
## Description
La récupération d'une archive et d'un inventaire du coffre est une opération asynchrone dans Amazon Glacier (Amazon Glacier) pour laquelle vous devez d'abord lancer une tâche et attendre que la tâche soit terminée avant de pouvoir télécharger le résultat de la tâche. Vous pouvez configurer un coffre pour qu'il publie un message dans une rubrique Amazon Simple Notification Service (Amazon SNS) une fois que ces tâches sont terminées. Vous pouvez utiliser cette opération pour définir une configuration de notification sur le coffre. Pour de plus amples informations, veuillez consulter [Configuration des notifications de coffre-fort dans Amazon Glacier](configuring-notifications.md).
Pour configurer des notifications de coffre, envoyez une demande PUT à la sous-ressource `notification-configuration` du coffre. Une configuration de notification est propre à un coffre ; par conséquent, elle est également appelée sous-ressource de coffre. La demande doit inclure un document JSON qui fournit une rubrique Amazon Simple Notification Service (Amazon SNS) et les événements pour lesquels vous souhaitez qu'Amazon Glacier envoie des notifications à cette rubrique.
Vous pouvez configurer un coffre afin qu'il publie une notification pour les événements de coffre suivants :
+ **`ArchiveRetrievalCompleted` :** cet événement se produit lorsqu'une tâche de lancement d'extraction d'archive se termine ([Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)). L'état de la tâche terminée peut être `Succeeded` ou `Failed`. La notification envoyée à la rubrique SNS est identique à la sortie renvoyée par une opération [Description de la tâche (GET JobID)](api-describe-job-get.md).
+ **`InventoryRetrievalCompleted` :** cet événement se produit lorsqu'une tâche de lancement d'extraction d'inventaire se termine ([Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)). L'état de la tâche terminée peut être `Succeeded` ou `Failed`. La notification envoyée à la rubrique SNS est identique à la sortie renvoyée par une opération [Description de la tâche (GET JobID)](api-describe-job-get.md).
Les rubriques Amazon SNS doivent autoriser le coffre à publier des notifications dans la rubrique.
## Requêtes
Pour définir une configuration de notification sur votre coffre, envoyez une demande PUT à l'URI de la sous-ressource `notification-configuration` du coffre. Vous spécifiez la configuration dans le corps de la demande. La configuration comprend le nom de la rubrique Amazon SNS et un tableau des événements qui déclenchent l'envoi d'une notification à chaque rubrique.
### Syntaxe
```
1. PUT /AccountId/vaults/VaultName/notification-configuration 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. "SNSTopic": String,
9. "Events":[String, ...]
10. }
```
**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 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
Le code JSON contient les champs suivants dans le corps de la demande :
**Événements**
Ensemble d'un ou de plusieurs événements pour lesquels vous souhaitez qu'Amazon Glacier envoie une notification.
*Valeurs valides* : `ArchiveRetrievalCompleted` \$1 `InventoryRetrievalCompleted`
*Obligatoire* : oui
*Type* : tableau
**SNSTopic**
ARN de la rubrique Amazon SNS. Pour plus d'informations, accédez à [Démarrage avec Amazon SNS](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html) dans le *Guide de démarrage Amazon Simple Notification Service*.
*Obligatoire* : oui
*Type* : chaîne
## Réponses
En réponse, Amazon Glacier (Amazon Glacier) revient `204 No Content` si la configuration des notifications est acceptée.
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### En-têtes de réponse
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 réponse
Cette opération ne renvoie pas de corps de réponse.
### 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 montre comment configurer la notification de coffre.
### Exemple de requête
La demande suivante définit la configuration des notifications de `examplevault` qui prévoit l'envoi de notifications pour deux événements (`ArchiveRetrievalCompleted` et `InventoryRetrievalCompleted`) à la rubrique Amazon SNS `arn:aws:sns:us-west-2:012345678901:mytopic`.
```
1. PUT /-/vaults/examplevault/notification-policy 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. "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"],
9. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
10. }
```
### Exemple de réponse
Une réponse positive renvoie le code de réponse `204 No Content`.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Obtenir les notifications de coffre (GET notification-configuration)](api-vault-notifications-get.md)
+ [Supprimer les notifications de coffre (DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-notifications.html)
# Opérations d'archivage
Les opérations d'archivage disponibles pour une utilisation dans Amazon Glacier sont les suivantes.
**Topics**
+ [
# Suppression d'une archive (DELETE archive)
](api-archive-delete.md)
+ [
# Chargement d'archive (POST archive)
](api-archive-post.md)
# Suppression d'une archive (DELETE archive)
## Description
Cette opération supprime une archive d'un coffre. Vous pouvez supprimer une archive à la fois à partir d'un coffre. Pour supprimer l'archive, vous devez fournir son ID d'archive dans la demande de suppression. Vous pouvez obtenir l'ID de l'archive en téléchargeant l'inventaire du coffre qui contient l'archive. Pour plus d'informations sur le téléchargement de l'inventaire de coffre, consultez la page [Téléchargement d'un inventaire de coffre-fort dans Amazon Glacier](vault-inventory.md).
Une fois que vous avez supprimé une archive, vous pouvez toujours faire une demande de lancement d'une tâche afin d'extraire l'archive supprimée, mais la tâche d'extraction de l'archive échouera.
Les extractions d'archives en cours pour un ID d'archivage lorsque vous supprimez l'archive peuvent ou non selon les scénarios suivants :
+ Si la tâche de récupération des archives prépare activement les données pour le téléchargement lorsqu'Amazon Glacier (Amazon Glacier) reçoit la demande de suppression de l'archive, l'opération de récupération des archives risque d'échouer.
+ Si la tâche de récupération de l'archive a correctement préparé l'archive pour le téléchargement lorsqu'Amazon Glacier reçoit la demande de suppression de l'archive, vous pourrez télécharger le résultat.
Pour plus d'informations sur l'extraction de l'archive, consultez la section [Téléchargement d'une archive dans Amazon Glacier](downloading-an-archive.md).
Cette opération est idempotente. Une tentative de suppression d'une archive déjà supprimée ne génère aucune erreur.
## Requêtes
Pour supprimer une archive, envoyez une demande `DELETE` à l'URI de la ressource d'archive.
### Syntaxe
```
1. DELETE /AccountId/vaults/VaultName/archives/ArchiveID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. x-amz-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
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 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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 montre comment supprimer une archive du coffre nommé `examplevault`.
### Exemple de requête
L'ID de l'archive à supprimer est spécifié comme étant une sous-ressource de `archives`.
```
1. DELETE /-/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId 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
Si la demande aboutit, Amazon Glacier répond `204 No Content` pour indiquer que l'archive est supprimée.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Chargement d'archive (POST archive)](api-archive-post.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Chargement d'archive (POST archive)
## Description
Cette opération ajoute une archive à un coffre. Pour qu'un chargement aboutisse, vos données sont conservées durablement. En réponse, Amazon Glacier (Amazon Glacier) renvoie l'ID d'archive dans l'`x-amz-archive-id`en-tête de la réponse. Vous devez enregistrer l'ID d'archive ainsi renvoyé afin de l'utiliser pour accéder ultérieurement à l'archive.
Vous devez fournir un hachage SHA256 arborescent des données que vous téléchargez. Pour plus d'informations sur le calcul d'un hachage SHA256 arborescent, consultez[Calcul des totaux de contrôle](checksum-calculations.md).
**Note**
Le hachage de l' SHA256 arbre n'est requis que pour l'action Upload Archive (archive POST) lors de l'utilisation de l'API. Cela n'est pas obligatoire lors de l'utilisation du AWS CLI.
Lorsque vous chargez une archive, vous avez la possibilité de décrire l'archive dans les limites de 1 024 caractères ASCII imprimables. Amazon Glacier renvoie la description de l'archive lorsque vous récupérez l'archive ou que vous obtenez l'inventaire du coffre-fort. Amazon Glacier n'interprète en aucune façon la description. Une description d'archive ne doit pas nécessairement être unique. Vous ne pouvez pas utiliser la description pour extraire ou trier la liste d'archives.
À l'exception de la description facultative de l'archive, Amazon Glacier ne prend en charge aucune métadonnée supplémentaire pour les archives. L'ID d'archive est une séquence de caractères opaque qui ne permet de déduire aucune information concernant l'archive. Par conséquent, vous pouvez conserver les métadonnées sur les archives côté client. Pour de plus amples informations, veuillez consulter [Utilisation des archives dans Amazon Glacier](working-with-archives.md).
Les archives sont immuables. Une fois que vous avez chargé une archive, vous ne pouvez pas modifier son contenu ni sa description.
## Requêtes
Pour charger une archive, utilisez la méthode HTTP `POST` et limitez la portée de la demande à la sous-ressource `archives` du coffre dans lequel vous souhaitez enregistrer l'archive. La demande doit inclure la taille de la charge utile de l'archive, la somme de contrôle (hachage de l'SHA256 arbre) et peut éventuellement inclure une description de l'archive.
### Syntaxe
```
1. POST /AccountId/vaults/VaultName/archives
2. Host: glacier.Region.amazonaws.com
3. x-amz-glacier-version: 2012-06-01
4. Date: Date
5. Authorization: SignatureValue
6. x-amz-archive-description: Description
7. x-amz-sha256-tree-hash: SHA256 tree hash
8. x-amz-content-sha256: SHA256 linear hash
9. Content-Length: Length
10.
11.
```
**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 implémentation de l'opération n'utilise pas de 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 |
| --- | --- | --- |
| Content-Length | Taille de l'objet, exprimée en octets. Pour plus d'informations, rendez-vous sur [http://www.w3. org/Protocols/rfc2616/rfc2616-sec14.html \$1sec14 .13.](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13) Type : nombre Par défaut : aucun Contraintes: Aucune | Oui |
| x-amz-archive-description | Description facultative de l'archive que vous chargez. Il peut s'agir d'une description rédigée dans un style simple ou d'un identifiant que vous choisissez d'attribuer. La description ne doit pas nécessairement être unique d'une archive à l'autre. Lorsque vous procédez à l'extraction d'un inventaire de coffre (consultez la section [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)), l'inventaire inclut cette description pour chacune des archives renvoyées dans la réponse. Type : String Par défaut : aucun Contraintes : la description doit être inférieure ou égale à 1 024 caractères. Les caractères autorisés sont les caractères ASCII 7 bits sans code de contrôle, plus précisément les valeurs ASCII décimales 32-126 ou hexadécimales 0x20-0x7E. | Non |
| x-amz-content-sha256 | La SHA256 somme de contrôle (un hachage linéaire) de la charge utile. Il ne s'agit pas de la valeur que vous spécifiez dans l'en-tête `x-amz-sha256-tree-hash`. Type : String Par défaut : aucun Contraintes: Aucune | Oui |
| x-amz-sha256-tree-hash | Somme de contrôle calculée par l'utilisateur, hachage de SHA256 l'arbre, de la charge utile. Pour plus d'informations sur le calcul du hachage de l' SHA256 arbre, consultez[Calcul des totaux de contrôle](checksum-calculations.md). Si Amazon Glacier calcule une somme de contrôle différente de la charge utile, il rejettera la demande. Type : String Par défaut : aucun Contraintes: Aucune | Oui |
### Corps de la requête
Le corps de la demande contient les données à charger.
## Réponses
En réponse, Amazon Glacier stocke l'archive de manière durable et renvoie un chemin URI vers l'ID de l'archive.
### Syntaxe
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
5. Location: Location
6. x-amz-archive-id: ArchiveId
```
### En-têtes de réponse
Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. 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).
| Nom | Description |
| --- | --- |
| Location | Chemin d'accès par URI relatif de la ressource d'archive nouvellement ajoutée. Type : String |
| x-amz-archive-id | ID de l'archive. Cette valeur fait également partie de l'en-tête `Location`. Type : String |
| x-amz-sha256-tree-hash | Somme de contrôle de l'archive calculée par Amazon Glacier. Type : String |
### Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
### 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
### Exemple de requête
L'exemple suivant illustre une demande de chargement d'une archive.
```
1. POST /-/vaults/examplevault/archives HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
5. x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3
6. Content-Length: 2097152
7. x-amz-glacier-version: 2012-06-01
8. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
9.
10.
```
### Exemple de réponse
La réponse positive ci-dessous comporte un `Location` en-tête dans lequel vous pouvez obtenir l'identifiant attribué par Amazon Glacier à l'archive.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
5. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
6. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```
## Sections connexes
+ [Utilisation des archives dans Amazon Glacier](working-with-archives.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Suppression d'une archive (DELETE archive)](api-archive-delete.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Opérations de chargement partitionné
Les opérations de téléchargement partitionné disponibles dans Amazon Glacier sont les suivantes.
**Topics**
+ [
# Annulation de chargement partitionné (DELETE uploadID)
](api-multipart-abort-upload.md)
+ [
# Achèvement du chargement partitionné (POST uploadID)
](api-multipart-complete-upload.md)
+ [
# Lancement de chargement partitionné (POST multipart-uploads)
](api-multipart-initiate-upload.md)
+ [
# Répertorier les parties (GET uploadID)
](api-multipart-list-parts.md)
+ [
# Afficher la liste des chargements partitionnés (GET multipart-uploads)
](api-multipart-list-uploads.md)
+ [
# Partie chargement (PUT uploadID)
](api-upload-part.md)
# Annulation de chargement partitionné (DELETE uploadID)
## Description
Cette commande arrête le chargement partitionné identifié par l'ID de chargement.
Une fois que la demande d'annulation de chargement partitionné a abouti, vous ne pouvez pas utiliser l'ID de chargement pour charger d'autres parties ou effectuer d'autres opérations. L'arrêt d'un chargement partitionné terminé échoue. En revanche, l'arrêt d'un chargement qui a déjà été arrêté aboutit pour un temps limité.
Cette opération est idempotente.
Pour plus d'informations sur le chargement partitionné, consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).
## Requêtes
Pour arrêter un chargement partitionné, envoyez une demande HTTP `DELETE` à l'URI de la sous-ressource `multipart-uploads` du coffre et identifiez l'ID de chargement partitionné spécifique dans l'URI.
### Syntaxe
```
1. DELETE /AccountId/vaults/VaultName/multipart-uploads/uploadID 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
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 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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).
## Exemple
### Exemple de requête
Dans l'exemple suivant, une demande `DELETE` est envoyée à l'URI d'une ressource d'ID de chargement partitionné.
```
1. DELETE /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE 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
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Achèvement du chargement partitionné (POST uploadID)
## Description
Vous appelez cette opération de téléchargement en plusieurs parties pour informer Amazon Glacier (Amazon Glacier) que toutes les parties de l'archive ont été chargées et qu'Amazon Glacier peut désormais assembler l'archive à partir des parties chargées.
Pour plus d'informations sur le chargement partitionné, consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).
Après avoir assemblé et enregistré l'archive dans le coffre, Amazon Glacier renvoie l'ID d'archive de la ressource d'archive nouvellement créée. Une fois que vous avez chargé une archive, vous devez enregistrer l'ID de l'archive renvoyé pour extraire l'archive ultérieurement.
Dans la demande, vous devez inclure le hachage SHA256 arborescent calculé de l'ensemble de l'archive que vous avez chargée. Pour plus d'informations sur le calcul d'un hachage SHA256 arborescent, consultez[Calcul des totaux de contrôle](checksum-calculations.md). Côté serveur, Amazon Glacier construit également le hachage SHA256 arborescent de l'archive assemblée. Si les valeurs correspondent, Amazon Glacier enregistre l'archive dans le coffre ; dans le cas contraire, une erreur est renvoyée et l'opération échoue. L'opération [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md) renvoie la liste des parties chargées pour un chargement partitionné spécifique. Cette liste comporte les informations de total de contrôle pour chaque partie chargée, lesquelles peuvent être utilisées pour déboguer un problème de total de contrôle incorrect.
En outre, Amazon Glacier vérifie également la présence de plages de contenu manquantes. Lors du chargement des parties, vous spécifiez les valeurs de plage qui identifient l'emplacement auquel se trouve chaque partie dans l'assemblage final de l'archive. Lors de l'assemblage de l'archive finale, Amazon Glacier vérifie la présence de plages de contenu manquantes. Si des plages de contenu sont manquantes, Amazon Glacier renvoie un message d'erreur et l'opération de téléchargement partitionné complet échoue.
L'opération d'achèvement du chargement partitionné est idempotente. Une fois que vous avez effectué correctement le chargement partitionné, si vous appelez à nouveau l'opération dans un court délai, celle-ci aboutit et renvoie le même ID d'archive. Cela est très utile si vous rencontrez un problème réseau ou si vous recevez une erreur serveur 500, auquel cas vous pouvez répéter votre demande d'achèvement du chargement partitionné et obtenir le même ID d'archive sans créer d'archives en double. Notez toutefois qu'une fois le chargement partitionné terminé, vous ne pouvez pas appeler l'opération d'affichage de la liste des parties et que le chargement partitionné n'apparaîtra pas dans la réponse d'affichage de la liste des chargements partitionnés même si une opération idempotente est possible.
## Requêtes
Pour terminer un téléchargement partitionné, vous envoyez une requête HTTP POST à l'URI de l'ID de téléchargement créé par Amazon Glacier en réponse à votre demande d'initiation de téléchargement partitionné. Il s'agit de l'URI que vous avez utilisé lors du chargement des parties. Outre les en-têtes obligatoires courants, vous devez inclure le résultat du hachage SHA256 arborescent de l'ensemble de l'archive et la taille totale de l'archive en octets.
### Syntaxe
```
1. POST /AccountId/vaults/VaultName/multipart-uploads/uploadID
2. Host: glacier.Region.amazonaws.com
3. Date: date
4. Authorization: SignatureValue
5. x-amz-sha256-tree-hash: SHA256 tree hash of the archive
6. x-amz-archive-size: ArchiveSize in bytes
7. 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 |
| --- | --- | --- |
| x-amz-archive-size | Taille totale, en octets, de la totalité de l'archive. Cette valeur doit être la somme de toutes les tailles des différentes parties que vous avez chargées. Type : String Par défaut : aucun Contraintes: Aucune | Oui |
| x-amz-sha256-tree-hash | Le hachage SHA256 arborescent de l'ensemble de l'archive. Il s'agit du hachage SHA256 arborescent des différentes parties. Si la valeur que vous spécifiez dans la demande ne correspond pas au hachage SHA256 arborescent de l'archive assemblée finale tel que calculé par Amazon Glacier, Amazon Glacier renvoie une erreur et la demande échoue. Type : String Par défaut : aucun Contraintes: Aucune | Oui |
### Elements de la demande
Cette opération n'utilise pas les éléments de la demande.
## Réponses
Amazon Glacier (Amazon Glacier) crée un hachage SHA256 arborescent de l'intégralité de l'archive. Si la valeur correspond au hachage SHA256 arborescent de l'intégralité de l'archive que vous avez spécifiée dans la demande, Amazon Glacier ajoute l'archive au coffre-fort. En réponse, il renvoie l'en-tête HTTP `Location` avec le chemin d'accès de l'URL de la ressource d'archivage nouvellement ajoutée. Si la taille de l'archive ou SHA256 celle que vous avez envoyée dans la demande ne correspond pas, Amazon Glacier renvoie un message d'erreur et le chargement reste incomplet. Il est possible de renouveler ultérieurement l'opération d'achèvement du chargement partitionné avec les valeurs correctes pour créer correctement une archive. Si un chargement en plusieurs parties n'aboutit pas, Amazon Glacier finira par récupérer l'ID de téléchargement.
### Syntaxe
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-archive-id: ArchiveId
```
### En-têtes de réponse
Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. 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).
| Nom | Description |
| --- | --- |
| Location | Chemin d'accès URI relatif de l'archive nouvellement créée. Cette URL inclut l'ID d'archive généré par Amazon Glacier. Type : String |
| x-amz-archive-id | ID de l'archive. Cette valeur fait également partie de l'en-tête `Location`. Type : String |
### Champs de réponse
Cette opération ne renvoie pas de corps de réponse.
## Exemple
### Exemple de requête
Dans cet exemple, une demande HTTP POST est envoyée à l'URI qui a été renvoyé par une demande de lancement du chargement partitionné. La demande indique à la fois le hachage SHA256 arborescent de l'archive entière et la taille totale de l'archive.
```
1. POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. z-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0
5. x-amz-archive-size:8388608
6. x-amz-glacier-version: 2012-06-01
7. 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
L'exemple de réponse suivant montre qu'Amazon Glacier a créé avec succès une archive à partir des éléments que vous avez chargés. La réponse inclut l'ID de l'archive avec le chemin d'accès complet.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
5. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```
Vous pouvez maintenant envoyer des demandes HTTP à l'URI de la ressource/archive nouvellement ajoutée. Par exemple, vous pouvez envoyer une demande GET pour extraire l'archive.
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Suppression d'une archive (DELETE archive)](api-archive-delete.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Lancement de chargement partitionné (POST multipart-uploads)
## Description
Cette opération lance un chargement partitionné (consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)). Amazon Glacier (Amazon Glacier) crée une ressource de téléchargement en plusieurs parties et renvoie son identifiant dans la réponse. Vous utilisez cet ID de chargement dans les opérations de chargement partitionné suivantes.
Lorsque vous lancez un chargement partitionné, vous spécifiez la taille de la partie en indiquant le nombre d'octets correspondant. La taille de la partie doit être exprimée en mébioctet (Mio) (1 024 kibioctets [Kio]) multiplié par une puissance de 2 (par exemple, 1 048 576 (1 Mio), 2 097 152 (2 Mio), 4 194 304 (4 Mio), 8 388 608 (8 Mio), et ainsi de suite). La taille minimale autorisée pour les parties est de 1 Mio et la taille maximale est de 4 gibioctets (Gio).
Chacune des parties que vous chargez à l'aide de cet ID de chargement, à l'exception de la dernière, doit être de taille identique. La dernière partie peut être de taille identique ou plus petite. Par exemple, supposez que vous souhaitez charger un fichier de 16,2 Mio. Si vous lancez le chargement partitionné avec une taille de partie de 4 Mio, vous allez charger quatre parties de 4 Mio chacune et une partie de 0,2 Mio.
**Note**
Vous n'avez pas besoin de connaître la taille de l'archive lorsque vous lancez un téléchargement partitionné, car Amazon Glacier ne vous oblige pas à spécifier la taille globale de l'archive.
Une fois le téléchargement partitionné terminé, Amazon Glacier supprime la ressource de téléchargement partitionné référencée par l'ID. Amazon Glacier supprimera également la ressource de téléchargement partitionné si vous annulez le téléchargement partitionné ou elle peut être supprimée s'il n'y a aucune activité pendant une période de 24 heures. Il se peut que l'ID soit toujours disponible après 24 heures, mais ce n'est pas le comportement auquel les applications doivent s'attendre.
## Requêtes
Pour lancer un chargement partitionné, vous envoyez une demande HTTP `POST` à l'URI de la sous-ressource `multipart-uploads` du coffre dans lequel vous souhaitez enregistrer l'archive. La demande doit inclure la taille de la partie et peut éventuellement comporter une description de l'archive.
### Syntaxe
```
1. POST /AccountId/vaults/VaultName/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6. x-amz-archive-description: ArchiveDescription
7. x-amz-part-size: PartSize
```
**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 |
| --- | --- | --- |
| x-amz-part-size | Taille de chaque partie, à l'exception de la dernière, exprimée en octets. La taille de la dernière partie peut être inférieure à celle de cette partie. Type : Chaîne Par défaut : aucun Contraintes : la taille de la partie doit être exprimée en mébioctet (1 024 Kio) multiplié par une puissance de 2 (par exemple, 1 048 576 (1 Mio), 2 097 152 (2 Mio), 4 194 304 (4 Mio), 8 388 608 (8 Mio), et ainsi de suite). La taille minimale autorisée pour les parties est de 1 Mio et la taille maximale est de 4 Gio (4 096 Mio). | Oui |
| x-amz-archive-description | Description de l'archive que vous chargez en plusieurs parties. Il peut s'agir d'une description rédigée dans un style simple ou d'un identifiant unique que vous choisissez d'attribuer. Lorsque vous procédez à l'extraction d'un inventaire de coffre (consultez la section [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)), l'inventaire inclut cette description pour chacune des archives renvoyées dans la réponse. Les espaces de début présents dans les descriptions d'archive sont retirés. Type : Chaîne Par défaut : aucun Contraintes : la description doit être inférieure ou égale à 1 024 octets. Les caractères autorisés sont des caractères ASCII 7 bits sans code de contrôle, plus spécifiquement les valeurs ASCII décimales 32 à 126 ou hexadécimales 0x20 à 0x7E. | Non |
### Corps de la requête
Cette opération n'a pas de corps de demande.
## Réponses
Dans la réponse, Amazon Glacier crée une ressource de téléchargement partitionné identifiée par un ID et renvoie le chemin URI relatif de l'ID de téléchargement partitionné.
### Syntaxe
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Location: Location
5. x-amz-multipart-upload-id: multiPartUploadId
```
### En-têtes de réponse
Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. 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).
| Nom | Description |
| --- | --- |
| Location | Le chemin d'URI relatif de l'ID de téléchargement en plusieurs parties créé par Amazon Glacier. Vous utilisez ce chemin d'accès par URI pour définir la portée de vos demandes de chargement de parties et pour terminer le chargement partitionné. Type : Chaîne |
| x-amz-multipart-upload-id | ID du chargement partitionné. Cette valeur fait également partie de l'en-tête `Location`. Type : Chaîne |
### Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
### 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).
## Exemple
### Exemple de requête
L'exemple suivant lance un chargement partitionné en envoyant une demande HTTP `POST` à l'URI de la sous-ressource `multipart-uploads` d'un coffre nommé `examplevault`. La demande comprend des en-têtes pour spécifier une taille de partie de 4 Mio (4 194 304 octets) une description facultative de l'archive.
```
1. POST /-/vaults/examplevault/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-archive-description: MyArchive-101
5. x-amz-part-size: 4194304
6. x-amz-glacier-version: 2012-06-01
7. 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
Amazon Glacier crée une ressource de téléchargement en plusieurs parties et l'ajoute à la `multipart-uploads` sous-ressource du coffre-fort. L'en-tête de réponse `Location` inclut le chemin d'accès par URI relatif à l'ID de chargement partitionné.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
5. x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
```
Pour plus d'informations sur le chargement de plusieurs parties, consultez la section [Partie chargement (PUT uploadID)](api-upload-part.md).
## Sections connexes
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Suppression d'une archive (DELETE archive)](api-archive-delete.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Répertorier les parties (GET uploadID)
## Description
Cette opération de chargement partitionné répertorie les parties d'une archive qui ont été chargées dans le cadre d'un chargement partitionné spécifique identifié par un ID de chargement. Pour plus d'informations sur le chargement partitionné, consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).
Vous pouvez faire cette demande à tout moment au cours d'un chargement partitionné en cours avant d'avoir terminé le chargement partitionné. Amazon Glacier retourne la liste des parties triée en fonction de la plage que vous avez spécifiée dans chaque chargement de partie. Si vous envoyez une demande List Parts après avoir effectué le téléchargement en plusieurs parties, Amazon Glacier (Amazon Glacier) renvoie un message d'erreur.
L'opération de création d'une liste des parties prend en charge la pagination. Vous devez toujours vérifier le champ `Marker` dans le corps de la réponse pour repérer un marqueur à partir duquel poursuivre l'affichage de la liste. S'il n'y a aucun autre élément, le champ `marker` est `null`. Si `marker` ce n'est pas nul, pour récupérer le prochain ensemble de pièces, vous avez envoyé une autre demande List Parts avec le paramètre de `marker` demande défini sur la valeur de marqueur renvoyée par Amazon Glacier en réponse à votre précédente demande List Parts.
Vous pouvez également limiter le nombre de parties renvoyées dans la réponse en spécifiant le paramètre `limit` dans la demande.
## Requêtes
### Syntaxe
Pour afficher les parties d'un chargement partitionné en cours, vous envoyez une demande `GET` à l'URI de la ressource de l'ID de chargement partitionné. L'ID de chargement partitionné est retourné lorsque vous lancez un chargement partitionné ([Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)). Vous pouvez éventuellement spécifier les paramètres `marker` et `limit`.
```
1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID 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 |
| --- | --- | --- |
| limit | Le nombre maximum de parties à renvoyer. La limite par défaut est de 50. Il peut arriver que le nombre de parties 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. `marker` spécifie la partie à partir de laquelle la liste des parties doit commencer. Obtenez la valeur `marker` dans une réponse précédente concernant l'établissement d'une liste des parties. Vous devez simplement inclure la valeur du paramètre `marker` si vous poursuivez la pagination de résultats commencée dans une demande précédente d'affichage de la liste des parties. Type : Chaîne Contraintes: Aucune | 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
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Content-Type: application/json
5. Content-Length: Length
6.
7. {
8. "ArchiveDescription" : String,
9. "CreationDate" : String,
10. "Marker": String,
11. "MultipartUploadId" : String,
12. "PartSizeInBytes" : Number,
13. "Parts" :
14. [ {
15. "RangeInBytes" : String,
16. "SHA256TreeHash" : String
17. },
18. ...
19. ],
20. "VaultARN" : String
21. }
```
### 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.
**ArchiveDescription**
La description de l'archive qui a été spécifiée dans la demande de lancement des chargements partitionnés. Ce champ est `null` si aucune description d'archive n'a été spécifiée dans l'opération de lancement des chargements partitionnés.
*Type* : chaîne
**CreationDate**
L'heure UTC à laquelle le chargement partitionné a été lancé.
*Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**Marker**
Chaîne opaque représentant l'endroit à partir duquel poursuivre la pagination des résultats. Vous utilisez le `marker` dans une nouvelle demande d'affichage des parties afin d'obtenir davantage de tâches dans la liste. S'il n'y a pas d'autres parties, cette valeur est `null`.
*Type* : chaîne
**MultipartUploadId**
L'ID du chargement auquel les parties sont associées.
*Type* : chaîne
**PartSizeInBytes**
La taille de la partie en octets. Il s'agit de la même valeur que celle qui a été spécifiée dans la demande de lancement d'une demande de chargement partitionné.
*Type* : nombre
**Parties**
Une liste des tailles des parties pour le chargement partitionné. Chaque objet du tableau contient une paire nom/valeur `RangeBytes` et `sha256-tree-hash`.
*Type* : tableau
**RangeInBytes**
La plage d'octets d'une partie, y compris la valeur supérieure de la plage.
*Type* : chaîne
**SHA256TreeHash**
Valeur de hachage de l' SHA256 arbre calculée par Amazon Glacier pour la pièce. Ce champ n'est jamais `null`.
*Type* : chaîne
**VaultARN**
L'Amazon Resource Name (ARN) du coffre pour lequel le chargement partitionné a été lancé.
*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
### Exemple : Liste différentes parties d'un chargement partitionné
L'exemple suivant répertorie toutes les parties d'un chargement. L'exemple envoie une demande `GET` HTTP à l'URI de l'ID de chargement partitionné d'un chargement partitionné en cours et retourne jusqu'à 1 000 parties.
#### Exemple de requête
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE 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
Dans la réponse, Amazon Glacier renvoie une liste des pièces téléchargées associées à l'ID de téléchargement en plusieurs parties spécifié. Cet exemple contient deux parties seulement. Le champ `Marker` retourné est `null`, ce qui indique qu'il n'y a plus aucune partie pour le chargement partitionné.
```
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: 412
6.
7. {
8. "ArchiveDescription" : "archive description",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": null,
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "0-4194303",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. },
18. {
19. "RangeInBytes" : "4194304-8388607",
20. "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
21. }],
22. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
23. }
```
### Exemple : Répertorier les parties d'un chargement partitionné (indiquer le marqueur et les paramètres de limite de la demande)
L'exemple suivant illustre l'utilisation de la pagination pour obtenir un nombre limité de résultats. L'exemple envoie une demande `GET` HTTP à l'URI de l'ID de chargement partitionné d'un chargement partitionné en cours pour retourner une partie. Un paramètres `marker` de départ spécifie à partir de quelle partie la liste doit commencer. Vous pouvez obtenir la valeur `marker` dans la réponse d'une demande précédente de liste de parties. En outre, dans cet exemple, le paramètre `limit`est défini sur 1 et retourne une partie. Notez que le champ `Marker` n'est pas `null`, ce qui indique qu'il reste encore au moins une partie à obtenir.
#### Exemple de requête
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 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
Dans la réponse, Amazon Glacier renvoie une liste des pièces chargées associées à l'ID de téléchargement partitionné en cours spécifié.
```
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: text/json
5. Content-Length: 412
6.
7. {
8. "ArchiveDescription" : "archive description 1",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "4194304-8388607",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. }],
18. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
19. }
```
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Afficher la liste des chargements partitionnés (GET multipart-uploads)
## Description
Cette opération de chargement partitionné affiche la liste des chargements partitionnés en cours pour le coffre spécifié. Un chargement partitionné en cours est un chargement partitionné qui a été lancé par une demande [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md), mais qui n'a pas encore été terminé ou arrêté. La liste renvoyée dans la réponse de chargement partitionné n'a aucun ordre garanti.
L'opération d'affichage de la liste des chargements partitionnés prend en charge la pagination. Par défaut, cette opération renvoie jusqu'à 50 chargements partitionnés dans la réponse. Vous devez toujours vérifier le champ `marker` dans le corps de la réponse pour repérer un marqueur à partir duquel poursuivre l'affichage de la liste. S'il n'y a aucun autre élément, le champ `marker` est `null`.
Si ce n'`marker`est pas nul, pour récupérer le prochain ensemble de téléchargements partitionnés, vous avez envoyé une autre demande List Multipart Uploads avec le paramètre de requête défini sur la valeur de marqueur qu'Amazon Glacier (Amazon Glacier) a renvoyée en réponse à votre précédente `marker` demande List Multipart Uploads.
Notez la différence entre cette opération et l'opération [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)). L'opération d'affichage des chargements partitionnés affiche la liste de tous les chargements partitionnés pour un coffre. L'opération d'affichage de la liste des parties renvoie les parties d'un chargement partitionné spécifique identifié par un ID de chargement.
Pour plus d'informations sur le chargement partitionné, consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).
## Requêtes
### Syntaxe
Pour afficher la liste des chargements partitionnés, envoyez une demande `GET` à l'URI de la sous-ressource `multipart-uploads` du coffre. Vous pouvez éventuellement spécifier les paramètres `marker` et `limit`.
```
1. GET /AccountId/vaults/VaultName/multipart-uploads 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 |
| --- | --- | --- |
| limit | Spécifie le nombre maximal de chargements renvoyés dans le corps de la réponse. Si ce paramètre n'est pas spécifié, l'opération d'affichage de la liste des chargements renvoie jusqu'à 50 chargements. 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. `marker` spécifie le chargement auquel doit commencer la liste des chargements. Obtenez la valeur du paramètre `marker` à partir d'une réponse précédente d'affichage de la liste des chargements. Il suffit d'inclure la valeur du paramètre `marker` si vous poursuivez la pagination de résultats commencée dans une demande précédente d'affichage de la liste des chargements. Type : Chaîne Contraintes: Aucune | 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
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Content-Type: application/json
5. Content-Length: Length
6.
7. {
8. "Marker": String,
9. "UploadsList" : [
10. {
11. "ArchiveDescription": String,
12. "CreationDate": String,
13. "MultipartUploadId": String,
14. "PartSizeInBytes": Number,
15. "VaultARN": String
16. },
17. ...
18. ]
19. }
```
### 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.
**ArchiveDescription**
La description de l'archive qui a été spécifiée dans la demande de lancement des chargements partitionnés. Ce champ est `null` si aucune description d'archive n'a été spécifiée dans l'opération de lancement des chargements partitionnés.
*Type* : chaîne
**CreationDate**
L'heure UTC à laquelle le chargement partitionné a été lancé.
*Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**Marker**
Chaîne opaque représentant l'endroit à partir duquel poursuivre la pagination des résultats. Vous utilisez le paramètre `marker` dans une nouvelle demande d'affichage de la liste des chargements partitionnés en vue d'obtenir davantage de chargements dans la liste. S'il n'y a pas d'autres chargements, cette valeur est `null`.
*Type* : chaîne
**PartSizeInBytes**
Taille de la partie spécifiée dans la demande [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md). Il s'agit de la taille de toutes les parties comprises dans le téléchargement excepté la dernière partie, dont la taille peut être inférieure à cette taille.
*Type* : nombre
**MultipartUploadId**
ID du chargement partitionné.
*Type* : chaîne
**UploadsList**
Liste des métadonnées relatives aux objets des chargements partitionnés. Chaque élément de la liste contient un ensemble de paires nom-valeur pour le chargement correspondant, notamment `ArchiveDescription`, `CreationDate`, `MultipartUploadId`, `PartSizeInBytes` et `VaultARN`.
*Type* : tableau
**VaultARN**
Amazon Resource Name (ARN) du coffre qui contient l'archive.
*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
### Exemple : Affichage de la liste de tous les chargements partitionnés
L'exemple suivant affiche la liste de tous les chargements partitionnés en cours pour le coffre. L'exemple illustre une demande HTTP `GET` envoyée à l'URI de la sous-ressource `multipart-uploads` d'un coffre spécifié. Etant donné que les paramètres `marker` et `limit` ne sont pas spécifiés dans la demande, jusqu'à 1 000 chargements partitionnés en cours sont renvoyés.
#### Exemple de requête
```
1. GET /-/vaults/examplevault/multipart-uploads 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
Dans la réponse, Amazon Glacier renvoie une liste de tous les téléchargements partitionnés en cours pour le coffre spécifié. Le champ `marker` est `null`, ce qui indique qu'il n'y a pas plus de chargements à afficher dans la liste.
```
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: 1054
6.
7. {
8. "Marker": null,
9. "UploadsList": [
10. {
11. "ArchiveDescription": "archive 1",
12. "CreationDate": "2012-03-19T23:20:59.130Z",
13. "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. },
17. {
18. "ArchiveDescription": "archive 2",
19. "CreationDate": "2012-04-01T15:00:00.000Z",
20. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
21. "PartSizeInBytes": 4194304,
22. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
23. },
24. {
25. "ArchiveDescription": "archive 3",
26. "CreationDate": "2012-03-20T17:03:43.221Z",
27. "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
28. "PartSizeInBytes": 4194304,
29. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
30. }
31. ]
32. }
```
### Exemple : Liste partielle des chargements partitionnés
L'exemple suivant illustre l'utilisation de la pagination pour obtenir un nombre limité de résultats. L'exemple illustre une demande HTTP `GET` envoyée à l'URI de la sous-ressource `multipart-uploads` pour un coffre spécifié. Dans cet exemple, le paramètre `limit` est défini sur 1, ce qui signifie qu'un seul chargement est renvoyé dans la liste, et le paramètre `marker` indique l'ID de chargement partitionné auquel commence la liste renvoyée.
#### Exemple de requête
```
1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev 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
Dans la réponse, Amazon Glacier (Amazon Glacier) renvoie une liste ne contenant pas plus de deux téléchargements partitionnés en cours pour le coffre spécifié, en commençant par le marqueur spécifié et en renvoyant deux résultats.
```
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: 470
6.
7. {
8. "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
9. "UploadsList" : [
10. {
11. "ArchiveDescription": "archive 2",
12. "CreationDate": "2012-04-01T15:00:00.000Z",
13. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. }
17. ]
18. }
```
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Partie chargement (PUT uploadID)
## Description
Cette opération de chargement partitionné permet de charger une partie d'une archive. Vous pouvez charger des parties de l'archive dans n'importe quel ordre car vous spécifiez la plage d'octets de l'archive assemblée qui sera chargée dans cette partie dans votre demande de chargement partiel. Vous pouvez également charger ces différentes parties en parallèle. Vous pouvez charger jusqu'à 10 000 parties pour un chargement partitionné.
Pour plus d'informations sur le chargement partitionné, consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).
Amazon Glacier (Amazon Glacier) rejette votre demande de partie chargée si l'une des conditions suivantes est remplie :
+ **SHA256 le hachage de l'arbre ne correspond pas :** pour vous assurer que les données de la pièce ne sont pas corrompues lors de la transmission, vous calculez un hachage SHA256 arborescent de la pièce et vous l'incluez dans votre demande. Dès réception des données de pièce, Amazon Glacier calcule également un hachage SHA256 arborescent. Si les deux valeurs de hachage ne correspondent pas, l'opération échoue. Pour plus d'informations sur le calcul d'un hachage SHA256 arborescent, consultez[Calcul des totaux de contrôle](checksum-calculations.md).
+ **SHA256 le hachage linéaire ne correspond pas :** pour obtenir l'autorisation, vous calculez un hachage SHA256 linéaire de l'ensemble de la charge utile téléchargée et vous l'incluez dans votre demande. Pour plus d'informations sur le calcul d'un hachage SHA256 linéaire, consultez[Calcul des totaux de contrôle](checksum-calculations.md).
+ **La taille de la partie ne correspond pas – **La taille de chaque partie, à l'exception de la dernière, doit correspondre à la taille spécifiée dans la demande [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md) correspondante. La taille de la dernière partie doit être identique, ou inférieure, à la taille spécifiée.
**Note**
Si vous chargez une partie dont la taille est inférieure à la taille de la partie spécifiée dans votre première demande de chargement partitionné et si cette partie n'est pas la dernière, la demande de chargement de la partie est réussie. Toutefois, la demande suivante de chargement partitionné complet échouera.
+ **La plage ne correspond pas – **La valeur de la plage d'octets de la demande ne correspond pas à la taille de la partie spécifiée dans la demande de lancement correspondante. Par exemple, si vous spécifiez une taille de partie de 4 194 304 octets (4 Mo), les plages de parties comprises entre 0 et 4 194 303 octets (4 Mo - 1) et entre 4 194 304 (4 Mo) et 8 388 607 (8 Mo - 1) sont valides. Toutefois, si vous définissez une valeur de plage de 2 Mo à 6 Mo, la plage ne correspond pas à la taille de la partie et le chargement échouera.
Cette opération est idempotente. Si vous téléchargez la même partie plusieurs fois, les données figurant dans la demande plus récente remplace les données chargées précédemment.
## Requêtes
Vous envoyez cette demande `PUT` HTTP à l'URI de l'ID de chargement qui a été renvoyé par votre demande de lancement de chargement partitionné. Amazon Glacier utilise l'ID de téléchargement pour associer les chargements partiels à un chargement partitionné spécifique. La demande doit inclure un hachage SHA256 arborescent des données de pièce (`x-amz-SHA256-tree-hash`en-tête), un hachage SHA256 linéaire de l'ensemble de la charge utile (`x-amz-content-sha256`en-tête), la plage d'octets (`Content-Range`en-tête) et la longueur de la partie en octets (`Content-Length`en-tête).
### Syntaxe
```
1. PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Range: ContentRange
6. Content-Length: PayloadSize
7. Content-Type: application/octet-stream
8. x-amz-sha256-tree-hash: Checksum of the part
9. x-amz-content-sha256: Checksum of the entire payload
10. 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 |
| --- | --- | --- |
| Content-Length | Identifie la longueur de la partie en octets. Type : String Par défaut : aucun Contraintes: Aucune | Non |
| Content-Range | Identifie la plage d'octets de l'archive assemblée qui sera chargée dans cette partie. Amazon Glacier utilise ces informations pour assembler l'archive dans le bon ordre. Le format de cet en-tête suit [RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Voici un exemple d'en-tête : `Content-Range:bytes 0-4194303/*`. Type : String Par défaut : aucun Contraintes : la plage ne peut pas être supérieure à la taille de la partie que vous avez spécifiée lorsque vous avez lancé le chargement partitionné. | Oui |
| x-amz-content-sha256 | La SHA256 somme de contrôle (un hachage linéaire) de la charge utile téléchargée. Il ne s'agit pas de la valeur que vous spécifiez dans l'en-tête `x-amz-sha256-tree-hash`. Type : String Par défaut : aucun Contraintes: Aucune | Oui |
| x-amz-sha256-tree-hash | Spécifie un hachage SHA256 arborescent des données en cours de téléchargement. Pour plus d'informations sur le calcul d'un hachage SHA256 arborescent, consultez[Calcul des totaux de contrôle](checksum-calculations.md). Type : String Par défaut : aucun Contraintes: Aucune | Oui |
### Corps de la requête
Le corps de la demande contient les données à charger.
## Réponses
Une fois le chargement partiel réussi, Amazon Glacier renvoie une `204 No Content` réponse.
### Syntaxe
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
```
### En-têtes de réponse
Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. 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).
| Nom | Description |
| --- | --- |
| x-amz-sha256-tree-hash | Le hachage de l' SHA256 arbre calculé par Amazon Glacier pour la partie chargée. Type : String |
### Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
## Exemple
La demande suivante charge une partie de 4 Mo. La demande définit la plage d'octets afin que ce soit la première partie de l'archive.
### Exemple de requête
L'exemple envoie une demande `PUT` HTTP pour charger une partie de 4 Mo. La demande est envoyée à l'URI de l'ID de chargement qui a été retournée par la demande de lancement du chargement partitionné. L'en-tête `Content-Range` identifie la partie en tant que première partie de 4 Mo de l'archive.
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 0-4194303/*
5. x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953
6. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
7. Content-Length: 4194304
8. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```
Pour télécharger la pièce suivante, la procédure est la même ; toutefois, vous devez calculer un nouveau hachage SHA256 arborescent de la pièce que vous chargez et également spécifier une nouvelle plage d'octets pour indiquer où la pièce sera placée dans l'assemblage final. La demande suivante charge une autre partie en utilisant le même ID de chargement. La demande spécifie les 4 Mo suivants de l'archive après la demande précédente et une taille de partie de 4 Mo.
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 4194304-8388607/*
5. Content-Length: 4194304
6. x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493
7. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
8. x-amz-glacier-version: 2012-06-01
9. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```
Les pièces peuvent être chargées dans n'importe quelle commande ; Amazon Glacier utilise les spécifications de plage de chaque pièce pour déterminer l'ordre dans lequel les assembler.
### Exemple de réponse
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953
4. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](#api-upload-part)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# 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)
# Types de données utilisés dans les opérations de tâche
Les types de données suivants sont utilisés pour les opérations de travail dans Amazon Glacier.
**Topics**
+ [
# CSVInput
](api-CSVInput.md)
+ [
# CSVOutput
](api-CSVOutput.md)
+ [
# Chiffrement
](api-Encryption.md)
+ [
# GlacierJobDescription
](api-GlacierJobDescription.md)
+ [
# Octroi
](api-Grant.md)
+ [
# Bénéficiaire
](api-Grantee.md)
+ [
# InputSerialization
](api-InputSerialization.md)
+ [
# InventoryRetrievalJobInput
](api-InventoryRetrievalJobInput.md)
+ [
# jobParameters
](api-jobParameters.md)
+ [
# OutputLocation
](api-OutputLocation.md)
+ [
# OutputSerialization
](api-OutputSerialization.md)
+ [
# Emplacement S3
](api-S3Location.md)
+ [
# SelectParameters
](api-SelectParameters.md)
# CSVInput
Contient des informations sur le fichier CSV (valeurs séparées par des virgules).
## Table des matières
**Commentaires**
Caractère nique utilisé pour indiquer qu'une ligne doit être ignorée lorsque le caractère est présent au début de cette ligne.
*Type :* chaîne
*Obligatoire* : non
**FieldDelimiter**
Caractère unique utilisé pour séparer des champs individuels les uns des autres au sein d'un enregistrement. Le caractère doit être un `\n`, un `\r`, ou un caractère ASCII compris dans la plage 32-126. La valeur par défaut est une virgule (`,`).
*Type :* chaîne
*Par défaut* : ,
*Obligatoire* : non
**FileHeaderInfo**
Valeur décrivant quoi faire avec la première ligne de l'entrée.
*Type :* chaîne
*Valeurs Valides* : `Use` \$1 `Ignore` \$1 `None`
*Obligatoire* : non
**QuoteCharacter**
Caractère unique utilisé comme caractère d'échappement lorsque le délimiteur de champ fait partie d'une valeur.
*Type :* chaîne
*Obligatoire* : non
**QuoteEscapeCharacter**
Caractère unique utilisé pour l'échappement du guillemet à l'intérieur d'une valeur déjà échappée.
*Type :* chaîne
*Obligatoire* : non
**RecordDelimiter**
Caractère unique utilisé pour séparer des enregistrements individuels les uns des autres.
*Type :* chaîne
*Obligatoire* : non
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# CSVOutput
Contient des informations sur le format CSV (valeurs séparées par des virgules) dans lequel les résultats des tâches sont stockés.
## Table des matières
**FieldDelimiter**
Caractère unique utilisé pour séparer des champs individuels les uns des autres au sein d'un enregistrement.
*Type :* chaîne
*Obligatoire* : non
**QuoteCharacter**
Caractère unique utilisé comme caractère d'échappement lorsque le délimiteur de champ fait partie d'une valeur.
*Type :* chaîne
*Obligatoire* : non
**QuoteEscapeCharacter**
Caractère unique utilisé pour l'échappement du guillemet à l'intérieur d'une valeur déjà échappée.
*Type :* chaîne
*Obligatoire* : non
**QuoteFields**
Valeur qui indique si tous les champs de sortie doivent être entourés de guillemets.
*Valeurs valides* : `ALWAYS` \$1 `ASNEEDED`
*Type :* chaîne
*Obligatoire* : non
**RecordDelimiter**
Caractère unique utilisé pour séparer des enregistrements individuels les uns des autres.
*Type :* chaîne
*Obligatoire* : non
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# Chiffrement
Contient des informations sur le chiffrement utilisé pour stocker les résultats des tâches dans Amazon S3.
## Table des matières
**Chiffrement**
Algorithme de chiffrement côté serveur utilisé lors du stockage des résultats des tâches dans Amazon S3. La valeur par défaut est sans chiffrement.
*Type :* chaîne
*Valeurs valides* : `aws:kms` \$1 `AES256`
*Obligatoire* : non
**KMSContext**
Facultatif. Si le type de chiffrement est `aws:kms,` vous pouvez utiliser cette valeur pour spécifier le contexte de chiffrement des résultats des tâches.
*Type :* chaîne
*Obligatoire* : non
**KMSKeyId**
L'ID de clé AWS Key Management Service (AWS KMS) à utiliser pour le chiffrement des objets.
*Type :* chaîne
*Obligatoire* : non
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# GlacierJobDescription
Contient la description d'une tâche Amazon Glacier (Amazon Glacier).
## Table des matières
**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 extraction 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é**
`true` si la tâche est terminée, sinon, `false`.
*Type* : valeur booléenne
**CompletionDate**
Date à laquelle la tâche s'est terminée.
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* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**CreationDate**
La date UTC du début de la tâche.
*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**
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 aucune plage n'a été spécifiée lors de la récupération de l'archive, l'archive entière est récupérée et *StartByteValue*vaut 0 et est *EndByteValue*égale à la taille de l'archive moins 1. Pour les tâches d'extraction d'inventaire, 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**
Amazon Resource Name (ARN) représentant une rubrique Amazon SNS à laquelle la notification d'achèvement ou d'échec de la tâche est envoyée, si une notification a été configurée lors du lancement de la tâche ([Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)).
*Type* : chaîne
**StatusCode**
Code indiquant l'état de la tâche.
*Valeurs Valides* : `InProgress` \$1 `Succeeded` \$1 `Failed`
*Type* : chaîne
**StatusMessage**
Message d'é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* : `Expedited` \$1 `Standard` \$1 `Bulk`
*Type* : chaîne
**VaultARN**
ARN du coffre dont la tâche est une sous-ressource.
*Type* : chaîne
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# Octroi
Contient des informations à propos d'une attribution.
## Table des matières
**Bénéficiaire**
Bénéficiaire.
*Type* : objet [Bénéficiaire](api-Grantee.md)
*Obligatoire* : non
**Autorisation**
Autorisation donnée au bénéficiaire.
*Type :* chaîne
*Valeurs Valides*: `FULL_CONTROL` \$1 `WRITE` \$1 `WRITE_ACP` \$1 `READ` \$1 `READ_ACP`
*Obligatoire* : non
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# Bénéficiaire
Contient des informations à propos d'un bénéficiaire.
## Table des matières
**DisplayName**
Nom de l'écran du bénéficiaire.
*Type :* chaîne
*Obligatoire* : non
**EmailAddress**
Adresse e-mail du bénéficiaire.
*Type :* chaîne
*Obligatoire* : non
**ID**
ID d'utilisateur canonique du bénéficiaire.
*Type :* chaîne
*Obligatoire* : non
**Type**
Type du bénéficiaire.
*Type :* chaîne
*Valeurs Valides* : `AmazonCustomerByEmail` \$1 `CanonicalUser` \$1 `Group`
*Obligatoire* : non
**URI**
URI du groupe du bénéficiaire.
*Type :* chaîne
*Obligatoire* : non
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# InputSerialization
Décrit la manière dont l'archive est sérialisée.
## Table des matières
**CSV**
Objet décrivant la sérialisation d'un objet codé CSV.
*Type* : objet [CSVInput](api-CSVInput.md)
*Obligatoire* : non
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# InventoryRetrievalJobInput
Fournit des options de spécification de tâche d'extraction d'un inventaire par plage.
## Table des matières
**EndDate**
Fin de la plage de dates au format UTC pour une extraction d'inventaire de coffre qui inclut les archives créées avant cette date.
*Valeurs valides* : représentation sous forme de chaîne au format de date ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) en secondes, par exemple `2013-03-20T17:03:43Z`.
*Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) en secondes, par exemple `2013-03-20T17:03:43Z`.
*Obligatoire* : non
**Format**
Format de sortie de la liste de l'inventaire du coffre, défini par la demande [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) lors du lancement d'une tâche d'extraction d'un inventaire de coffre.
*Valeurs valides* : `CSV` \$1 `JSON`
*Obligatoire* : non
*Type :* chaîne
**Limite**
Nombre maximal d'éléments d'inventaire pouvant être renvoyés pour chaque demande d'extraction d'inventaire de coffre.
*Valeurs valides* : valeur d'entier supérieure ou égale à 1.
*Type :* chaîne
*Obligatoire* : non
**Marker**
Chaîne opaque représentant l'endroit à partir duquel poursuivre la pagination des résultats d'extraction d'inventaire de coffre. Vous utilisez ce marqueur dans une nouvelle demande `Initiate Job` afin d'obtenir des éléments d'inventaire supplémentaires. S'il n'y a pas d'autres éléments d'inventaire, cette valeur est null.
*Type :* chaîne
*Obligatoire* : non
**StartDate**
Début de la plage de dates au format UTC pour une extraction d'inventaire de coffre qui inclut les archives créées à cette date ou ultérieurement.
*Valeurs valides* : représentation sous forme de chaîne au format de date ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) en secondes, par exemple `2013-03-20T17:03:43Z`.
*Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) en secondes, par exemple `2013-03-20T17:03:43Z`.
*Obligatoire* : non
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# jobParameters
Fournit des options de définition d'une tâche.
## Table des matières
**ArchiveId**
L'ID de l'archive que vous souhaitez. Ce champ est obligatoire uniquement si le champ `Type` est défini sur `select` ou `archive-retrieval`. Une erreur se produit si vous spécifiez ce champ pour une demande de tâche d'extraction d'inventaire.
*Valeurs valides* : il doit s'agir d'un identifiant d'archive valide que vous avez obtenu lors d'une précédente demande adressée à Amazon Glacier (Amazon Glacier).
*Type* : chaîne
*Obligatoire* : Oui lorsque `Type` est défini sur `select` ou `archive-retrieval`.
**Description**
La description facultative de la tâche.
*Valeurs valides* : la description doit être inférieure ou égale à 1 024 octets. Les caractères autorisés sont les caractères ASCII 7 bits sans code de contrôle, plus précisément les valeurs ASCII décimales ou hexadécimales comprises, respectivement, entre 32 et 126 et entre 0x20 et 0x7E.
*Type* : chaîne
*Obligatoire* : non
**Format**
(Facultatif) Format de sortie lors du lancement d'une tâche d'extraction d'un inventaire de coffre. Si vous lancez une tâche d'inventaire et que vous ne spécifiez pas de champ `Format`, JSON est le format par défaut.
*Valeurs valides* : `CSV` \$1 `JSON`
*Type* : chaîne
*Obligatoire* : non
**InventoryRetrievalParameters**
Paramètres d'entrée utilisés pour l'extraction d'un inventaire par plage.
*Type* : objet [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md)
*Obligatoire* : non
**OutputLocation**
Objet qui contient des informations sur l'emplacement auquel les résultats de tâches de sélection sont stockés.
*Type* : objet [OutputLocation](api-OutputLocation.md)
*Obligatoire* : oui, pour les tâches `select`.
**RetrievalByteRange**
La plage d'octets à récupérer pour un`archive-retrieval`, sous la forme « *StartByteValue* - *EndByteValue* ». Si ce champ n'est pas spécifié, l'archive entière est extraite. Si ce champ est spécifié, la plage d'octets doit être alignée en termes de méga-octets (1024\$11024). Aligné par mégaoctet signifie qu'*StartByteValue*il doit être divisible par 1 Mo, et *EndByteValue*plus 1 doit être divisible par 1 Mo ou être la fin de l'archive spécifiée comme valeur de taille d'octet d'archive moins 1. S'il n'**RetrievalByteRange**est pas aligné en mégaoctets, cette opération renvoie une réponse. `400`
Une erreur se produit si vous spécifiez ce champ pour une demande de tâche `inventory-retrieval` ou `select`.
*Type* : chaîne
*Obligatoire* : non
**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)
*Obligatoire* : non
**SNSTopic**
Le nom de ressource Amazon (ARN) de la rubrique Amazon SNS dans laquelle Amazon Glacier envoie une notification lorsque le travail est terminé et que le résultat est prêt à être téléchargé. La rubrique spécifiée publie la notification à l'attention des abonnés.
La rubrique SNS doit exister. Si ce n'est pas le cas, Amazon Glacier ne le créera pas pour vous. En outre, la rubrique SNS doit avoir une stratégie qui permet au compte ayant créé la tâche de publier des messages dans la rubrique. Pour plus d'informations sur les noms des rubriques SNS, consultez [CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)le manuel *Amazon Simple Notification Service* *API Reference*.
*Type* : chaîne
*Obligatoire* : non
**Palier**
Niveau à utiliser pour une tâche de sélection ou d'extraction d'archive. `Standard` est la valeur par défaut utilisée.
*Valeurs Valides* : `Expedited` \$1 `Standard` \$1 `Bulk`
*Type* : chaîne
*Obligatoire* : non
**Type**
Le type de tâche. Vous pouvez lancer une tâche pour exécuter une requête de sélection sur une archive, d'extraction d'archive ou d'obtention d'un inventaire de coffre.
*Valeurs Valides* : `select` \$1 `archive-retrieval` \$1 `inventory-retrieval`
*Type* : chaîne
*Obligatoire* : oui
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# OutputLocation
Contient des informations sur l'emplacement auquel les résultats des tâches et les erreurs sont stockés.
## Table des matières
**S3**
Objet décrivant l'emplacement Amazon S3 où seront reçus les résultats de la demande de restauration.
*Type :* [Emplacement S3](api-S3Location.md)
*Obligatoire* : oui
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# OutputSerialization
Décrit la manière dont la sortie est sérialisée.
## Table des matières
**CSV**
Objet décrivant la sérialisation des résultats de la demande codée CSV (valeurs séparées par des virgules).
*Type* : objet [CSVOutput](api-CSVOutput.md)
*Obligatoire* : non
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# Emplacement S3
Contient des informations sur l'emplacement dans Amazon S3 où sont stockés les résultats de la tâche.
## Table des matières
**AccessControlList**
Liste des attributions contrôlant l'accès aux résultats stockés.
*Type* : tableau d'objets [Octroi](api-Grant.md)
*Obligatoire* : non
**BucketName**
Nom du compartiment Amazon S3 où sont stockés les résultats de la tâche. Le compartiment doit se trouver dans la même AWS région que le coffre contenant l'objet d'archive d'entrée.
*Type :* chaîne
*Obligatoire* : oui
**CannedACL**
Liste de contrôle d'accès (ACL) prédéfinie à appliquer aux résultats des tâches.
*Type :* chaîne
*Valeurs Valides*: `private` \$1 `public-read` \$1 `public-read-write` \$1 `aws-exec-read` \$1 `authenticated-read` \$1 `bucket-owner-read` \$1 `bucket-owner-full-control`
*Obligatoire* : non
**Chiffrement**
Objet qui contient des informations sur le chiffrement utilisé pour stocker les résultats de la tâche dans Amazon S3.
*Type* : objet [Chiffrement](api-Encryption.md)
*Obligatoire* : non
**Préfixe**
Préfixe qui précède les résultats de cette demande. La longueur maximale du préfixe est de 512 caractères.
*Type :* chaîne
*Obligatoire* : oui
**StorageClass**
Classe de stockage utilisée pour stocker les résultats des tâches.
*Type :* chaîne
*Valeurs Valides* : `STANDARD` \$1 `REDUCED_REDUNDANCY` \$1 `STANDARD_IA`
*Obligatoire* : non
**Balisage**
Ensemble de balises appliqué aux résultats des tâches.
*Type* : mappage chaîne/chaîne
*Obligatoire* : non
**UserMetadata**
Mappage des métadonnées à stocker avec les résultats de la tâche dans Amazon S3.
*Type* : mappage chaîne/chaîne
*Obligatoire* : non
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# SelectParameters
Contient les informations sur les paramètres utilisés pour la tâche de sélection.
## Table des matières
**Expression**
Expression utilisée pour sélectionner l'objet. L'expression ne doit pas dépasser le quota de 128 000 caractères.
*Type :* chaîne
*Obligatoire* : oui
**ExpressionType**
Type de l'expression fournie, par exemple, `SQL`.
*Valeurs valides* : `SQL`
*Type :* chaîne
*Obligatoire* : oui
**InputSerialization**
Décrit le format de sérialisation de l'objet dans la sélection.
*Type* : objet [InputSerialization](api-InputSerialization.md)
*Obligatoire* : non
**OutputSerialization**
Décrit la manière dont les résultats de la tâche de sélection sont sérialisés.
*Obligatoire* : non
*Type* : objet [OutputSerialization](api-OutputSerialization.md)
## Plus d'informations
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# Opérations de récupération des données
Les opérations liées à la récupération de données disponibles dans Amazon Glacier sont les suivantes.
**Topics**
+ [
# Obtention de la stratégie d'extraction de données (GET policy)
](api-GetDataRetrievalPolicy.md)
+ [
# Répertorier la capacité provisionnée (GET provisioned-capacity)
](api-ListProvisionedCapacity.md)
+ [
# Acheter la capacité provisionnée (POST provisioned-capacity)
](api-PurchaseProvisionedCapacity.md)
+ [
# Définition de stratégie d'extraction de données (PUT policy)
](api-SetDataRetrievalPolicy.md)
# Obtention de la stratégie d'extraction de données (GET policy)
## Description
Cette opération renvoie la politique de récupération de données actuelle pour la AWS région Compte AWS et la région spécifiées dans la `GET` demande. 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).
## Requêtes
Pour obtenir la stratégie actuelle d'extraction de données, envoyez une demande HTTP `GET` à l'URI de la stratégie d'extraction de données, comme illustré dans l'exemple de syntaxe suivant.
### Syntaxe
```
1. GET /AccountId/policies/data-retrieval 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. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
### 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 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
"Policy":
{
"Rules":[
{
"BytesPerHour": Number,
"Strategy": 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.
**BytesPerHour**
Nombre maximal d'octets pouvant être extraits en une heure.
Ce champ sera présent uniquement si la valeur du champ **Stratégie** est `BytesPerHour`.
*Type* : nombre
**Règles**
Règle de stratégie. Bien qu'il s'agisse d'un type de liste, il n'existe actuellement qu'une seule règle, qui contient un champ Stratégie et éventuellement un BytesPerHour champ.
*Type* : tableau
**Stratégie**
Le type de stratégie d'extraction de données.
*Type* : chaîne
Valeurs valides : `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` équivaut à sélectionner **Taux d'extraction max.** dans la console. `FreeTier` équivaut à sélectionner **Offre gratuite uniquement** dans la console. `None` équivaut à sélectionner **No Retrieval Policy (Pas de stratégie d'extraction)** dans la console. Pour plus d'informations sur la sélection de stratégies d'extraction de données dans la console, consultez la section [Politiques de récupération des données Amazon Glacier](data-retrieval-policy.md).
### 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 montre comment obtenir une stratégie d'extraction de données.
### Exemple de requête
Dans cet exemple, une demande `GET` est envoyée à l'URI de l'emplacement d'une stratégie.
```
1. GET /-/policies/data-retrieval 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
Une réponse positive affiche la stratégie d'extraction de données dans le corps de la réponse au format JSON.
```
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: 85
6.
7. {
8. "Policy":
9. {
10. "Rules":[
11. {
12. "BytesPerHour":10737418240,
13. "Strategy":"BytesPerHour"
14. }
15. ]
16. }
17. }
```
## Sections connexes
+ [Définition de stratégie d'extraction de données (PUT policy)](api-SetDataRetrievalPolicy.md)
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)
# Répertorier la capacité provisionnée (GET provisioned-capacity)
Cette opération répertorie les unités de capacité provisionnées pour le Compte AWS spécifié. Pour plus d'informations sur la capacité allouée, consultez [Options de récupération des archives](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options).
Une unité de capacité provisionnée dure un mois à compter de la date et de l'heure d'achat, qui correspondent à la date de début. L'unité expire à la date d'expiration, ce qui correspond à exactement un mois après la date de début, à la seconde près.
Si la date de début est le 31e jour du mois, la date d'expiration correspond au dernier jour du mois suivant. Par exemple, si la date de début est le 31 août, la date d'expiration est le 30 septembre. Si la date de début est le 31 janvier, la date d'expiration est le 28 février. Vous pouvez voir cette fonctionnalité sous [Exemple de réponse](#api-ListProvisionedCapacity-example1-response).
## Syntaxe de la requête
Pour afficher la capacité de récupération provisionnée pour un compte, envoyez une demande HTTP GET à l'URI de capacité provisionnée, comme illustré dans l'exemple de syntaxe suivant.
```
1. GET /AccountId/provisioned-capacity 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. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
## 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
Si l'opération aboutit, le service renvoie une réponse HTTP `200 OK`.
### Syntaxe de la réponse
```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
"ProvisionedCapacityList":
{
"CapacityId" : "string",
"StartDate" : "string"
"ExpirationDate" : "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.
**CapacityId**
L'ID qui identifie l'unité de capacité provisionnée.
*Type* : chaîne.
**StartDate**
Date d'achat de la capacité provisionnée, fuseau horaire UTC.
*Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**ExpirationDate**
Date d'expiration de la capacité provisionnée, fuseau horaire UTC.
*Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
### 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 répertorie les unités de capacité provisionnée pour un compte.
### Exemple de requête
Dans cet exemple, une requête GET est envoyée pour récupérer la liste des unités de capacité provisionnée pour le compte spécifié.
```
1. GET /123456789012/priority-capacity 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
Si la demande aboutit, Amazon Glacier (Amazon Glacier) renvoie un `HTTP 200 OK` contenant la liste des unités de capacité allouées au compte, comme indiqué dans l'exemple suivant.
L'unité de capacité provisionnée répertoriée en premier est un exemple d'unité avec une date de début correspondant au 31 janvier 2017 et une date d'expiration correspondant au 28 février 2017. Comme stipulé auparavant, si la date de début est le 31e jour du mois, la date d'expiration correspond au dernier jour du mois suivant.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. Content-Type: application/json
5. Content-Length: length
6.
7. {
8. "ProvisionedCapacityList",
9. {
10. "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
11. "StartDate": "2017-01-31T14:26:33.031Z",
12. "ExpirationDate": "2017-02-28T14:26:33.000Z",
13. },
14. {
15. "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
16. "StartDate": "2016-12-13T20:11:51.095Z"",
17. "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
18. },
19. ...
20. }
```
## Sections connexes
+ [Acheter la capacité provisionnée (POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)
# Acheter la capacité provisionnée (POST provisioned-capacity)
Cette opération achète une unité de capacité provisionnée pour un Compte AWS.
Une unité de capacité provisionnée dure un mois à compter de la date et de l'heure d'achat, qui correspondent à la date de début. L'unité expire à la date d'expiration, ce qui correspond à exactement un mois après la date de début, à la seconde près.
Si la date de début est le 31e jour du mois, la date d'expiration correspond au dernier jour du mois suivant. Par exemple, si la date de début est le 31 août, la date d'expiration est le 30 septembre. Si la date de début est le 31 janvier, la date d'expiration est le 28 février.
La capacité provisionnée garantit que la capacité de récupération pour les récupérations rapides est disponible lorsque vous en avez besoin. Chaque unité de capacité garantit qu'au moins trois extractions accélérées peuvent être effectuées toutes les cinq minutes et fournit un débit de récupération allant jusqu'à 150 MB/s %. Pour plus d'informations sur la capacité allouée, consultez [Options de récupération des archives](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options).
**Note**
Il y a une limite de deux unités de capacité provisionnées par. Compte AWS
## Requêtes
Pour acheter une unité de capacité provisionnée pour Compte AWS envoyer une `POST` requête HTTP à l'URI de capacité provisionnée.
### Syntaxe
```
1. POST /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
```
**Note**
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
### 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
Si la demande d'opération aboutit, le service renvoie une réponse HTTP `201 Created`.
### Syntaxe
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-capacity-id: CapacityId
```
### En-têtes de réponse
Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. 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).
| Nom | Description |
| --- | --- |
| `x-amz-capacity-id` | L'ID qui identifie l'unité de capacité provisionnée. Type : Chaîne |
### 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 |
| --- | --- | --- | --- |
| LimitExceededException | Retournée si la requête donnée dépasse la limite du compte pour les unités de capacité provisionnée. | 400 Bad Request | Client |
## Exemples
L'exemple suivant illustre le cas d'un achat de capacité provisionnée pour un compte.
### Exemple de requête
L'exemple suivant envoie une demande HTTP POST pour acheter une unité de capacité provisionnée.
```
1. POST /123456789012/provisioned-capacity HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
```
### Exemple de réponse
Si la demande aboutit, Amazon Glacier (Amazon Glacier) renvoie une `HTTP 201 Created` réponse, comme indiqué dans l'exemple suivant.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z
```
## Sections connexes
+ [Répertorier la capacité provisionnée (GET provisioned-capacity)](api-ListProvisionedCapacity.md)
# Définition de stratégie d'extraction de données (PUT policy)
## Description
Cette opération définit puis met en œuvre une politique de récupération de données dans la AWS région spécifiée dans la `PUT` demande. Vous pouvez définir une politique par AWS région pour un Compte AWS. La stratégie est appliquée en quelques minutes dans le cadre d'une opération `PUT` réussie.
L'opération de définition de stratégie n'a pas d'incidence sur les tâches d'extraction qui étaient en cours avant l'application de la stratégie. 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).
## Requêtes
### Syntaxe
Pour définir une stratégie d'extraction de données, envoyez une demande HTTP PUT à l'URI de stratégie d'extraction de données, comme illustré dans l'exemple de syntaxe suivant.
```
1. PUT /AccountId/policies/data-retrieval HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
7.
8. {
9. "Policy":
10. {
11. "Rules":[
12. {
13. "Strategy": String,
14. "BytesPerHour": Number
15. }
16. ]
17. }
18. }
```
**Note**
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. 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 spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
### 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
Le corps de la demande contient les champs JSON suivants.
**BytesPerHour**
Nombre maximal d'octets pouvant être extraits en une heure.
Ce champ n'est obligatoire que si la valeur du champ Strategy est `BytesPerHour`. Votre opération PUT est refusée si la valeur du champ Strategy n'est pas `BytesPerHour` et que vous définissez ce champ.
*Type* : nombre
*Obligatoire* : oui, si la valeur du champ Stratégie est `BytesPerHour`. Dans le cas contraire, ce champ n'est pas obligatoire.
*Valeurs valides* : la valeur d'entier minimale est 1. La valeur d'entier maximale est comprise entre 2^63 et 1 (inclus).
**Règles**
Règle de stratégie. Bien qu'il s'agisse d'un type de liste, il ne doit actuellement y avoir qu'une seule règle, qui contient un champ Stratégie et éventuellement un BytesPerHour champ.
*Type* : tableau
*Obligatoire* : oui
**Stratégie**
Type de stratégie d'extraction de données à définir.
*Type* : chaîne
*Obligatoire* : oui
Valeurs valides : `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` équivaut à sélectionner **Taux d'extraction max.** dans la console. `FreeTier` équivaut à sélectionner **Offre gratuite uniquement** dans la console. `None` équivaut à sélectionner **No Retrieval Policy (Pas de stratégie d'extraction)** dans la console. Pour plus d'informations sur la sélection de stratégies d'extraction de données dans la console, consultez la section [Politiques de récupération des données Amazon Glacier](data-retrieval-policy.md).
## Réponses
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Cette opération ne renvoie pas de corps de réponse.
### 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
### Exemple de requête
L'exemple suivant envoie une demande HTTP PUT avec la valeur `BytesPerHour` définie pour le champ Strategy.
```
1. PUT /-/policies/data-retrieval 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. "Policy":
9. {
10. "Rules":[
11. {
12. "Strategy":"BytesPerHour",
13. "BytesPerHour":10737418240
14. }
15. ]
16. }
17. }
```
L'exemple suivant envoie une demande HTTP PUT avec la valeur `FreeTier` définie pour le champ Strategy.
```
1. PUT /-/policies/data-retrieval 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. "Policy":
9. {
10. "Rules":[
11. {
12. "Strategy":"FreeTier"
13. }
14. ]
15. }
16. }
```
L'exemple suivant envoie une demande HTTP PUT avec la valeur `None` définie pour le champ Strategy.
```
1. PUT /-/policies/data-retrieval 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. "Policy":
9. {
10. "Rules":[
11. {
12. "Strategy":"None"
13. }
14. ]
15. }
16. }
```
### Exemple de réponse
Si la demande est acceptée, Amazon Glacier (Amazon Glacier) définit la politique et renvoie un `HTTP 204 No Content` comme indiqué dans l'exemple suivant.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```
## Sections connexes
+ [Obtention de la stratégie d'extraction de données (GET policy)](api-GetDataRetrievalPolicy.md)
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)