DELETE

Syntaxe

Paramètres

Description

Cette méthode permet d'indiquer qu'il faut supprimer une ressource du serveur Web.

Remarques

• La méthode DELETE demande au serveur d'origine de supprimer l'association entre la ressource cible et sa fonctionnalité actuelle. En effet, cette méthode est similaire à la commande rm sous le système d'exploitation UNIX : elle exprime une opération de suppression sur la cartographie URI du serveur d'origine plutôt qu'attendre que les informations précédemment associées soient supprimées.
• Si la ressource cible a une ou plusieurs représentations actuelles, elles peuvent ou non être détruites par le serveur d'origine, et l'entreposage associé peut ou non être récupéré, en fonction entièrement de la nature de la ressource et de sa mis en oeuvre par le serveur d'origine. De même, d'autres aspects de la mise en oeuvre d'une ressource peuvent devoir être désactivés ou archivés à la suite d'une suppression, comme les connexions de base de données ou de passerelle. En général, on suppose que le serveur d'origine n'autorisera DELETE que sur les ressources pour lesquelles il dispose d'un mécanisme prescrit pour effectuer la suppression.
• Relativement peu de ressources permettent la méthode DELETE, son utilisation principale est pour les environnements de création à distance, où l'utilisateur a une certaine direction concernant son effet. Par exemple, une ressource ayant été précédemment créée à l'aide d'une demande PUT, ou identifiée via le champ d'entête Location: après une réponse 201 Created à une requête POST, pourrait permettre à une requête DELETE correspondante d'annuler ces actions. De même, les mises en oeuvres d'agent utilisateur personnalisé mettant en oeuvre une fonction de création, telles que les clients de contrôle de révision utilisant HTTP pour les opérations à distance, peuvent utiliser DELETE en supposant que l'espace URI du serveur a été conçu pour correspondre à un dépôt de versions.
• Si une méthode DELETE est appliquée avec succès, le serveur d'origine devrait envoyer un code de statut 202 Accepted si l'action réussira probablement mais n'a pas encore été exécutée, un code d'état 204 No Content si l'action a été exécutée et pas plus loin des informations doivent être fournies ou un code d'état 200 OK si l'action a été exécutée et que le message de réponse comprend une représentation décrivant l'état.
• Une charge utile dans un message de requête DELETE n'a pas de sémantique définie; l'envoi d'un corps de données utiles sur une requête DELETE peut entraîner le rejet de la requête par certaines mise en oeuvres existantes.
• Les réponses à la méthode DELETE ne peuvent pas être mises en cache. Si une requête DELETE passe à travers un cache ayant une ou plusieurs réponses entreposées pour l'URI de la requête effective, ces réponses entreposées seront invalidées.