Supprimer un message (Stockage Azure)

  • Article

L’opération Delete Message supprime le message spécifié de la file d’attente.

Requête

Vous pouvez construire la Delete Message requête comme suit. HTTPS est recommandé.

Méthode URI de demande Version HTTP
DELETE https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Remplacez par myaccount le nom de votre compte de stockage, myqueue par le nom de votre file d’attente et string-value par la valeur du reçu contextuel qui a été obtenu pour la suppression du message.

URI de service de stockage émulé

Lorsque vous effectuez une demande auprès du service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et le port stockage File d’attente Azure en tant que 127.0.0.1:10001, suivi du nom du compte de stockage émulé.

Méthode URI de demande Version HTTP
DELETE http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Paramètres URI

L'URI de demande prend en charge les paramètres suivants.

Paramètre Description
popreceipt Obligatoire. Valeur de réception contextuelle valide retournée par un appel antérieur à l’opération Obtenir des messages ou Mettre à jour le message .
timeout Optionnel. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Définition de délais d’expiration pour les opérations de stockage file d’attente.

En-têtes de requête

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

En-tête de requête Description
Authorization Obligatoire. Spécifie le schéma d’autorisation, le nom du compte et la signature. Pour plus d’informations, consultez Autoriser les requêtes auprès du Stockage Azure.
Date ou x-ms-date Obligatoire. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête. Pour plus d’informations, consultez Autoriser les requêtes auprès du Stockage Azure.
x-ms-version Optionnel. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
x-ms-client-request-id Optionnel. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (Kio) enregistrée dans les journaux lors de la configuration de la journalisation. Nous vous recommandons vivement d’utiliser cet en-tête pour mettre en corrélation les activités côté client avec les demandes reçues par le serveur. Pour plus d’informations, consultez Surveiller le stockage File d’attente Azure.

Corps de la demande

Aucun.

response

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Code d’état

Une opération réussie renvoie le code d'état 204 (Aucun contenu). Pour plus d’informations sur les codes status, consultez État et codes d’erreur.

En-têtes de réponse

La réponse de l'opération inclut les en-têtes suivants. La réponse inclut également des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

En-tête de requête Description
x-ms-request-id Cet en-tête identifie de manière unique la demande qui a été effectuée et peut être utilisé pour la résolution des problèmes de la demande. Pour plus d’informations, consultez Résolution des problèmes liés aux opérations d’API.
x-ms-version Indique la version du stockage file d’attente utilisée pour exécuter la demande. Cet en-tête est renvoyé pour les demandes effectuées avec la version 2009-09-19 ou une version ultérieure.
Date Valeur de date/heure UTC qui indique l’heure à laquelle la réponse a été lancée. Le service génère cette valeur.
x-ms-client-request-id Cet en-tête peut être utilisé pour résoudre les demandes et les réponses correspondantes. La valeur de cet en-tête est égale à la valeur de l’en-tête x-ms-client-request-id , s’il est présent dans la demande. La valeur est au maximum de 1 024 caractères ASCII visibles. Si l’en-tête x-ms-client-request-id n’est pas présent dans la requête, cet en-tête ne sera pas présent dans la réponse.

Response body

Aucun.

Autorisation

Le propriétaire du compte peut effectuer cette opération. En outre, toute personne disposant d’une signature d’accès partagé qui a l’autorisation d’effectuer cette opération peut l’effectuer.

Notes

Lorsque vous supprimez un message, il est immédiatement marqué pour suppression et n’est plus accessible aux clients. Le message est supprimé ensuite de la file d'attente pendant le garbage collection.

Une fois qu’un client a récupéré un message avec l’opération Obtenir des messages , le client est censé traiter et supprimer le message. Pour supprimer le message, deux éléments de données doivent être renvoyés dans le corps de la réponse de l'opération Get Messages :

  • L'ID du message, une valeur GUID opaque qui identifie le message dans la file d'attente.

  • Un accusé de réception pop valide, une valeur opaque qui indique que le message a été récupéré.

L'ID du message est renvoyé par l'opération Get Messages précédente. L'accusé de réception pop est renvoyé par l'opération Get Messages ou Update Message la plus récente. Pour que l’opération Delete Message réussisse, le reçu contextuel spécifié dans la demande doit correspondre au reçu contextuel retourné par l’opération Get Messages ou Update Message .

Les accusés de réception pop restent valides jusqu'à ce que l'un des événements suivants se produise :

  • Le message expire.

  • Le message est supprimé à l’aide de la dernière réception contextuelle reçue, à partir de Get Messages ou Update Message.

  • Le délai d’invisibilité expire et le message est supprimé par une Get Messages requête. Lorsque le délai d’invisibilité expire, le message redevient visible. S’il est récupéré par une autre Get Messages demande, le reçu contextuel retourné peut être utilisé pour supprimer ou mettre à jour le message.

  • Le message est mis à jour avec un nouveau délai de visibilité. Lorsque le message est mis à jour, un nouveau reçu contextuel est retourné.

Si un message avec un reçu contextuel correspondant est introuvable, le service retourne le code d’erreur 404 (Introuvable). Cette erreur se produit dans les cas précédemment répertoriés dans lesquels le reçu contextuel n’est plus valide.

Voir aussi

Autoriser les demandes à Stockage Azure
Codes d’état et d’erreur
Codes d’erreur de stockage de file d’attente