Condividi tramite

Rinnovare il blocco per un messaggio

  • Articolo

Rinnova il blocco in un messaggio già bloccato.

Richiesta

Metodo URI richiesta Versione HTTP
POST 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, come restituito BrokerProperties{MessageId} dall'operazione Peek Message , per cui il blocco deve essere rinnovato.
sequence-number Numero di sequenza del messaggio, restituito BrokerProperties{SequenceNumber} dall'operazione Peek Message , per cui il blocco deve essere rinnovato.
lockToken Token del blocco del messaggio, come restituito dall'operazione Peek Message in BrokerProperties{LockToken}, per cui il blocco deve essere rinnovato.

Intestazioni richiesta

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

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, un set di intestazioni della risposta e il corpo della risposta.

Codici di risposta

Codice Descrizione
200 Rinnovo del blocco del messaggio riuscito.
401 Errore di autorizzazione.
404 Nessun messaggio trovato 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

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.

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

Corpo della risposta

No.

Esempio

La richiesta HTTP seguente rinnova il blocco per un messaggio bloccato:

POST 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