Delete Message
Comprimi il sommario
Espandi il sommario
Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Delete Message

 

Tramite l'operazione Delete Message viene eliminato il messaggio specificato.

La richiesta Delete Message può essere costruita come segue. È consigliato il protocollo HTTPS. Sostituire myaccount con il nome dell'account di archiviazione, myqueue con il nome della coda e string-value con il valore di ricezione POP ottenuto per il messaggio da eliminare:

Metodo

URI della richiesta

Versione HTTP

DELETE

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

Quando si effettua una richiesta nel servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta del servizio di accodamento come 127.0.0.1:10001, seguiti dal nome dell'account di archiviazione emulato:

Metodo

URI della richiesta

Versione HTTP

DELETE

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

L'URI della richiesta supporta i parametri seguenti.

Parametro

Descrizione

popreceipt

Obbligatorio. Valore di ricezione valido restituito da una chiamata precedente all'operazione Get Messages o Update Message.

timeout

Facoltativa. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostazione di timeout per le operazioni del servizio di accodamento.

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

Intestazione della richiesta

Descrizione

Authorization

Obbligatorio. Specifica lo schema di autenticazione, il nome dell'account e la firma. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date o x-ms-date

Obbligatorio. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autenticazione per i servizi di 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 Blob, di accodamento e tabelle in Windows Azure.

x-ms-client-request-id

Facoltativa. Fornisce un valore un opaco generato dal client con limite di caratteri pari a 1 KB che viene registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. L'uso di questa intestazione è fortemente consigliato per la correlazione delle attività lato client con le richieste ricevute dal server. Per ulteriori informazioni, vedere Informazioni sulla registrazione di Analisi archiviazione e la registrazione di Azure: Utilizzo dei log per tenere traccia delle richieste di archiviazione.

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

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.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; La risposta include inoltre intestazioni HTTP standard aggiuntive. 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 risolvere i problemi relativi alla richiesta. Per altre informazioni, vedere Risoluzione dei problemi relativi alle operazioni dell'API.

x-ms-version

Indica la versione del servizio di accodamento usata per eseguire la richiesta. Questa intestazione viene restituita per le richieste effettuate nella versione 2009-09-19 e successive.

Date

Valore data/ora UTC generato dal servizio che indica l'ora in cui è stata avviata la risposta.

Questa operazione può essere eseguita dal proprietario dell'account e da qualsiasi altro utente che usa una firma di accesso condiviso con l'autorizzazione di esecuzione di questa operazione.

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

Dopo aver recuperato un messaggio con l'operazione Get Messages, 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, il valore di ricezione specificato nella richiesta deve corrispondere al valore di ricezione restituito dall'operazione Get Messages o Update Message.

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

  1. Il messaggio è scaduto.

  2. Il messaggio è stato eliminato usando l'ultimo valore di ricezione ricevuto da Get Messages o Update Message.

  3. Il timeout di invisibilità è scaduto e il messaggio è stato rimosso dalla coda tramite una richiesta Get Messages. Scaduto il timeout di invisibilità, il messaggio diventa nuovamente visibile. Se viene recuperato da un'altra richiesta Get Messages, il valore di ricezione restituito può essere usato per eliminare o aggiornare il messaggio.

  4. Il messaggio è stato aggiornato con un nuovo timeout di visibilità. Se il messaggio viene aggiornato, viene restituito un nuovo valore di ricezione.

Se non viene trovato un messaggio con un valore di ricezione POP corrispondente, il servizio restituisce il codice errore 404 (Non trovato). Questo errore viene generato nei casi elencati in precedenza in cui il valore di ricezione POP non è più valido.

Mostra:
© 2016 Microsoft