Nachricht entsperren

Artikel
08/04/2023

Entsperrt eine Nachricht für die Verarbeitung durch andere Empfänger für ein angegebenes Abonnement. Dieser Vorgang löscht das Sperrenobjekt und bewirkt, dass die Nachricht entsperrt wird. Bevor der Vorgang aufgerufen wird, muss ein Empfänger die Nachricht zunächst löschen.

Anforderung

Methode	Anforderungs-URI	HTTP-Version
PUT	`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 entsperrt werden soll, wie sie vom `BrokerProperties{MessageId}` Vorgang "Nachricht einsehen" zurückgegeben wird.
`sequence-number`	Die Sequenznummer der nachricht, die entsperrt werden soll, wie sie vom `BrokerProperties{SequenceNumber}` Vorgang "Nachricht einsehen" zurückgegeben wird.
`lockToken`	Das Token der Sperre der zu entsperrenden Nachricht, wie vom Vorgang "Nachricht einsehen" in `BrokerProperties{LockToken}`zurückgegeben wird.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader BESCHREIBUNG

Authorization

Anforderungsheader	BESCHREIBUNG
Authorization	Geben Sie eine der folgenden Optionen an: JWT-Token (Azure Active Directory)-JSON-Webtoken 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.

Geben Sie eine der folgenden Optionen an:

JWT-Token (Azure Active Directory)-JSON-Webtoken
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	Nachricht erfolgreich freigeschaltet.
401	Autorisierungsfehler
404	Es wurde keine Meldung mit dem angegebenen `MessageId` oder `LockToken`gefunden.
410	Angegebene Warteschlange bzw. Abonnement existiert nicht.
500	Interner Fehler.

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

Antwortheader

Antwortheader	BESCHREIBUNG
Content-Type	Wird auf application/atom+xml;type=entry;charset=utf-8 festgelegt.

Antworttext

Keine.

Beispiel

Die folgende HTTP-Anforderung schaltet eine Nachricht frei:

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

Weitere Informationen

Servicebus-HTTP-Client-Beispiel

Freigeben über