Elenco degli account di archiviazione

 

L'operazione List Storage Accounts elenca gli account di archiviazione disponibili nella sottoscrizione specificata.

La richiesta di List Storage Accounts può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione.

MetodoURI della richiesta
GEThttps://management.core.windows.net/<subscription-id>/services/storageservices

È necessario verificare che la richiesta eseguita al servizio di gestione sia sicura. Per ulteriori dettagli, vedere l'autenticazione di richieste di gestione del servizio.

Parametri URI

Nessuna.

Intestazioni della richiesta

La tabella seguente descrive le intestazioni della richiesta.

Intestazione della richiestaDescrizione
x-ms-versionObbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su 2009-10-01 o versione successiva. Per ulteriori informazioni sulle intestazioni di controllo delle versioni, vedere il controllo delle versioni di Service Management.

Corpo della richiesta

Nessuna.

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

Codice di stato

Un'operazione completata correttamente restituisce 200 (OK).

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

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 rispostaDescrizione
x-ms-request-idValore che identifica in modo univoco una richiesta eseguita nel servizio di gestione.

Corpo della risposta

Il formato del corpo della risposta è il seguente:

  
<?xml version="1.0" encoding="utf-8"?> <StorageServices xmlns=”http://schemas.microsoft.com/windowsazure”> <StorageService> <Url>storage-service-address</Url> <ServiceName>storage-service-name</ServiceName> <StorageServiceProperties> <Description>description</Description> <AffinityGroup>affinity-group</AffinityGroup> <Location>location-of-storage-account</Location> <Label>base64-encoded-label</Label> <Status>status</Status> <Endpoints> <Endpoint>storage-service-blob-endpoint</Endpoint> <Endpoint>storage-service-queue-endpoint</Endpoint> <Endpoint>storage-service-table-endpoint</Endpoint> <Endpoint>storage-service-file-endpoint</Endpoint> </Endpoints> <GeoReplicationEnabled>geo-replication-indicator</GeoReplicationEnabled> <GeoPrimaryRegion>primary-region</GeoPrimaryRegion> <StatusOfPrimary>primary-status</StatusOfPrimary> <LastGeoFailoverTime>DateTime</LastGeoFailoverTime> <GeoSecondaryRegion>secondary-region</GeoSecondaryRegion> <StatusOfSecondary>secondary-status</StatusOfSecondary> <CreationTime>time-of-creation</CreationTime> <CustomDomains> <CustomDomain> <Name>name-of-custom-domain</Name> </CustomDomain> </CustomDomains> <SecondaryReadEnabled>secondary-read-indicator</SecondaryReadEnabled> <SecondaryEndpoints> <Endpoint>storage-secondary-service-blob-endpoint</Endpoint> <Endpoint>storage-secondary-service-queue-endpoint</Endpoint> <Endpoint>storage-secondary-service-table-endpoint</Endpoint> </SecondaryEndpoints> <AccountType>type-of-storage-account</AccountType> </StorageServiceProperties> <ExtendedProperties> <ExtendedProperty> <Name>property-name</Name> <Value>property-value</Value> </ExtendedProperty> </ExtendedProperties> </StorageService> </StorageServices>  
  

Nella tabella indicata di seguito vengono descritti gli elementi del corpo della risposta.

Nome elementoDescrizione
URLSpecifica l'URI dell'account di archiviazione.
ServiceNameSpecifica il nome dell'account di archiviazione. Corrisponde al nome del prefisso DNS e può essere usato per accedere a BLOB, code e tabelle nell'account di archiviazione.

Ad esempio, se il nome del servizio è MyStorageAccount è possibile accedere ai contenitori BLOB chiamando: http://MyStorageAccount.blob.core.windows.net/mycontainer/
StorageServicePropertiesSpecifica le proprietà dell'account di archiviazione.
ExtendedPropertiesSpecifica il nome e il valore di una proprietà estesa che è stata aggiunta all'account di archiviazione.

StorageServiceProperties

Specifica le proprietà dell'account di archiviazione.

Nome elementoDescrizione
DescrizioneFacoltativa. Descrizione dell'account di archiviazione. La descrizione può contenere un massimo di 1024 caratteri.

Il Description elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.
AffinityGroupObbligatorio se Location non viene specificato. Nome di un gruppo di affinità esistente associato alla sottoscrizione. Questo nome è un GUID e può essere recuperato tramite l'elemento del nome del corpo della una risposta restituito dall'operazione Elencare i gruppi di affinità.

Il AffinityGroup elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.
LocationObbligatorio se AffinityGroup non viene specificato. Località in cui verrà creato l'account di archiviazione.

Il Location elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.
LabelObbligatorio. Nome per il servizio ospitato con codifica Base 64. Il nome può contenere un massimo di 100 caratteri. Nome usabile per identificare l'account di archiviazione per motivi di rilevamento.

Il Label elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.
StatoStato dell'account di archiviazione. I valori possibili sono:

- Creating
- Created
- Deleting
- Deleted
- Changing
- ResolvingDns

Il Status elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.
EndpointEndpoint BLOB, tabella, coda e file.

Nota 1: l'endpoint file è in modalità anteprima e verrà restituito solo per sottoscrizioni abilitate per questa modalità.

Si noti inoltre che la nota 2: per il tipo di account Standard_ZRS, viene restituito solo l'endpoint blob. Inoltre, poiché ZRS supporta solo i BLOB in blocchi e non i BLOB di pagine, non è compatibile con le macchine virtuali IaaS.

Nota 3: per il tipo di account Premium_LRS, viene restituito solo l'endpoint BLOB.
GeoReplicationEnabledIndica se i dati dell'account di archiviazione vengono replicati in più di una posizione geografica in modo da abilitare la resilienza in caso di perdita irreversibile di servizio. Il valore è true se la replica geografica è abilitata; in caso contrario false.

L'elemento GeoReplicationEnabled è disponibile solo se si usa la versione 01.03.12 o una versione successiva e viene sostituito dall'elemento AccountType con la versione 2014-06-01 o una versione successiva.
GeoPrimaryRegionIndica l'area geografica primaria in cui è presente attualmente l'account di archiviazione.

Il GeoPrimaryRegion elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.
StatusOfPrimaryIndica se l'area di archiviazione primaria è disponibile.

I valori possibili sono:

- Available
- Unavailable

Il StatusOfPrimary elemento è disponibile solo utilizzando la versione 2013-11-01 o superiore.
LastGeoFailoverTimeTimestamp che indica l'istanza più recente di un failover nell'area secondaria. In caso di più failover vengono conservate solo la data e l'ora del failover più recente.

Il formato timestamp restituito è: [anno a 4 cifre]-[mese a 2 cifre]-[giorno a 2 cifre]T[minuti a 2 cifre]:[secondi a 2 cifre]:[7 cifre di precisione]Z

Ad esempio: < LastGeoFailoverTime > 2010-01-18T13:15:30.0000000Z < / LastGeoFailoverTime >

LastGeoFailoverTime non viene restituito se non è presente un'istanza di un failover.

Il LastGeoFailoverTime elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.
GeoSecondaryRegionIndica l'area geografica in cui viene replicato l'account di archiviazione.

L'elemento GeoSecondaryRegion non viene restituito se la replica geografica è "off" per l'account.

Il GeoSecondaryRegion elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.
StatusOfSecondaryIndica se l'area di archiviazione secondaria è disponibile.

Il StatusOfSecondary elemento è disponibile solo utilizzando la versione 2013-11-01 o superiore.

I valori possibili sono:

- Available
- Unavailable
CreationTimeSpecifica la data e l'ora di creazione dell'account di archiviazione.
CustomDomainsSpecifica i domini personalizzati associati all'account di archiviazione.

Il CustomDomains elemento è disponibile solo utilizzando la versione 2013-06-01 o superiore.
SecondaryReadEnabledIndica se è abilitata la lettura secondaria per l'account di archiviazione.

I valori possibili sono:

- true
- false

L'elemento SecondaryReadEnabled è disponibile solo se si usa la versione 2013-11-01 o una versione successiva e viene sostituito dall'elemento AccountType con la versione 2014-06-01 o una versione successiva.
SecondaryEndpointsSpecifica gli endpoint secondari dell'account di archiviazione.

Il SecondaryEndpoints elemento è disponibile solo utilizzando la versione 2013-11-01 o superiore.
AccountTypeSpecifica se l'account supporta l'archiviazione con ridondanza locale, l'archiviazione con ridondanza geografica, l'archiviazione con ridondanza della zona o l'archiviazione con ridondanza geografica e accesso in lettura.

I valori possibili sono:

- Standard_LRS
- Standard_ZRS
- Standard_GRS
- Standard_RAGRS
- Premium_LRS

L'elemento AccountType è disponibile solo se si usa la versione 2014-06-01 o una versione successiva e sostituisce gli elementi SecondaryReadEnabled e GeoReplicationEnabled.

Il Premium_LRS elemento è disponibile solo utilizzando la versione 2014-10-01 o superiore.

Endpoint

Specifica gli endpoint dell'account di archiviazione.

Nome elementoDescrizione
EndpointContiene l'endpoint del servizio Blob nel formato seguente: https://<storage-service-name>.blob.core.windows.net

Il Endpoint elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore. Con la versione 2014-04-01 o precedente vengono restituiti endpoint HTTP.
EndpointContiene l'endpoint del servizio coda nel formato seguente: https://<storage-service-name>.queue.core.windows.net

Il Endpoint elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore. Con la versione 2014-04-01 o precedente vengono restituiti endpoint HTTP.
EndpointContiene l'endpoint del servizio tabelle nel formato seguente: https://<storage-service-name>.table.core.windows.net

Il Endpoint elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore. Con la versione 2014-04-01 o precedente vengono restituiti endpoint HTTP.
EndpointContiene l'endpoint del servizio file nel formato seguente: https://<storage-service-name>.file.core.windows.net

Il Endpoint elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore. Con la versione 2014-04-01 o precedente vengono restituiti endpoint HTTP.

CustomDomains

Specifica i domini personalizzati associati all'account di archiviazione.

Nome elementoDescrizione
CustomDomainSpecifica le informazioni relative a un dominio personalizzato associato all'account di archiviazione.
NomeSpecifica il nome del dominio personalizzato.

SecondaryEndpoints

Specifica gli endpoint secondari dell'account di archiviazione.

Nome elementoDescrizione
EndpointContiene l'endpoint del servizio secondario Blob nel formato seguente: https://<storage-secondary-service-name>.blob.core.windows.net

Con la versione 2014-04-01 o precedente vengono restituiti endpoint HTTP.
EndpointContiene l'endpoint del servizio coda nel formato seguente: https://<storage-secondary-service-name>.queue.core.windows.net

Con la versione 2014-04-01 o precedente vengono restituiti endpoint HTTP.
EndpointContiene l'endpoint del servizio tabelle nel formato seguente: https://<storage-secondary-service-name>.table.core.windows.net

Con la versione 2014-04-01 o precedente vengono restituiti endpoint HTTP.

ExtendedProperties

Specifica il nome e il valore di una proprietà estesa che è stata aggiunta all'account di archiviazione.

Nome elementoDescrizione
NomeFacoltativa. Rappresenta il nome di una proprietà estesa dell'account di archiviazione. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile avere un massimo di 50 proprietà estese coppie nome/valore.

La lunghezza massima dell'elemento Name è di 64 caratteri. Nel nome sono validi solo i caratteri alfanumerici e i caratteri di sottolineatura. Il nome deve iniziare con una lettera. Se si tenta di usare altri caratteri, di immettere un elemento Name che inizia con un carattere diverso da una lettera o di specificare un nome identico a quello di un'altra proprietà estesa appartenente allo stesso account di archiviazione, si verificherà un errore con codice di stato 400 (Richiesta non valida).

Il Name elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.
ValoreFacoltativa. Rappresenta il valore di una proprietà estesa dell'account di archiviazione. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile avere un massimo di 50 coppie nome/valore per le proprietà estese e il valore di ciascuna proprietà contiene un massimo di 255 caratteri.

Il Value elemento è disponibile solo utilizzando la versione 2012-03-01 o superiore.

Se x-ms-version è 2012-03-01 o una versione successiva e il gruppo di affinità è stato creato in una delle aree deprecate Anywhere US, Anywhere Europe, Anywhere Asia, l'elemento Location restituisce la posizione in cui è allocato il servizio di affinità.

L'operazione List Storage Accounts può essere usata per ottenere gli URI da usare per altre operazioni sugli account di archiviazione, ad esempio Recupero delle proprietà dell'account di archiviazione, Ottenere le chiavi dell'account di archiviazione, Eliminare un account di archiviazione e Aggiornare l'account di archiviazione.

Il programma di esempio seguente accetta l'ID sottoscrizione, un'identificazione personale del certificato di gestione associato e la stringa di versione dell'operazione, quindi stampa l'elenco di account di archiviazione sulla console. Inizializzare le variabili msVersion, subscriptionId e thumbprint con valori personalizzati per eseguire il codice di esempio. In questo esempio viene usato x-ms-version 2011-10-01.

using System; using System.Collections.Generic; using System.Net; using System.Security.Cryptography.X509Certificates; using System.Xml; using System.Xml.Linq; class Program { static void Main(string[] args) { string msVersion = "2011-10-01"; string subscriptionId = "subscription-id-guid"; string thumbprint = "certificate-thumbprint"; try { // Obtain the certificate with the specified thumbprint X509Certificate2 certificate = GetCertificate(thumbprint); ListStorageAccountsExample(subscriptionId, certificate, msVersion); } catch (Exception ex) { Console.WriteLine("Exception caught in Main:"); Console.WriteLine(ex.Message); } } public static X509Certificate2 GetCertificate(string thumbprint) { List<StoreLocation> locations = new List<StoreLocation> { StoreLocation.CurrentUser, StoreLocation.LocalMachine }; foreach (var location in locations) { X509Store store = new X509Store("My", location); try { store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly); X509Certificate2Collection certificates = store.Certificates.Find( X509FindType.FindByThumbprint, thumbprint, false); if (certificates.Count == 1) { return certificates[0]; } } finally { store.Close(); } } throw new ArgumentException(string.Format( "A certificate with thumbprint '{0}' could not be located.", thumbprint)); } public static void ListStorageAccountsExample( string subscriptionId, X509Certificate2 certificate, string version) { string uriFormat = "https://management.core.windows.net/{0}/services/storageservices"; Uri uri = new Uri(String.Format(uriFormat, subscriptionId)); HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri); request.Method = "GET"; request.Headers.Add("x-ms-version", version); request.ClientCertificates.Add(certificate); request.ContentType = "application/xml"; XDocument responseBody = null; HttpStatusCode statusCode; HttpWebResponse response; try { response = (HttpWebResponse)request.GetResponse(); } catch (WebException ex) { // GetResponse throws a WebException for 400 and 500 status codes response = (HttpWebResponse)ex.Response; } statusCode = response.StatusCode; if (response.ContentLength > 0) { using (XmlReader reader = XmlReader.Create(response.GetResponseStream())) { responseBody = XDocument.Load(reader); } } response.Close(); if (statusCode.Equals(HttpStatusCode.OK)) { XNamespace wa = "http://schemas.microsoft.com/windowsazure"; XElement storageServices = responseBody.Element(wa + "StorageServices"); int storageCount = 0; foreach (XElement storageService in storageServices.Elements(wa + "StorageService")) { string url = storageService.Element(wa + "Url").Value; string serviceName = storageService.Element(wa + "ServiceName").Value; Console.WriteLine( "Location[{0}]{1}  Name: {2}{1}  DisplayName: {3}", storageCount++, Environment.NewLine, url, serviceName); } } else { Console.WriteLine("Call to List Storage Accounts returned an error:"); Console.WriteLine("Status Code: {0} ({1}):{2}{3}", (int)statusCode, statusCode, Environment.NewLine, responseBody.ToString(SaveOptions.OmitDuplicateNamespaces)); } return; } }  
  

Mostra: