VENDITE: 1-800-867-1389

Delete Message

Aggiornamento: settembre 2011

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

La richiesta Delete Message può essere costruita nel modo seguente. Si consiglia di utilizzare 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

Per altre informazioni, vedere About Development Storage.

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 (API REST).

timeout

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

Nella tabella seguente 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

Facoltativo. Specifica la versione dell'operazione da utilizzare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

x-ms-client-request-id

Facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 KB che viene registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. L'utilizzo di questa intestazione è consigliato per la correlazione tra le attività sul lato client e le richieste ricevute dal server. Per altre informazioni vedere Informazioni sulla registrazione di Analisi archiviazione e l'articolo relativo all'utilizzo di log per tenere traccia delle richiesta di archiviazione nella registrazione di Azure.

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 ed errori di stato.

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 utilizzata 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 utilizzata 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 utilizza 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 degli eventi seguenti:

  1. Il messaggio è scaduto.

  2. Il messaggio è stato eliminato utilizzando 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 utilizzato 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.

Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft