Sbloccare un messaggio

Articolo
07/19/2023

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

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.

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

Condividi tramite