Get Blob Service Properties
L'operazione Get Blob Service Properties
ottiene le proprietà di un account Archiviazione BLOB di Azure, incluse le proprietà per Analisi archiviazione e le regole CORS (Cross-Origin Resource Sharing).
Per informazioni dettagliate sulle regole CORS e sulla logica di valutazione, vedere Supporto CORS per i servizi di archiviazione di Azure.
Richiesta
È possibile specificare la Get Blob Service Properties
richiesta come indicato di seguito. È consigliabile usare HTTPS. 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 |
Nota
L'URI deve sempre includere una barra (/) per separare il nome host dalle parti del percorso e della query. Nel caso di questa operazione, la parte del percorso dell'URI è vuota.
Parametri URI
Parametro URI | Descrizione |
---|---|
restype=service&comp=properties |
Obbligatorio. La combinazione di entrambe le stringhe di query è necessaria per ottenere le proprietà dell'archiviazione BLOB. |
timeout |
facoltativo. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostare i timeout per le operazioni di archiviazione BLOB. |
Intestazioni della richiesta
Le intestazioni di richiesta obbligatorie e facoltative sono descritte nella tabella seguente:
Intestazione della richiesta | Descrizione |
---|---|
Authorization |
Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account di archiviazione e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure. |
Date o x-ms-date |
Obbligatorio. Specifica la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure. |
x-ms-version |
Obbligatorio per tutte le richieste autorizzate. Specifica la versione dell'operazione da usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure. |
x-ms-client-request-id |
facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log al momento della configurazione della registrazione. È consigliabile usare questa intestazione per correlare le attività lato client alle richieste ricevute dal server. Per altre informazioni, vedere Monitorare Archiviazione BLOB di Azure. |
Testo della richiesta
Nessuno.
Risposta
Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.
Codice stato
Un'operazione completata correttamente restituisce 200 (OK).
Intestazioni di 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 risposta | Descrizione |
---|---|
x-ms-request-id |
Identifica in modo univoco una richiesta effettuata sul servizio. |
x-ms-version |
Specifica la versione dell'operazione utilizzata per la risposta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure. |
x-ms-client-request-id |
Può essere usato per risolvere i problemi relativi alle richieste e alle risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id se è presente nella richiesta e il valore non contiene più di 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, questa intestazione non è presente nella risposta. |
Corpo della risposta
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-verbs</AllowedMethods>
<MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
<ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>
</CorsRule>
</Cors>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>
A partire dalla versione 2017-07-29, 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-verbs</AllowedMethods>
<MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
<ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>
</CorsRule>
</Cors>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</DeleteRetentionPolicy>
</StorageServiceProperties>
A partire dalla versione 2018-03-28, 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-verbs</AllowedMethods>
<MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
<ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>
</CorsRule>
</Cors>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</DeleteRetentionPolicy>
<StaticWebsite>
<Enabled>true|false</Enabled>
<IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
<ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
</StaticWebsite>
</StorageServiceProperties>
A partire dalla versione 2019-12-12, 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-verbs</AllowedMethods>
<MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
<ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>
</CorsRule>
</Cors>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</DeleteRetentionPolicy>
<StaticWebsite>
<Enabled>true|false</Enabled>
<IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
<DefaultIndexDocumentPath>absolute-path-of-the-default-index-page</DefaultIndexDocumentPath>
<ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
</StaticWebsite>
</StorageServiceProperties>
Nella tabella seguente vengono descritti gli elementi del corpo della risposta:
Nome dell'elemento | Descrizione |
---|---|
Logging | Raggruppa le impostazioni Logging di Azure Analytics. |
Metriche | Gruppi le impostazioni delle metriche di Analisi di Azure. Le impostazioni metriche forniscono un riepilogo delle statistiche delle richieste, raggruppate per API in aggregazioni orarie per i BLOB. |
HourMetrics | Raggruppa le impostazioni HourMetrics di Azure Analytics. Le impostazioni HourMetrics forniscono un riepilogo delle statistiche delle richieste, raggruppate per API in aggregazioni orarie per i BLOB. |
MinuteMetrics | Raggruppa le impostazioni MinuteMetrics di Azure Analytics. Le impostazioni MinuteMetrics forniscono statistiche sulle richieste per ogni minuto per i Blob. |
Versione | Versione di Analisi archiviazione in uso. |
Elimina | 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. |
Scrittura | Si applica solo alla configurazione della registrazione. Indica se le richieste di scrittura vengono registrate. |
Enabled | Indica se le metriche sono abilitate per l'archiviazione BLOB. Se la replica geograficamente ridondante con accesso in lettura è abilitata, verranno raccolte sia le metriche primarie sia secondarie. Se la replica con ridondanza geografica e accesso in lettura non è abilitata, vengono 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 un criterio di conservazione è abilitato per l'archiviazione di Azure. |
RetentionPolicy/Days | Indica il numero di giorni per cui devono essere mantenuti i dati di registrazione o di metrica. Tutti i dati precedenti a questo valore verranno eliminati. |
DefaultServiceVersion | Indica la versione predefinita da usare per le richieste di archiviazione BLOB se non è specificata la versione di una richiesta in ingresso. I valori includono la versione 2008-10-27 e versioni successive. Per altre informazioni sulle versioni applicabili, vedere Controllo delle versioni per i servizi di archiviazione di 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 delimitato da virgole di intestazioni che possono essere parte della richiesta tra origini. |
AllowedMethods | Elenco separato da virgole dei metodi HTTP che possono essere eseguiti dall'origine. Per Archiviazione di Azure, i metodi consentiti sono DELETE, GET, HEAD, MERGE, POST, OPTIONS e PUT. |
DeleteRetentionPolicy | Gruppi le impostazioni di Eliminazione di Azure. Si applica solo all'archiviazione BLOB. |
Enabled | Indica se un BLOB o uno snapshot eliminati viene mantenuto o rimosso immediatamente dall'operazione di eliminazione. |
Giorni | Indica il numero di giorni che deve essere mantenuto un BLOB eliminato. Tutti i dati precedenti a questo valore verranno eliminati definitivamente. |
StaticWebsite | Gruppi le impostazioni statiche del sito web. Si applica solo all'archiviazione BLOB. |
StaticWebsite/Enabled | Indica se il supporto staticowebsite è abilitato per l'account specificato. |
StaticWebsite/IndexDocument | La pagina Web di Archiviazione di Azure serve per le richieste alla radice di un sito Web o di qualsiasi sottocartella , ad esempio index.html . Il valore fa distinzione tra maiuscole e minuscole. |
StaticWebsite/DefaultIndexDocumentPath | Percorso assoluto di una pagina Web che Archiviazione di Azure serve per le richieste che non corrispondono a un file esistente. Il contenuto della pagina viene restituito con HTTP 200 OK (ad esempio, index.html ). L'elemento è a vicenda esclusivo con StaticWebsite/IndexDocument . Il valore fa distinzione tra maiuscole e minuscole. |
StaticWebsite/ErrorDocument404Path | Percorso assoluto di una pagina Web che Archiviazione di Azure serve per le richieste che non corrispondono a un file esistente. Il contenuto della pagina viene restituito con HTTP 404 Not Found (ad esempio, error/404.html ). Il valore fa distinzione tra maiuscole e minuscole. |
Autorizzazione
L'autorizzazione è necessaria quando si chiama qualsiasi operazione di accesso ai dati in Archiviazione di Azure. È possibile autorizzare l'operazione Get Blob Service Properties
come descritto di seguito.
Importante
Microsoft consiglia di usare Microsoft Entra ID con identità gestite per autorizzare le richieste ad Archiviazione di Azure. Microsoft Entra ID offre una maggiore sicurezza e facilità d'uso rispetto all'autorizzazione di chiave condivisa.
Archiviazione di Azure supporta l'uso di Microsoft Entra ID per autorizzare le richieste ai dati BLOB. Con Microsoft Entra ID è possibile usare il controllo degli accessi in base al ruolo di Azure per concedere le autorizzazioni a un'entità di sicurezza. L'entità di sicurezza può essere un utente, un gruppo, un'entità servizio applicazione o un'identità gestita di Azure. L'entità di sicurezza viene autenticata da Microsoft Entra ID per restituire un token OAuth 2.0. Il token può quindi essere usato per autorizzare una richiesta relativa al servizio BLOB.
Per altre informazioni sull'autorizzazione usando Microsoft Entra ID, vedere Autorizzare l'accesso ai BLOB usando Microsoft Entra ID.
Autorizzazioni
Di seguito è riportata l'azione RBAC necessaria per un utente Microsoft Entra, un gruppo, un gruppo, un'identità gestita o un'entità servizio per chiamare l'operazione Get Blob Service Properties
e il ruolo di controllo degli accessi in base al ruolo predefinito di Azure con privilegi minimi che include questa azione:
- Azione controllo degli accessi in base al ruolo di Azure:Microsoft.Storage/storageAccounts/BLOBServices/read
- Ruolo predefinito con privilegi minimi:Collaboratore dell'account di archiviazione
Per altre informazioni sull'assegnazione dei ruoli tramite controllo degli accessi in base al ruolo di Azure, vedere Assegnare un ruolo di Azure per l'accesso ai dati BLOB.
Commenti
Nessuno. Per informazioni dettagliate su come questa operazione influisce sui costi, vedere informazioni sulla fatturazione .
Fatturazione
Le richieste di prezzi possono derivare dai client che usano le API di archiviazione BLOB, direttamente tramite l'API REST dell'archiviazione BLOB o da una libreria client di Archiviazione di Azure. Queste richieste accumulano addebiti per transazione. Il tipo di transazione influisce sul modo in cui viene addebitato l'account. Ad esempio, le transazioni di lettura si accumulano in una categoria di fatturazione diversa rispetto alle transazioni di scrittura. Nella tabella seguente viene illustrata la categoria di fatturazione per Get Blob Service Properties
le richieste in base al tipo di account di archiviazione:
Operazione | Tipo di account di archiviazione | Categoria di fatturazione |
---|---|---|
Get Blob Service Properties | BLOB di blocchi Premium Utilizzo generico v2 Standard |
Altre operazioni |
Get Blob Service Properties | Utilizzo generico standard v1 | Operazioni di lettura |
Per informazioni sui prezzi per la categoria di fatturazione specificata, vedere prezzi Archiviazione BLOB di Azure.
Richiesta di esempio e risposta
L'URI di esempio seguente effettua una richiesta per ottenere le proprietà di archiviazione BLOB per un account di archiviazione fittizio denominato myaccount:
GET https://myaccount.blob.core.windows.net/?restype=service&comp=properties&timeout=30 HTTP/1.1
La richiesta viene inviata con le intestazioni seguenti:
x-ms-version: 2018-03-28
x-ms-date: Tue, 12 Sep 2018 23:38:36 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
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
x-ms-version: 2018-03-28
Date: Tue, 12 Sep 2018 23:38:35 GMT
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>2017-07-29</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true</Enabled>
<Days>5</Days>
</DeleteRetentionPolicy>
<StaticWebsite>
<Enabled>true</Enabled>
<IndexDocument>index.html</IndexDocument>
<ErrorDocument404Path>error/404.html</ErrorDocument404Path>
</StaticWebsite>
</StorageServiceProperties>
Vedi anche
Analisi archiviazione
Supporto CORS per i servizi di archiviazione di Azure
Specifiche di CORS HTT