Supprimer un 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 doit être appelée uniquement après le traitement réussi d'un message précédemment verrouillé, pour tenir à jour les assurances de livraison Une fois au minimum.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| Suppression | 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 URI
L'URI est indiqué dans l'en-tête Location de l'aperçu du message, ou vous pouvez le générer à partir des éléments décrits dans le tableau suivant.
| Paramètre | Description |
|---|---|
messageId |
ID du message à supprimer tel que retourné BrokerProperties{MessageId} par l’opération Message Aperçu. |
sequence-number |
Numéro de séquence du message à supprimer tel que retourné BrokerProperties{SequenceNumber} par l’opération Message Aperçu. |
lockToken |
Jeton du verrou du message à supprimer tel que retourné par l’opération Message Aperçu dans BrokerProperties{LockToken}. |
En-têtes de requête
Le tableau suivant décrit les en-têtes de demande obligatoires ou 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 :
|
Corps de la demande
Aucun.
response
La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et le corps de réponse.
Codes de réponse
| Code | Description |
|---|---|
| 200 | Message correctement supprimé. |
| 401 | Échec de l'autorisation. |
| 404 | Aucun message n’a été trouvé avec le spécifié MessageId ou LockToken. |
| 410 | La file d’attente ou l’abonnement spécifiés n’existent pas. |
| 500 | Erreur interne. |
Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur.
En-têtes de réponse
| En-tête de réponse | Description |
|---|---|
| Content-Type | 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