Renew-Lock für eine Nachricht

Erneuert die Sperre für eine bereits gesperrte Nachricht.

Anforderung

Methode	Anforderungs-URI	HTTP-Version
POST	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

Sie finden die URI im Location-Header der eingesehenen Nachricht oder können diese aus den in der folgenden Tabelle beschriebenen Teilen zusammensetzen.

Parameter	BESCHREIBUNG
messageId	Die ID der Nachricht, die vom Vorgang Peek Message zurückgegeben BrokerProperties{MessageId} wird, für den die Sperre erneuert werden soll.
sequence-number	Die Sequenznummer der Nachricht, die vom Vorgang Peek Message zurückgegeben BrokerProperties{SequenceNumber} wird, für den die Sperre erneuert werden soll.
lockToken	Das Token der Sperre der Nachricht, wie es vom Vorgang Peek Message in BrokerProperties{LockToken}zurückgegeben wird, für den die Sperre erneuert werden soll.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader

BESCHREIBUNG

Authorization

Geben Sie einen der folgenden Tokenwerte an: Azure Active Directory (Azure AD) JSON-Webtoken (JWT) Beispiel: Authorization: Bearer <Azure AD JWT token>. Informationen zum Generieren eines Azure AD-Tokens finden Sie unter Authentifizieren von einer Anwendung. 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-Tokens und Generieren eines SAS-Tokens.

Anforderungstext

Keine.

Antwort

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

Antwortcodes

Code	BESCHREIBUNG
200	Nachrichtensperre erfolgreich erneuert.
401	Autorisierungsfehler
404	Es wurde keine Nachricht mit dem angegebenen MessageId oder LockTokengefunden.
410	Angegebene Warteschlange bzw. Abonnement existiert nicht.
500	Interner Fehler.

Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortheader	BESCHREIBUNG
Content-Type	Legen Sie diese Option auf application/atom+xml;type=entry;charset=utf-8 fest.

Antworttext

Keine.

Beispiel

Die folgende HTTP-Anforderung erneuert die Sperre einer gesperrten 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  

Weitere Informationen

Servicebus-HTTP-Client-Beispiel