Partager via

Supprimer le message

Cette opération termine le traitement d’un message verrouillé et le supprime de la file d’attente ou de l’abonnement. Cette opération ne doit être appelée qu’après le traitement réussi d’un message précédemment verrouillé, afin de maintenir garanties de remise au moins une fois.

Demander

Méthode URI de requête HTTP Version
SUPPRIMER http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

ou

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1

Paramètres d’URI

L’URI est fourni dans l’en-tête Location du message aperçu, ou vous pouvez le construire à partir des parties décrites dans le tableau suivant.

Paramètre Description
messageId ID du message à supprimer tel qu’il est retourné dans BrokerProperties{MessageId} par l’opération de message d’aperçu.
sequence-number Numéro de séquence du message à supprimer tel qu’il est retourné dans BrokerProperties{SequenceNumber} par l’opération Aperçu du message.
lockToken Jeton du verrou du message à supprimer tel qu’il est retourné par l’opération de Aperçu du message dans BrokerProperties{LockToken}.

En-têtes de requête

Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs. Outre les propriétés répertoriées, l’en-tête peut contenir des propriétés personnalisées. Consultez l’exemple.

En-tête de requête Description
Autorisation Spécifiez l’une des valeurs de jeton suivantes :
  • Jeton JWT (Microsoft Entra ID JSON Web Token).
    Exemple : Authorization: Bearer <Azure AD JWT token>.
    Pour plus d’informations sur la génération d’un jeton Microsoft Entra, consultez Obtenir un jeton Microsoft Entra.
  • Jeton SAP.
    Exemple : Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
    Pour plus d’informations sur la génération d’un jeton SAP, consultez Générer un jeton de signature d’accès partagé et Générer un jeton SAP.

Corps de la demande

Aucun.

Réponse

La réponse inclut un code d’état HTTP, un ensemble d’en-têtes de réponse et le corps de la réponse.

Codes de réponse

Code Description
200 Message supprimé avec succès.
401 Échec de l’autorisation.
404 Aucun message n’a été trouvé avec le MessageId ou LockTokenspécifié.
410 La file d’attente ou l’abonnement spécifié n’existe pas.
500 Erreur interne.

Pour plus d’informations sur les codes d’état, consultez Status and Error Codes.

En-têtes de réponse

En-tête de réponse Description
Type de contenu Défini sur application/atom+xml ;type=entry ; charset=utf-8.

Corps de la réponse

Aucun.

Exemple

La requête HTTP suivante supprime un message d’une file d’attente :

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/31907572-1647-43c3-8741-631acd554d6f/7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=rukochbay&sig=rg9iGsK0ZyYlvhIqyH5IS5tqmeb08h8FstjHLPj3%2f8g%3d&se=1404265946&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

Service Bus retourne la réponse suivante :

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:35 GMT  
  
0

Voir aussi

  • Last updated on