Ta bort meddelande

Artikel
02/12/2024

Den här åtgärden slutför bearbetningen av ett låst meddelande och tar bort det från kön eller prenumerationen. Den här åtgärden bör bara anropas efter att ett tidigare låst meddelande har bearbetats, för att upprätthålla leveransgarantier minst en gång .

Förfrågan

Metod	URI för förfrågan	HTTP-version
DELETE	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId\|sequenceNumber}/{lockToken}` eller `http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId\|sequenceNumber}/{lockToken}\|HTTP/1.1`

URI-parametrar

URI:n finns i platsrubriken för det markerade meddelandet, eller så kan du konstruera den från de delar som beskrivs i följande tabell.

Parameter	Beskrivning
`messageId`	ID:t för meddelandet som ska tas bort som det returneras i `BrokerProperties{MessageId}` av åtgärden Peek Meddelande.
`sequence-number`	Sekvensnumret för meddelandet som ska tas bort som returneras `BrokerProperties{SequenceNumber}` av åtgärden Peek meddelande.
`lockToken`	Token för låset för meddelandet som ska tas bort som returneras av åtgärden Peek meddelande i `BrokerProperties{LockToken}`.

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden. Förutom egenskaperna i listan kan rubriken innehålla anpassade egenskaper. Se exemplet.

Begärandehuvud Description

Auktorisering

Begärandehuvud	Description
Auktorisering	Ange något av följande tokenvärden: Microsoft Entra ID JSON-webbtoken (JWT). Exempel: `Authorization: Bearer <Azure AD JWT token>`. Information om hur du genererar en Microsoft Entra-token finns i Hämta en Microsoft Entra token. En SAS-token. Exempel: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Information om hur du genererar en SAS-token finns i Generera en signatur för delad åtkomst och Generera SAS-token.

Ange något av följande tokenvärden:

Microsoft Entra ID JSON-webbtoken (JWT).
Exempel: Authorization: Bearer <Azure AD JWT token>.
Information om hur du genererar en Microsoft Entra-token finns i Hämta en Microsoft Entra token.
En SAS-token.
Exempel: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
Information om hur du genererar en SAS-token finns i Generera en signatur för delad åtkomst och Generera SAS-token.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och svarstexten.

Svarskoder

Kod	Description
200	Meddelandet har tagits bort.
401	Auktoriseringsfel.
404	Inget meddelande hittades med angiven `MessageId` eller `LockToken`.
410	Den angivna kön eller prenumerationen finns inte.
500	Internt fel.

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

Svarshuvud	Description
Content-Type	Ange till application/atom+xml;type=entry; charset=utf-8.

Svarstext

Inga.

Exempel

Följande HTTP-begäran tar bort ett meddelande från en kö:

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 returnerar följande svar:

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

Se även

Http-klientexempel för Service Bus

Dela via