Freigeben über

Renew-Lock für eine Nachricht

Erneuert die Sperre auf einer bereits gesperrten Nachricht.

Bitten

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

Anforderungsheader

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

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

Anforderungstext

Nichts.

Antwort

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

Antwortcodes

Code Beschreibung
200 Die Nachrichtensperre wurde erfolgreich erneuert.
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

Die Antwort für diesen Vorgang enthält die folgenden Header. Die Antwort kann auch weitere standardmäßige HTTP-Header enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

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

Antworttext

Nichts.

Beispiel

Die folgende HTTP-Anforderung erneuert die Sperre für eine gesperrte Nachricht:

POST 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