Elimina messaggio (Archiviazione di Azure)

  • Articolo

L'operazione Delete Message elimina il messaggio specificato dalla coda.

Richiesta

È possibile costruire la Delete Message richiesta come indicato di seguito. È consigliato il protocollo HTTPS.

Metodo URI richiesta Versione HTTP
DELETE https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Sostituire myaccount con il nome dell'account di archiviazione, myqueue con il nome della coda e string-value con il valore della ricevuta pop ottenuto per l'eliminazione del messaggio.

URI del servizio di archiviazione emulato

Quando si effettua una richiesta con il servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta di archiviazione code di Azure come 127.0.0.1:10001, seguita dal nome dell'account di archiviazione emulato.

Metodo URI richiesta Versione HTTP
DELETE http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Parametri URI

L'URI della richiesta supporta i parametri seguenti.

Parametro Descrizione
popreceipt Obbligatorio. Valore della ricevuta pop valido restituito da una chiamata precedente all'operazione Recupera messaggi o Aggiorna messaggio .
timeout Facoltativa. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostazione dei timeout per le operazioni di archiviazione code.

Intestazioni della richiesta

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

Intestazione della richiesta Descrizione
Authorization Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
Date o x-ms-date Obbligatorio. Specifica la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
x-ms-version Facoltativa. Specifica la versione dell'operazione da usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.
x-ms-client-request-id Facoltativa. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log quando la registrazione è configurata. È consigliabile usare questa intestazione per correlare le attività lato client con le richieste ricevute dal server. Per altre informazioni, vedere Monitorare l'archiviazione code di Azure.

Testo della richiesta

Nessuno.

Risposta

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

Codice stato

Un'operazione completata correttamente restituisce il codice di stato 204 (Nessun contenuto). Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni di risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; La risposta include anche intestazioni HTTP aggiuntive e standard. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Intestazione della richiesta Descrizione
x-ms-request-id Questa intestazione identifica in modo univoco la richiesta effettuata e può essere usata per la risoluzione dei problemi della richiesta. Per altre informazioni, vedere Risoluzione dei problemi relativi alle operazioni api.
x-ms-version Indica la versione dell'archiviazione code usata per eseguire la richiesta. Questa intestazione viene restituita per le richieste effettuate nella versione 2009-09-19 e successive.
Date Valore di data/ora UTC che indica l'ora in cui è stata avviata la risposta. Il servizio genera questo valore.
x-ms-client-request-id Questa intestazione può essere usata per risolvere le richieste e le risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id , se presente nella richiesta. Il valore è al massimo 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, questa intestazione non sarà presente nella risposta.

Corpo della risposta

Nessuno.

Autorizzazione

Il proprietario dell'account può eseguire questa operazione. Inoltre, chiunque disponga di una firma di accesso condiviso che dispone dell'autorizzazione per eseguire questa operazione può eseguirla.

Commenti

Quando si elimina correttamente un messaggio, viene contrassegnato immediatamente per l'eliminazione e non è più accessibile ai client. Il messaggio verrà rimosso in seguito dalla coda durante un'operazione di Garbage Collection.

Dopo che un client recupera un messaggio con l'operazione Recupera messaggi , il client deve elaborare ed eliminare il messaggio. Per eliminare il messaggio, nel corpo della risposta dell'operazione Get Messages devono essere restituiti due dati:

  • L'ID messaggio, un valore GUID opaco che identifica il messaggio nella coda.

  • Una ricezione valida, un valore opaco che indica che il messaggio è stato recuperato.

L'ID messaggio viene restituito dall'operazione Get Messages precedente. Il valore di ricezione viene restituito dall'operazione Get Messages o Update Message più recente. Affinché l'operazione Delete Message abbia esito positivo, la ricevuta popup specificata nella richiesta deve corrispondere alla ricevuta popup restituita dall'operazione Get Messages o Update Message .

I valori di ricezione rimangono validi finché non si verifica uno dei seguenti eventi:

  • Il messaggio scade.

  • Il messaggio viene eliminato usando l'ultima ricevuta pop ricevuta, da Get Messages o Update Message.

  • Il timeout di invisibilità scade e il messaggio viene dequeuato da una Get Messages richiesta. Al termine del timeout di invisibilità, il messaggio diventa di nuovo visibile. Se viene recuperato da un'altra Get Messages richiesta, la ricevuta pop restituita può essere usata per eliminare o aggiornare il messaggio.

  • Il messaggio viene aggiornato con un nuovo timeout di visibilità. Quando il messaggio viene aggiornato, viene restituita una nuova ricevuta popup.

Se non viene trovato un messaggio con una ricevuta popup corrispondente, il servizio restituisce il codice di errore 404 (Non trovato). Questo errore si verifica nei casi elencati in precedenza in cui la ricevuta pop non è più valida.

Vedi anche

Autorizzare le richieste ad Archiviazione di Azure
Stato e codici errore
Codici di errore di Archiviazione code