**Cette page est réservée aux clients existants du service Amazon Glacier utilisant Vaults et l'API REST d'origine datant de 2012.**
Si vous recherchez des solutions de stockage d'archives, nous vous recommandons d'utiliser les classes de stockage Amazon Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les [classes de stockage Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).
Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'accepte plus de nouveaux clients. Amazon Glacier est un service autonome doté de son propre service APIs qui stocke les données dans des coffres-forts et qui se distingue des classes de stockage Amazon S3 et Amazon S3 Glacier. Vos données existantes resteront sécurisées et accessibles indéfiniment dans Amazon Glacier. Aucune migration n'est requise. Pour un stockage d'archivage à long terme et à faible coût AWS , nous [recommandons les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), qui offrent une expérience client supérieure avec des compartiments S3, une Région AWS disponibilité totale APIs, des coûts réduits et AWS une intégration des services. Si vous souhaitez des fonctionnalités améliorées, envisagez de migrer vers les classes de stockage Amazon S3 Glacier en suivant nos [conseils relatifs aux AWS solutions pour le transfert de données depuis les coffres-forts Amazon Glacier vers les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Opérations 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)