Partager via

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 de l’accusé de réception qui a été obtenu pour la suppression du message.

URI du service de stockage émulé

Lorsque vous effectuez une requête auprès du service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et le port de stockage File d’attente Azure en tant que 127.0.0.1:10001, suivis 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 à partir d’un appel antérieur à l’opération Obtenir des messages ou Mettre à jour un message .
timeout facultatif. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Définition des 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 facultatif. 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 facultatif. 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 que le serveur reçoit. 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 Codes d’état et 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 requête 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 requête. 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 problèmes liés aux demandes et aux 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 requête. 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 demande, 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é et autorisée à effectuer cette opération peut l’effectuer.

Remarques

Lorsque vous supprimez correctement un message, il est immédiatement marqué pour suppression et n’est plus accessible.

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é sur 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 du dernier reçu contextuel reçu, à partir de Get Messages ou Update Message.

  • Le délai d’expiration de l’invisibilité expire et le message est supprimé par une Get Messages demande. Lorsque le délai d’expiration de l’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 dans le Stockage Azure
Codes d’état et d’erreur
Codes d’erreur de stockage de file d’attente