Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Set Blob Service Properties

 

Il Set Blob Service Properties consente di impostare le proprietà per l'endpoint del servizio Blob dell'account di archiviazione, incluse le proprietà per Analisi archiviazione e le regole CORS (Cross-Origin Resource Sharing). Vedere Cross-Origin Resource condivisione supporto (CORS) per i servizi di archiviazione di Azure Per ulteriori informazioni sulle regole CORS.

È inoltre possibile utilizzare questa operazione per impostare la versione predefinita per tutte le richieste in ingresso al servizio Blob che non è specificata una versione.

Il Set Blob Service Properties richiesta può essere specificata come indicato di seguito. È consigliato HTTPS. Sostituire <account-name> con il nome dell'account di archiviazione:

Metodo

URI della richiesta

Versione HTTP

PUT

https://<account-name>.blob.core.windows.net/?restype=service&comp=properties

HTTP/1.1

Si noti che l'URI deve sempre includere la barra (/) per separare il nome host dalle parti di percorso e query dell'URI. Nel caso di questa operazione, la parte di percorso dell'URI è vuota.

Parametro URI

Descrizione

restype=service&comp=properties

Obbligatorio. La combinazione di entrambe le stringhe di query è necessaria per impostare le proprietà del servizio di archiviazione.

timeout

Parametro facoltativo. Il timeout parametro viene espresso in secondi. Per ulteriori informazioni, vedere Impostazione dei timeout per le operazioni del servizio Blob.

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

Intestazione della richiesta

Descrizione

Authorization

Obbligatorio. Specifica di schema di autenticazione, nome account di archiviazione e firma. Per ulteriori informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date o x-ms-date

Obbligatorio. Specifica il tempo universale coordinato (UTC) per la richiesta. Per ulteriori informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

x-ms-version

Obbligatorio per tutte le richieste autenticate. Specifica la versione dell'operazione da usare per questa richiesta. Per ulteriori informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

x-ms-client-request-id

Parametro 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. Uso di questa intestazione è fortemente consigliato per correlazione delle attività lato client con le richieste ricevute dal server. Per ulteriori informazioni, vedere Informazioni sulla registrazione di analisi archiviazione e registrazione di Azure: Uso dei log per tenere traccia delle richieste di archiviazionehttp://blogs.msdn.com/b/windowsazurestorage/archive/2011/08/03/windows-azure-storage-logging-using-logs-to-track-storage-requests.aspx.

Per la versione 2012-02-12 e precedenti, il formato del corpo della richiesta è come segue:

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>version-number</Version>
        <Delete>true|false</Delete>
        <Read>true|false</Read>
        <Write>true|false</Write>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Logging>
    <Metrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Metrics>
    <!-- The DefaultServiceVersion element can only be set for the Blob service and the request must be made using version 2011-08-18 or later -->
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>

Per la versione 2013-08-15 e versioni successive, il formato del corpo della richiesta è come segue:

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>version-number</Version>
        <Delete>true|false</Delete>
        <Read>true|false</Read>
        <Write>true|false</Write>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Logging>
    <HourMetrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </HourMetrics>
    <MinuteMetrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </MinuteMetrics>
    <Cors>
        <CorsRule>
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>
            <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
            <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders>
            <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>
        </CorsRule>
    </Cors>
    <!-- The DefaultServiceVersion element can only be set for the Blob service and the request must be made using version 2011-08-18 or later -->
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>

A partire dalla versione 2013-08-15, è possibile chiamare Set Blob Service Properties con uno o più elementi radice specificati nel corpo della richiesta. Gli elementi radice includono:

  • Registrazione

  • HourMetrics

  • MinuteMetrics

  • Cors

  • DefaultServiceVersion

Non è più necessario specificare ogni elemento radice nella richiesta. Se si omette un elemento radice, vengono mantenute le impostazioni esistenti per il servizio per tale funzionalità. Tuttavia, se si specifica un determinato elemento radice, è necessario specificare ogni elemento figlio di tale elemento.

Nella tabella seguente vengono descritti gli elementi del corpo della richiesta:

Nome dell'elemento

Descrizione

Registrazione

Facoltativo a partire dalla versione 2013-08-15. Obbligatorio per le versioni precedenti. Raggruppa le analisi registrazione le impostazioni.

Metriche

Obbligatorio per la versione 2012-02-12 e precedenti. Non applicabile per la versione 2013-08-15 o versioni successive. Raggruppa le analisi metriche le impostazioni. Il metriche impostazioni forniscono un riepilogo delle statistiche sulle richieste raggruppate per API nelle aggregazioni orarie dei BLOB.

HourMetrics

Facoltativo per la versione 2013-08-15 o successiva. non applicabile per le versioni precedenti. Raggruppa le analisi HourMetrics le impostazioni. Il HourMetrics impostazioni forniscono un riepilogo delle statistiche sulle richieste raggruppate per API nelle aggregazioni orarie dei BLOB.

MinuteMetrics

Facoltativo per la versione 2013-08-15 o successiva. non applicabile per le versioni precedenti. Raggruppa le analisi MinuteMetrics le impostazioni. Il MinuteMetrics forniscono statistiche sulle richieste per ogni minuto per i BLOB. Per le versioni precedenti alla 2013-08-15, MinuteMetrics non è incluso nel corpo della risposta.

Versione

Obbligatorio se registrazione, metriche, HourMetrics, o MinuteMetrics le impostazioni vengono specificate. La versione di analisi archiviazione da configurare.

Eliminare

Obbligatorio se registrazione, metriche, HourMetrics, o MinuteMetrics le impostazioni vengono specificate. Si applica solo alla configurazione della registrazione. Indica se tutte le richieste di eliminazione devono essere registrate.

Lettura

Obbligatorio se registrazione, metriche, HourMetrics, o MinuteMetrics le impostazioni vengono specificate. Si applica solo alla configurazione della registrazione. Indica se tutte le richieste di lettura devono essere registrate.

Scrittura

Obbligatorio se registrazione, metriche, HourMetrics, o MinuteMetrics le impostazioni vengono specificate. Si applica solo alla configurazione della registrazione. Indica se scrivere tutte le richieste devono essere registrate.

Abilitato

Obbligatorio. Indica se le metriche sono abilitate per il servizio Blob.

Se è abilitata la replica con ridondanza geografica e accesso in lettura, vengono raccolte le metriche primarie e secondarie. Se la replica con ridondanza geografica e accesso in lettura non è abilitata, vengono raccolte solo le metriche primarie.

IncludeAPIs

Obbligatorio solo se le metriche sono abilitate. Si applica solo alla configurazione della metrica. Indica se la metrica deve generare le statistiche di riepilogo per le operazioni API chiamate.

RetentionPolicy/abilitato

Obbligatorio. Indica se un criterio di conservazione è abilitato per il servizio di archiviazione.

RetentionPolicy/giorni

Obbligatorio solo se è abilitato un criterio di conservazione. Indica il numero di giorni che devono essere mantenuti i dati di registrazione o di metrica. Verranno eliminati tutti i dati meno recenti rispetto a questo valore. Il valore minimo è possibile specificare è 1; il valore massimo è 365 (un anno).

DefaultServiceVersion

Parametro facoltativo. Per impostare DefaultServiceVersion, è necessario chiamare Set Blob Service Properties utilizzando versione 2011-08-18 o versioni successive.DefaultServiceVersion indica la versione predefinita da utilizzare per le richieste al servizio Blob se non viene specificata la versione della richiesta in ingresso. I valori possibili includono la versione 2008-10-27 e tutte le versioni successive. Per ulteriori informazioni sulle versioni applicabili, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

Si applica solo al servizio Blob.

Cors

Parametro facoltativo. Il Cors elemento è supportato per la versione 2013-08-15 o versioni successive. Raggruppa tutte le regole CORS.

L'omissione di questo gruppo di elementi non sovrascrivono le impostazioni CORS esistenti.

CorsRule

Parametro facoltativo. Specifica una regola CORS per il servizio Blob. È possibile includere fino a cinque CorsRule nella richiesta. Se non CorsRule gli elementi vengono inclusi nel corpo della richiesta, tutte le regole CORS verranno eliminate e CORS verrà disabilitato per il servizio Blob.

AllowedOrigins

Obbligatorio se CorsRule elemento è presente. Un elenco delimitato da virgole dei domini di origine consentiti tramite CORS o "*" per consentire tutti i domini. Limitato a 64 domini di origine. Ogni origine consentita può contenere fino a 256 caratteri.

ExposedHeaders

Obbligatorio se CorsRule elemento è presente. Un elenco delimitato da virgole delle intestazioni di risposta per esporre ai client CORS. Limitato a 64 intestazioni definite e due intestazioni con prefisso. Ogni intestazione può contenere fino a 256 caratteri.

MaxAgeInSeconds

Obbligatorio se CorsRule elemento è presente. Il numero di secondi che il client/browser deve memorizzare nella cache una risposta preliminare.

AllowedHeaders

Obbligatorio se CorsRule elemento esiste. Un elenco delimitato da virgole delle intestazioni che possono far parte della richiesta multiorigine. Limitato a 64 intestazioni definite e 2 intestazioni con prefisso. Ogni intestazione può contenere fino a 256 caratteri.

AllowedMethods

Obbligatorio se CorsRule elemento esiste. Un elenco delimitato da virgole di metodi HTTP che possono essere eseguiti dall'origine. Per l'archiviazione di Azure, i metodi consentiti sono DELETE, GET, HEAD, MERGE, POST, opzioni o PUT.

La risposta include un codice di stato HTTP e un set di intestazioni di risposta.

Un'operazione completata correttamente restituisce il codice di stato 202 (accettato).

Per informazioni sui codici di stato, vedere stato di gestione del servizio e codici di errore.

La risposta per questa operazione include le intestazioni seguenti. La risposta può inoltre includere intestazioni HTTP standard aggiuntive. Rispettare tutte le intestazioni standard di specifica del protocollo HTTP/1.1http://go.microsoft.com/fwlink/?linkid=150478.

Intestazione della risposta

Descrizione

x-ms-request-id

Un valore che identifica in modo univoco una richiesta effettuata nel servizio.

x-ms-version

Specifica la versione dell'operazione utilizzata per la risposta. Per ulteriori informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

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

Le restrizioni e le limitazioni seguenti si applicano alle regole CORS in archiviazione di Azure:

  • È possibile archiviare un massimo di cinque regole.

  • La dimensione massima di tutte le impostazioni delle regole CORS nella richiesta, esclusi i tag XML, non deve superare 2 KB.

  • La lunghezza di un'intestazione consentita, intestazione esposta o origine consentita non deve superare i 256 caratteri.

  • Intestazioni consentite e quelle esposte possono essere:

    • Intestazioni letterali, dove il nome esatto dell'intestazione viene fornito, ad esempio x-ms-meta-processed. Un massimo di 64 intestazioni letterali può essere specificato nella richiesta.

    • Intestazioni con prefisso, in cui un prefisso dell'intestazione viene fornito, ad esempio x-ms-meta-data *. Specificando un prefisso in questo modo consente o si espone qualsiasi intestazione che inizi con il prefisso specificato. Un massimo di due intestazioni con prefisso può essere specificato nella richiesta.

  • Metodi (o verbi HTTP) specificato nella AllowedMethods devono essere conformi ai metodi supportati dalle API del Servizio archiviazione di Azure. Metodi supportati sono DELETE, GET, HEAD, MERGE, POST, opzioni e PUT.

Specifica le regole CORS nella richiesta è facoltativa. Se si chiama Set Blob Service Properties senza specificare il Cors elemento nel corpo della richiesta, eventuali regole CORS esistenti vengono mantenute.

Per disabilitare CORS, chiamare Set Blob Service Properties con un CORS vuote le impostazioni delle regole (ovvero</Cors>) e nessuna regola CORS interna. Questa chiamata si eliminano tutte le regole esistenti, disabilita CORS per il servizio Blob.

Tutti gli elementi delle regole CORS sono necessari se il CorsRule viene specificato alcun elemento. La richiesta avrà esito negativo con codice errore 400 (Bad Request) se qualsiasi elemento è mancante.

A partire dalla versione 2013-08-15, gli elementi di impostazioni XML verranno sono facoltativi, pertanto l'aggiornamento di un elemento specifico può essere effettuata mediante l'invio di un XML che contiene solo l'elemento aggiornato e altre impostazioni non saranno interessate.

Per informazioni dettagliate sulle regole CORS e logica di valutazione, vedere Cross-Origin Resource condivisione supporto (CORS) per i servizi di archiviazione di Azure.

Nell'esempio seguente URI effettua una richiesta per modificare le proprietà del servizio Blob per l'account di archiviazione fittizio denominato myaccount:

PUT https://myaccount.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

La richiesta viene inviata con le intestazioni seguenti:

x-ms-version: 2013-08-15
x-ms-date: Mon, 21 Oct 2013 04:28:19 GMT
Authorization: SharedKey
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.blob.core.windows.net

La richiesta viene inviata con il corpo XML seguente:

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>1.0</Version>
        <Delete>true</Delete>
        <Read>false</Read>
        <Write>true</Write>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </Logging>
    <HourMetrics>
        <Version>1.0</Version>
        <Enabled>true</Enabled>
        <IncludeAPIs>false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </HourMetrics>
    <MinuteMetrics>
        <Version>1.0</Version>
        <Enabled>true</Enabled>
        <IncludeAPIs>true</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </MinuteMetrics>
    <Cors>
        <CorsRule>
            <AllowedOrigins>http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>
            <AllowedMethods>GET,PUT</AllowedMethods>
            <MaxAgeInSeconds>500</MaxAgeInSeconds>
            <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>
            <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>
        </CorsRule>
    </Cors>
    <DefaultServiceVersion>2013-08-15</DefaultServiceVersion>
</StorageServiceProperties>

Dopo aver inviata la richiesta, viene restituita la seguente risposta:

HTTP/1.1 202 Accepted
Connection: Keep-Alive
Transfer-Encoding: chunked
Date: Mon, 21 Oct 2013 04:28:21 GMT
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
x-ms-version: 2013-08-15

Mostra: