Elimina messaggio

Questa operazione completa l'elaborazione di un messaggio bloccato e la elimina dalla coda o dalla sottoscrizione. Questa operazione deve essere chiamata solo dopo aver elaborato correttamente un messaggio bloccato in precedenza, per mantenere garanzie di recapito at-least-once.

Richiesta

Metodo	URI della richiesta	Versione HTTP
CANCELLARE	http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken} o http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1

Parametri URI

L'URI viene fornito nell'intestazione Location del messaggio visualizzato oppure è possibile crearlo dalle parti descritte nella tabella seguente.

Parametro	Descrizione
messageId	ID del messaggio da eliminare come restituito in BrokerProperties{MessageId} dall'operazione Visualizza messaggio.
sequence-number	Numero di sequenza del messaggio da eliminare come restituito in BrokerProperties{SequenceNumber} dall'operazione Visualizza messaggio.
lockToken	Token del blocco del messaggio da eliminare come restituito dall'operazione Visualizza messaggio in BrokerProperties{LockToken}.

Intestazioni della richiesta

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

Intestazione richiesta

Descrizione

Autorizzazione

Specificare uno dei valori di token seguenti: Token JWT (Microsoft Entra ID JSON Web Token). Esempio: Authorization: Bearer <Azure AD JWT token>. Per informazioni sulla generazione di un token Microsoft Entra, vedere Ottenere un token Microsoft Entra. 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

La risposta include un codice di stato HTTP, un set di intestazioni di risposta e il corpo della risposta.

Codici di risposta

Codice	Descrizione
200	Messaggio eliminato correttamente.
401	Errore di autorizzazione.
404	Non è stato trovato alcun messaggio con il MessageId specificato o LockToken.
410	La coda o la sottoscrizione specificata non esiste.
500	Errore interno.

Per informazioni sui codici di stato, vedere Status and Error Codes.

Intestazioni di risposta

Intestazione della risposta	Descrizione
Tipo di contenuto	Impostare su 'applicazione/atom+xml;type=entry; charset=utf-8.

Corpo della risposta

Nessuno.

Esempio

La richiesta HTTP seguente elimina un messaggio da una coda:

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  

Il bus di servizio restituisce la risposta seguente:

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  

Vedere anche