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

Set Container Metadata (API REST)

Aggiornamento: gennaio 2014

Tramite l'operazione Set Container Metadata vengono impostate una o più coppie nome-valore per il contenitore specificato.

La richiesta Set Container Metadata 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

PUT

https://myaccount.blob.core.windows.net/mycontainer?restype=container&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 Blob come 127.0.0.1:10000, seguiti dal nome dell'account di archiviazione emulato:

 

Metodo URI della richiesta Versione HTTP

PUT

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=metadata

HTTP/1.1

Per ulteriori informazioni, vedere About Development Storage e Differenze tra l'emulatore di archiviazione e i Servizi di archiviazione Windows Azure.

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

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

Obbligatoria per tutte le richieste autenticate. 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-lease-id: <ID>

Facoltativa, versione 2012-02-12 e successive. Se specificato, Set Container Metadata ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID. In assenza di un lease attivo o se l'ID non corrisponde, viene restituito il codice di stato 412 (Condizione preliminare non riuscita).

x-ms-meta-name:value

Facoltativa. Coppia nome-valore da associare al contenitore come metadati.

Ogni chiamata a questa operazione sostituisce tutti i metadati esistenti collegati al contenitore. Per rimuovere tutti i metadati dal contenitore, 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.

Questa operazione supporta l'utilizzo delle intestazioni condizionali per impostare i metadati del contenitore solo se viene soddisfatta una determinata condizione. Per ulteriori informazioni, vedere Specifica di intestazioni condizionali per le operazioni del servizio Blob.

Corpo della richiesta

Nessuna.

Richiesta di esempio

Request Syntax:
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=metadata HTTP/1.1

Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

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 200 (OK).

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

ETag

Valore ETag per il contenitore. Se la versione della richiesta è 2011-08-18 o successive, il valore ETag sarà racchiuso tra virgolette.

Last-Modified

Restituisce la data e l'ora dell'ultima modifica apportata al contenitore. Il formato data è conforme a RFC 1123. Per ulteriori informazioni, vedere Rappresentazione di valori di data e ora nelle intestazioni.

Qualsiasi operazione che comporta modifiche al contenitore o alle relative proprietà o metadati comporta l'aggiornamento dell'ora dell'ultima modifica, inclusa l'impostazione delle autorizzazioni del contenitore. Le operazioni sui Blob non influiscono sull'ora dell'ultima modifica del contenitore.

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

Access-Control-Allow-Origin

Restituito se la richiesta include un'intestazione Origin e la condivisione CORS è abilitata con una regola di corrispondenza. Questa intestazione restituisce il valore dell'intestazione della richiesta di origine nel caso di una corrispondenza.

Access-Control-Expose-Headers

Restituito se la richiesta include un'intestazione Origin e la condivisione CORS è abilitata con una regola di corrispondenza. Restituisce l'elenco delle intestazioni di risposta che devono essere esposte al client o all'emittente della richiesta.

Access-Control-Allow-Credentials

Restituito se la richiesta include un'intestazione Origin e la condivisione CORS è abilitata con una regola di corrispondenza che non ammette tutte le origini. Questa intestazione sarà impostata su True.

Corpo della risposta

Nessuna.

Solo il proprietario può chiamare questa operazione.

La chiamata dell'operazione Set Container Metadata comporta la sovrascrittura di tutti i metadati esistenti associati al contenitore. Non è possibile modificare una sola coppia nome-valore.

È possibile impostare i metadati per un contenitore quando viene creato.

La chiamata dell'operazione Set Container Metadata comporta l'aggiornamento del valore ETag e delle proprietà Last-Modified-Time del contenitore. Se la richiesta è stata effettuata utilizzando la versione 2011-08-18, il valore ETag sarà racchiuso tra virgolette.

Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.
Mostra:
© 2014 Microsoft. Tutti i diritti riservati.