Suppression d'une archive (DELETE archive) - Amazon S3 Glacier
DescriptionRequêtesRéponsesExemplesSections connexes

Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 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 sections Classes de stockage S3 Glacier et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent Amazon S3API, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de chiffrement optionnelles avancées, etc.

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.

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 dans Amazon S3 Glacier.

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 d'extraction d'archive prépare activement les données au téléchargement au moment où Amazon S3 Glacier (S3 Glacier) reçoit la demande de suppression d'archive, il est possible que l'opération d'extraction d'archive échoue.

  • Si la tâche d'extraction d'archive a réussi à préparer l'archive au téléchargement au moment où S3 Glacier reçoit la demande de suppression de l'archive, vous pouvez télécharger la sortie.

Pour plus d'informations sur l'extraction de l'archive, consultez la section Téléchargement d'une archive dans S3 Glacier.

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

DELETE /AccountId/vaults/VaultName/archives/ArchiveID HTTP/1.1
Host: glacier.Region.amazonaws.com
x-amz-Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

Note

La valeur de AccountId est l'ID de Compte AWS du compte propriétaire du coffre. Vous pouvez spécifier un ID de Compte AWS ou éventuellement un simple « - » (trait d'union), auquel cas Amazon S3 Glacier utilise l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Si vous utilisez un ID de compte, évitez d'y inclure des traits d'union (« - »).

Paramètres de demande

Cette opération n'utilise pas les paramètres de demande.

En-têtes de demande

Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez En-têtes de demande communs.

Corps de la requête

Cette opération n'a pas de corps de demande.

Réponses

Syntaxe

HTTP/1.1 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.

Corps de la réponse

Cette opération ne renvoie pas de corps de réponse.

Erreurs

Pour en savoir plus sur les exceptions et les messages d'erreur Amazon S3 Glacier, consultez Réponses d'erreur.

Exemples

L'exemple suivant 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.

DELETE /-/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId 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

Si la demande aboutit, S3 Glacier répond par 204 No Content pour indiquer que l'archive est supprimée.

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT