Sbloccare un messaggio

Sblocca un messaggio per l'elaborazione da parte di altri ricevitori in una determinata sottoscrizione. Questa operazione elimina l'oggetto blocco, sbloccando quindi il messaggio. Prima della chiamata dell'operazione, è necessario che il messaggio sia bloccato da un ricevitore.

Richiesta

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

Parametri dell'URI

L'URI è fornito nell'intestazione Percorso del messaggio osservato oppure è possibile crearlo usando le parti illustrate nella tabella seguente.

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

Intestazioni richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta

Descrizione

Autorizzazione

Specificare uno dei valori seguenti: Token JSON Token JSON (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 Eseguire l'autenticazione 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, un set di intestazioni della risposta e il corpo della risposta.

Codici di risposta

Codice	Descrizione
200	Sblocco del messaggio completato.
401	Errore di autorizzazione.
404	Non è stato trovato alcun messaggio con l'oggetto specificato MessageId o LockToken.
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

Intestazione di risposta	Descrizione
Content-Type	Viene impostata su application/atom+xml;type=entry;charset=utf-8.

Corpo della risposta

No.

Esempio

La richiesta HTTP seguente sblocca un messaggio:

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  

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

Esempio di client HTTP del bus di servizio