Condividi tramite

Ricevere ed eliminare un messaggio (lettura distruttiva)

  • Articolo

Questa operazione riceve un messaggio da una coda o una sottoscrizione, quindi rimuove il messaggio dalla coda o dalla sottoscrizione in un'operazione atomica.

Richiesta

Metodo URI richiesta Versione HTTP
DELETE http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head

oppure

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head|HTTP/1.1

Intestazioni richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative. Oltre alle proprietà elencate, l'intestazione può contenere proprietà personalizzate. Vedere l'esempio.

Intestazione della richiesta Descrizione
Autorizzazione Specificare uno dei valori di token seguenti:
  • Token Json Web Token (JWT) di Azure Active Directory (Azure AD).
    Esempio: Authorization: Bearer <Azure AD JWT token>.
    Per informazioni sulla generazione di un token di Azure AD, vedere Autenticare da un'applicazione.
  • Un token di firma di accesso condiviso.
    Esempio: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
    Per informazioni sulla generazione di un token di firma di accesso condiviso, vedere Generare un token di firma di accesso condiviso e generare un token di firma di accesso condiviso.

Corpo della richiesta

Nessuno.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codici di risposta

Codice Descrizione
200 Messaggio recuperato ed eliminato correttamente.
204 Nessun messaggio disponibile nel periodo di timeout specificato.
400 Richiesta non valida.
401 Errore di autorizzazione.
410 Coda o sottoscrizione specificata inesistente.
500 Errore interno.

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni della risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Corpo della risposta

Il corpo della risposta è il corpo del messaggio recuperato.

Esempio

La richiesta HTTP seguente riceve ed elimina un messaggio da una coda:

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

Il bus di servizio restituisce la risposta seguente. Il messaggio contiene le proprietà personalizzate "Priority" e "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

Vedere anche

Esempio di client HTTP del bus di servizio