Freigeben über

Nachricht löschen

Dieser Vorgang schließt die Verarbeitung einer gesperrten Nachricht ab und löscht sie aus der Warteschlange oder dem Abonnement. Dieser Vorgang sollte nur nach der erfolgreichen Verarbeitung einer zuvor gesperrten Nachricht aufgerufen werden, um Mindestens einmal Zustellungszusicherungen aufrechtzuerhalten.

Bitten

Methode Anforderungs-URI HTTP-Version
LÖSCHEN http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

oder

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

URI-Parameter

Der URI wird im Speicherortkopf der vorschauierten Nachricht bereitgestellt, oder Sie können ihn aus den in der folgenden Tabelle beschriebenen Teilen erstellen.

Parameter Beschreibung
messageId Die ID der Nachricht, die in BrokerProperties{MessageId} durch den Vorgang Vorschaunachricht zurückgegeben wird.
sequence-number Die Sequenznummer der Nachricht, die gelöscht werden soll, wie in BrokerProperties{SequenceNumber} durch den Vorgang Vorschaunachricht zurückgegeben wird.
lockToken Das Token der Sperre der Nachricht, die gelöscht werden soll, wie von der Vorschaunachricht Vorgang in BrokerProperties{LockToken}zurückgegeben wird.

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben. Zusätzlich zu den aufgelisteten Eigenschaften kann die Kopfzeile benutzerdefinierte Eigenschaften enthalten. Sehen Sie sich das Beispiel an.

Anforderungsheader Beschreibung
Ermächtigung Geben Sie einen der folgenden Tokenwerte an:
  • Microsoft Entra ID JSON Web Token (JWT)-Token.
    Beispiel: Authorization: Bearer <Azure AD JWT token>.
    Informationen zum Generieren eines Microsoft Entra-Tokens finden Sie unter Abrufen eines Microsoft Entra-Tokens.
  • Ein SAS-Token.
    Beispiel: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
    Informationen zum Generieren eines SAS-Tokens finden Sie unter Generieren eines Shared Access Signature Token und Generieren von SAS-Token.

Anforderungstext

Nichts.

Antwort

Die Antwort enthält einen HTTP-Statuscode, eine Reihe von Antwortheadern und den Antworttext.

Antwortcodes

Code Beschreibung
200 Nachricht wurde erfolgreich gelöscht.
401 Autorisierungsfehler.
404 Es wurde keine Nachricht mit dem angegebenen MessageId oder LockTokengefunden.
410 Die angegebene Warteschlange oder das angegebene Abonnement ist nicht vorhanden.
500 Interner Fehler.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Antwortheader Beschreibung
Inhaltstyp Auf application/atom+xml;type=entry festgelegt; charset=utf-8.

Antworttext

Nichts.

Beispiel

Die folgende HTTP-Anforderung löscht eine Nachricht aus einer Warteschlange:

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 gibt die folgende Antwort zurück:

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

Siehe auch