VENDITE: 1-800-867-1389

Get Blob Service Properties

Aggiornamento: novembre 2014

Tramite l'operazione Get Blob Service Properties si ottengono le proprietà del servizio Blob di un account di archiviazione, incluse le proprietà per le regole Analisi archiviazione e CORS (Cross-Origin Resource Sharing, condivisione delle risorse multiorigine).

Per informazioni dettagliate sulle regole CORS e sulla logica di valutazione, vedere Supporto della condivisione delle risorse tra le origini (CORS) per i servizi di archiviazione Azure.

La richiesta di Get Blob Service Properties può essere specificata come indicato di seguito. HTTPS is recommended. Sostituire <account-name> con il nome dell'account di archiviazione:

 

Metodo URI richiesta Versione HTTP

GET

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 dal percorso e dalle parti di una query dell'URI. Nel caso di questa operazione, la parte del percorso dell'URI è vuota.

 

Parametro URI Descrizione

restype=service&comp=properties

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

timeout

Facoltativo. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostazione di 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 lo schema di autenticazione, il nome dell'account di archiviazione e la firma. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date oppure x-ms-date

Obbligatorio. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

x-ms-version

Obbligatoria per tutte le richieste autenticate. Specifica la versione dell'operazione da usare per questa richiesta. Per altre 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'uso di questa intestazione è consigliato per la correlazione tra le attività sul lato client e le richieste ricevute dal server. Per altre informazioni vedere Informazioni sulla registrazione di Analisi archiviazione e l'articolo relativo all'uso di log per tenere traccia delle richiesta di archiviazione nella registrazione di Azure.

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Un'operazione completata correttamente restituisce il codice di stato 200 (OK).

Per informazioni sui codici di stato, vedere Codici di stato e di errore relativi alla gestione dei servizi.

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

Valore che identifica in modo univoco una richiesta effettuata nel servizio.

x-ms-version

Specifica la versione dell'operazione utilizzata per la risposta. Per altre informazioni, vedere Controllo delle versioni per i servizi Blob, di accodamento e tabelle in Windows Azure.

Per la versione 2012-02-12 e precedenti, il formato del corpo della risposta è il seguente:

<?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>     <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </StorageServiceProperties>

A partire dalla versione 2013-08-15, il formato del corpo della risposta è il seguente:

 <?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>     <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </StorageServiceProperties> 

La seguente tabella descrive gli elementi del corpo della risposta:

 

Nome elemento Descrizione

Registrazione

Raggruppa le impostazioni dell'elemento Logging di Analisi di Azure.

Metrica

Raggruppa le impostazioni dell'elemento Metrics di Analisi di Azure. Le impostazioni dell'elemento Metrics forniscono un riepilogo delle statistiche sulle richieste raggruppate per API nelle aggregazioni orarie per i BLOB.

HourMetrics

Raggruppa le impostazioni dell'elemento HourMetrics di Analisi di Azure. Le impostazioni dell'elemento HourMetrics forniscono un riepilogo delle statistiche sulle richieste raggruppate per API nelle aggregazioni orarie per i BLOB.

MinuteMetrics

Raggruppa le impostazioni dell'elemento MinuteMetrics di Analisi di Azure. Le impostazioni dell'elemento MinuteMetrics forniscono statistiche sulle richieste per ogni minuto per i BLOB.

Version

Versione di Analisi archiviazione in uso.

Eliminazione

Si applica solo alla configurazione della registrazione. Indica se le richieste di eliminazione vengono registrate.

Lettura

Si applica solo alla configurazione della registrazione. Indica se le richieste di lettura vengono registrate.

Monitoraggio

Si applica solo alla configurazione della registrazione. Indica se le richieste di scrittura vengono registrate.

Abilitato

Indica se le metriche sono abilitate per il servizio Blob.

Se la replica geograficamente ridondante con accesso in lettura è abilitata, verranno raccolte sia le metriche primarie sia secondarie. Se la replica geograficamente ridondante con accesso in lettura non è abilitata, verranno raccolte solo le metriche primarie.

IncludeAPIs

Si applica solo alla configurazione della metrica. Indica se le metriche generano statistiche di riepilogo per le operazioni API chiamate.

RetentionPolicy/Enabled

Indica se i criteri di conservazione sono abilitati per il servizio di archiviazione.

RetentionPolicy/Days

Indica il numero di giorni per cui devono essere mantenuti i dati di registrazione o di metrica. Tutti i dati che precedono questo valore verranno eliminati.

DefaultServiceVersion

DefaultServiceVersion indica la versione predefinita da usare per le richieste al servizio BLOB se la versione di una richiesta in entrata non è stata specificata. I valori includono la versione 2008-10-27 e successive. Per altre informazioni sulle versioni applicabili, vedere Controllo delle versioni per i servizi Blob, di accodamento e tabelle in Windows Azure.

Cors

Raggruppa tutte le regole CORS.

CorsRule

Raggruppa le impostazioni per una regola CORS.

AllowedOrigins

Elenco separato da virgole dei domini di origine consentiti tramite CORS o "*" se tutti i domini sono consentiti.

ExposedHeaders

Elenco separato da virgole delle intestazioni delle risposte da esporre ai client CORS.

MaxAgeInSeconds

Numero di secondi durante i quali il client/browser deve memorizzare nella cache una risposta preliminare.

AllowedHeaders

Elenco separato da virgole delle intestazioni che possono far parte della richiesta multiorigine.

AllowedMethods

Elenco separato da virgole dei metodi HTTP che possono essere eseguiti dall'origine. Per il servizio di archiviazione di Azure, i metodi consentiti sono DELETE, GET, HEAD, MERGE, POST, OPTIONS o PUT.

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

L'URI di esempio seguente consente di effettuare una richiesta per ottenere le proprietà del servizio BLOB per l'account di archiviazione fittizio denominato myaccount:

GET 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: Wed, 23 Oct 2013 04:28:19 GMT Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE= Host: myaccount.blob.core.windows.net

Dopo l'invio della richiesta viene restituita la risposta seguente:

HTTP/1.1 200 OK Content-Length: 1020 Content-Type: application/xml Date: Wed, 23 Oct 2013 04:28:20 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 

Nella risposta è incluso il seguente corpo XML:

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

Vedere anche

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