Indirizzamento delle risorse del servizio code

  • Articolo

Il servizio di accodamento espone le seguenti risorse attraverso l'API REST:

  • Account. L'account di archiviazione è un'entità identificata in modo univoco all'interno del sistema di archiviazione. L'account è lo spazio dei nomi padre per il servizio di accodamento. Tutte le code sono associate a un account.

  • Coda. In una coda vengono archiviati i messaggi che possono essere recuperati da un servizio o un'applicazione client.

  • Messaggi. I messaggi sono formati da testo con codifica UTF-8 che può essere il valore di un elemento XML. Un messaggio può essere di dimensioni pari a 64 KiB.

Sintassi dell'URI della risorsa

Ogni risorsa ha un URI di base corrispondente, che fa riferimento alla risorsa stessa.

Per l'account di archiviazione, l'URI di base per le operazioni di coda include solo il nome dell'account:

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

Per una coda, l'URI di base include il nome dell'account e il nome della coda:

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

Per i messaggi in una coda, l'URI di base include il nome dell'account, il nome della coda e il set di messaggi nella coda:

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

Un singolo messaggio può essere aggiornato o eliminato facendo riferimento all'ID messaggio. Si noti che questa sintassi è disponibile solo per l'operazione Update Message and Delete Message e richiede un popreceipt parametro per la verifica:

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

Ogni risorsa può anche includere componenti, espressi come parte della stringa di query nell'URI di base. La sintassi della stringa di query è ?comp=<component_name>. I componenti delle risorse elencati di seguito sono attualmente disponibili per le risorse della coda, come parametri nell'URI.

Componente Risorse supportate Descrizione
list Account Enumera le entità della risorsa. Nell'account, restituisce l'elenco delle code.
metadata Coda Imposta o restituisce le proprietà della coda, inclusi i metadati definiti dall'utente.

Si noti che tutti i valori per i parametri di query devono presentare la codifica URL prima di essere inviati ai servizi di archiviazione di Azure.

Operazioni HTTP supportate

Ogni risorsa supporta operazioni basate sui verbi HTTP GET, PUT, HEAD e DELETE. Il verbo, la sintassi e la versione o le versioni HTTP supportate per ogni operazione vengono visualizzati nella pagina di riferimento per ogni operazione. Per un elenco completo delle pagine di riferimento dell'operazione, vedere API REST del servizio code.

Vedi anche

Denominazione di code e metadati
Operazioni nelle code
Operazioni nei messaggi
API REST del servizio di accodamento