Freigeben über

Nachricht entsperren

Entsperrt eine Nachricht für die Verarbeitung durch andere Empfänger in einem angegebenen Abonnement. Dieser Vorgang löscht das Sperrobjekt, wodurch die Nachricht entsperrt wird. Bevor der Vorgang aufgerufen wird, muss ein Empfänger die Nachricht zuerst sperren.

Bitten

Methode Anforderungs-URI HTTP-Version
STELLEN 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 durch den Vorgang BrokerProperties{MessageId} in zurückgegeben wird, entsperrt werden soll.
sequence-number Die Sequenznummer der Nachricht, die entsperrt werden soll, wie in BrokerProperties{SequenceNumber} durch den Vorgang Vorschaunachricht zurückgegeben wird.
lockToken Das Token der Sperre der Nachricht, die entsperrt werden soll, wie sie von der Vorschaunachricht Vorgang in BrokerProperties{LockToken}zurückgegeben wird.

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben.

Anforderungsheader Beschreibung
Ermächtigung Geben Sie einen der folgenden Werte an:

Anforderungstext

Nichts.

Antwort

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

Antwortcodes

Code Beschreibung
200 Nachricht wurde erfolgreich entsperrt.
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 entsperrt eine Nachricht:

PUT 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

  • Last updated on