Ottenere informazioni sull'account

L'operazione Get Account Information restituisce il nome dello SKU e il tipo di account per l'account specificato. È disponibile nella versione 2018-03-28 e successive del servizio.

Richiesta

È possibile costruire la Get Account Information richiesta usando una richiesta valida autorizzata tramite l'autorizzazione di firma di accesso condiviso o chiave condivisa.

Se si aggiunge un restype valore e account un comp valore di properties, la richiesta userà l'operazione Get Account Information . La tabella seguente mostra esempi:

Metodo	URI richiesta	Versione HTTP
GET/HEAD	https://myaccount.blob.core.windows.net/?restype=account&comp=properties	HTTP/1.1
GET/HEAD	https://myaccount.blob.core.windows.net/?restype=account&comp=properties&sv=myvalidsastoken	HTTP/1.1
GET/HEAD	https://myaccount.blob.core.windows.net/mycontainer/?restype=account&comp=properties&sv=myvalidsastoken	HTTP/1.1
GET/HEAD	https://myaccount.blob.core.windows.net/mycontainer/myblob?restype=account&comp=properties&sv=myvalidsastoken	HTTP/1.1

Parametri URI

Nell'URI della richiesta puoi specificare i parametri seguenti:

Parametro	Descrizione
restype	Obbligatorio. Il valore del restype parametro deve essere account.
comp	Obbligatorio. Il valore del comp parametro deve essere properties.

Intestazioni della richiesta

La tabella seguente descrive le intestazioni di richiesta obbligatorie e facoltative:

Intestazione della richiesta	Descrizione
Authorization	Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
Date or 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 questa operazione, la versione deve essere 2018-03-28 o successiva. 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.

Testo della richiesta

Nessuno.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codice stato

Un'operazione completata correttamente restituisce 200 (OK).

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni di risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; La risposta potrebbe includere anche 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 la richiesta effettuata. È possibile usarlo per risolvere i problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni api.
x-ms-version	Versione 2009-09-19 e successive. Indica la versione di Archiviazione BLOB di Azure usata per eseguire la richiesta.
Date	Valore di data/ora UTC che indica l'ora in cui il servizio ha inviato la risposta.
Content-Length	Specifica la lunghezza del corpo della richiesta. Per questa operazione, la lunghezza del contenuto sarà sempre zero.
x-ms-sku-name	Identifica il nome SKU dell'account specificato.
x-ms-account-kind	Identifica il tipo di account specificato. I valori possibili sono Storage, BlobStoragee StorageV2. L'intestazione distingue tra gli account di archiviazione per utilizzo generico v1 (GPv1) e per utilizzo generico v2 (GPv2) usando la sottostringa V2 per gli account per utilizzo generico v2.
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 è al massimo 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, questa intestazione non sarà presente nella risposta.
x-ms-is-hns-enabled	Versione 2019-07-07 e successive. Indica se l'account dispone di uno spazio dei nomi gerarchico abilitato.

Corpo della risposta

Nessuno.

Risposta di esempio

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Date: Sat, 28 Mar 2018 12:43:08 GMT  
x-ms-version: 2018-03-28  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0  
x-ms-sku-name: Standard_LRS  
x-ms-account-kind: StorageV2  

Autorizzazione

L'autorizzazione è necessaria quando si chiama un'operazione di accesso ai dati in Archiviazione di Azure. È possibile autorizzare l'operazione Get Account Information come descritto di seguito.

Questa operazione non supporta l'autorizzazione basata su OAuth tramite un token di accesso da Azure Active Directory/MSI o una firma di accesso condiviso della delega utente.

Firme di accesso condiviso (SAS)

Una firma di accesso condiviso fornisce accesso delegato sicuro alle risorse in un account di archiviazione. Con una firma di accesso condiviso è possibile controllare in modo granulare il modo in cui un client può accedere ai dati. È possibile specificare la risorsa a cui il client può accedere, le autorizzazioni necessarie per tali risorse e il periodo di validità della firma di accesso condiviso.

L'operazione Get Account Information supporta l'autorizzazione usando una firma di accesso condiviso dell'account o una firma di accesso condiviso del servizio con almeno un'autorizzazione disponibile.

Firma di accesso condiviso dell'account

Una firma di accesso condiviso dell'account è protetta con la chiave dell'account di archiviazione. Una firma di accesso condiviso dell'account delega l'accesso alle risorse in uno o più servizi di archiviazione. Tutte le operazioni disponibili tramite una firma di accesso condiviso del servizio o di delega utente sono disponibili anche tramite una firma di accesso condiviso dell'account.

Per altre informazioni sulla firma di accesso condiviso dell'account, vedere Creare una firma di accesso condiviso dell'account.

Firma di accesso condiviso del servizio

Una firma di accesso condiviso del servizio è protetta con la chiave dell'account di archiviazione. Una firma di accesso condiviso del servizio delega l'accesso a una risorsa in un singolo servizio di archiviazione di Azure, ad esempio l'archiviazione BLOB.

Quando l'accesso con chiave condivisa non è consentito per l'account di archiviazione, non sarà consentito un token di firma di accesso condiviso del servizio in una richiesta di archiviazione BLOB. Per altre informazioni, vedere Informazioni su come impedire la chiave condivisa influisce sui token di firma di accesso condiviso.

Per altre informazioni sulla firma di accesso condiviso del servizio, vedere Creare una firma di accesso condiviso del servizio.

Chiave condivisa

L'operazione Get Account Information supporta l'autorizzazione con chiave condivisa. L'autorizzazione con le chiavi dell'account non è consigliata per la maggior parte degli scenari, perché è meno sicura. Microsoft consiglia di non consentire l'autorizzazione di chiave condivisa per l'account di archiviazione quando possibile. Per altre informazioni, vedere Impedire l'autorizzazione con chiave condivisa.

Commenti

Il percorso URL della richiesta non influisce sulle informazioni fornite da questa operazione. Lo scopo è consentire alla richiesta di autorizzare correttamente con un token di firma di accesso condiviso che specifica la risorsa consentita.

La risorsa specificata non deve esistere perché l'operazione abbia esito positivo. Ad esempio, un token di firma di accesso condiviso generato con un BLOB inesistente e le autorizzazioni valide avranno esito positivo con un percorso URL che include il nome dell'account corretto, il nome del contenitore corretto e il nome del BLOB inesistente.

Fatturazione

Le richieste di determinazione dei prezzi possono provenire dai client che usano le API di archiviazione BLOB, direttamente tramite l'API REST di 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. La tabella seguente illustra la categoria di fatturazione per Get Account Information le richieste in base al tipo di account di archiviazione:

Operazione	Tipo di account di archiviazione	Categoria di fatturazione
Ottenere informazioni sull'account	BLOB in blocchi Premium Utilizzo generico v2 Standard	Altre operazioni
Ottenere informazioni sull'account	Standard per utilizzo generico v1	Operazioni di lettura

Per informazioni sui prezzi per la categoria di fatturazione specificata, vedere prezzi Archiviazione BLOB di Azure.