Esporta (0) Stampa
Espandi tutto

Clear Messages (API REST)

Aggiornamento: luglio 2013

Tramite l'operazione Clear Messages vengono eliminati tutti i messaggi dalla coda specificata.

La richiesta Clear Messages può essere costruita nel modo seguente. Si consiglia di utilizzare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione e myqueue con il nome della coda:

 

Metodo URI della richiesta Versione HTTP

DELETE

https://myaccount.queue.core.windows.net/myqueue/messages

HTTP/1.1

URI del servizio di archiviazione emulato

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

HTTP/1.1

Per ulteriori informazioni, vedere About Development Storage.

Parametri URI

Nell'URI della richiesta è possibile specificare i parametri aggiuntivi seguenti.

 

Parametro Descrizione

timeout

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

Intestazioni della richiesta

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

 

Intestazione della richiesta Descrizione

Authorization

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

Date o x-ms-date

Obbligatoria. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per ulteriori informazioni, vedere Autenticazione per i servizi di archiviazione di Windows Azure.

x-ms-version

Facoltativa. Specifica la versione dell'operazione da utilizzare per questa richiesta. Per ulteriori 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 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à lato client e le richieste ricevute dal server. Per ulteriori informazioni, vedere Informazioni sulla registrazione di Analisi archiviazione e la pagina relativa all'utilizzo di log per tenere traccia delle richiesta di archiviazione nella registrazione di Windows Azure.

Corpo della richiesta

Nessuna.

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

Codice di stato

Un'operazione completata correttamente restituisce il codice di stato 204 (Nessun contenuto).

Per informazioni sui codici di stato, vedere Codici ed errori di stato.

Intestazioni della risposta

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 ulteriori 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.

Corpo della risposta

Nessuna.

Solo il proprietario dell'account può chiamare questa operazione.

Se una coda contiene un numero elevato di messaggi, è possibile che si verifichi un timeout dell'operazione Clear Messages prima che vengano eliminati tutti i messaggi. In questo caso, il servizio di accodamento restituisce il codice di stato 500 (Errore del server interno), con il codice di errore aggiuntivo OperationTimedOut. Se si verifica il timeout dell'operazione, il client deve tentare di eseguire l'operazione Clear Messages finché non ha esito positivo, per assicurarsi che tutti i messaggi vengano eliminati.

Mostra:
© 2014 Microsoft