Ta emot och ta bort meddelande (destruktiv läsning)

Artikel
08/05/2023

Den här åtgärden tar emot ett meddelande från en kö eller prenumeration och tar bort meddelandet från kön eller prenumerationen i en atomisk åtgärd.

Förfrågan

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

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: Azure Active Directory-token (Azure AD) JSON-webbtoken (JWT). Exempel: `Authorization: Bearer <Azure AD JWT token>`. Information om hur du genererar en Azure AD-token finns i Autentisera från ett program. 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:

Azure Active Directory-token (Azure AD) JSON-webbtoken (JWT).
Exempel: Authorization: Bearer <Azure AD JWT token>.
Information om hur du genererar en Azure AD-token finns i Autentisera från ett program.
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 och en uppsättning svarshuvuden.

Svarskoder

Kod	Description
200	Meddelandet har hämtats och tagits bort.
204	Inga meddelanden är tillgängliga inom den angivna tidsgränsen.
400	Felaktig begäran.
401	Auktoriseringsfel.
410	Den angivna kön eller prenumerationen finns inte.
500	Internt fel.

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Svarstext

Svarstexten är meddelandetexten i det hämtade meddelandet.

Exempel

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

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/head?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

Service Bus returnerar följande svar. Meddelandet innehåller de anpassade egenskaperna "Priority" och "Customer":

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
BrokerProperties: {"DeliveryCount":1,"EnqueuedSequenceNumber":0,"EnqueuedTimeUtc":"Tue, 01 Jul 2014 23:00:23 GMT","Label":"M1","MessageId":"3a146f76afee41648677887ffced72d8","SequenceNumber":1,"State":"Active","TimeToLive":10}  
Priority: "High"  
Customer: "12345,ABC"  
Date: Tue, 01 Jul 2014 23:00:23 GMT  
  
12  
This is a message.  
0

Se även

Http-klientexempel för Service Bus

Dela via