Esporta (0) Stampa
Espandi tutto

Delete Queue (API REST)

Aggiornamento: luglio 2013

Tramite l'operazione Delete Queue viene eliminata in modo permanente la coda specificata.

La richiesta Delete Queue può essere costruita nel modo seguente. Si consiglia di utilizzare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione:

 

Metodo URI della richiesta Versione HTTP

DELETE

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

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

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

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

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

Nessuno.

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; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Intestazione della risposta 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

Nessuno.

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

Quando una coda viene eliminata correttamente, viene immediatamente contrassegnata per l'eliminazione e non è più disponibile ai client. La coda verrà rimossa in seguito dal servizio di accodamento durante un'operazione di Garbage Collection.

Mostra:
© 2014 Microsoft