Questa pagina è stata utile?
I suggerimenti relativi al contenuto di questa pagina sono importanti. Comunicaceli.
Altri suggerimenti?
1500 caratteri rimanenti
Esporta (0) Stampa
Espandi tutto

Delete Message

Aggiornamento: aprile 2015

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

La richiesta Delete Message può essere costruita come segue. HTTPS is recommended. 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 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 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

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 oppure 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 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

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'uso 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'uso 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 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 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 dei seguenti eventi:

  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.

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:
© 2015 Microsoft