Esporta (0) Stampa
Espandi tutto
Questo argomento non è stato ancora valutato - Valuta questo argomento

Set Queue Metadata (API REST)

Aggiornamento: settembre 2011

Tramite l'operazione Set Queue Metadata vengono impostati i metadati definiti dall'utente sulla coda specificata. I metadati vengono associati alla coda come coppie nome-valore.

La richiesta Set Queue Metadata può essere costruita nel modo seguente. Si consiglia di utilizzare HTTPS.

 

Metodo URI della richiesta Versione HTTP

PUT

https://myaccount.queue.core.windows.net/myqueue?comp=metadata

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

PUT

http://127.0.0.1:10001/devstoreaccount1/myqueue?comp=metadata

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-meta-name:string-value

Facoltativo. Coppia nome-valore da associare alla coda come metadati.

Ogni chiamata a questa operazione sostituisce tutti i metadati esistenti collegati alla coda. Per rimuovere tutti i metadati dalla coda, chiamare questa operazione senza intestazioni dei metadati.

Si noti che a partire dalla versione 2009-09-19, i nomi dei metadati devono essere conformi alle regole di denominazione per gli identificatori C#.

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.

Richiesta di esempio

Request Syntax:
PUT https://myaccount.queue.core.windows.net/myqueue?comp=metadata HTTP/1.1

Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Fri, 16 Sep 2011 01:47:14 GMT
x-ms-meta-meta-sample1: sample1
x-ms-meta-meta-sample2: sample2
Authorization: SharedKey myaccount:u6PSIebDltGW5xHpO77epRpiUhcsTkWMvcM4GTmfqqA=

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.

Per eliminare i metadati della coda, chiamare Set Queue Metadata senza specificare le intestazioni dei metadati.

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. Tutti i diritti riservati.