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
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 de coffre (DELETE vault)
Description
Cette opération supprime un coffre. Amazon S3 Glacier (S3 Glacier) ne supprime un coffre que s'il ne contient pas d'archives à la date du dernier inventaire et s'il n'a fait l'objet d'aucune opération d'écriture depuis le dernier inventaire. Si l'une de ces deux conditions n'est pas remplie, la suppression du coffre échoue (autrement dit, le coffre n'est pas retiré) et S3 Glacier renvoie une erreur.
Vous pouvez utiliser l'opération Description de coffre (GET vault) qui fournit des informations sur le coffre, notamment le nombre d'archives qu'il contient ; toutefois, ces informations sont basées sur le dernier inventaire du coffre généré par S3 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.
Requêtes
Pour supprimer un coffre, envoyez une demande DELETE
à l'URI de ressource de coffre.
Syntaxe
DELETE /
AccountId
/vaults/VaultName
HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
x-amz-glacier-version: 2012-06-01
Note
La valeur de AccountId
est l'ID de Compte AWS du compte propriétaire du coffre. Vous pouvez spécifier un ID de Compte AWS ou éventuellement un simple « -
» (trait d'union), auquel cas Amazon S3 Glacier utilise l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Si vous utilisez un ID de compte, évitez d'y inclure des traits d'union (« - »).
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
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.
DELETE /-/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
HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT
Sections connexes
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK Amazon propres au langage, consultez la ressource suivante :