Speicherkonten auflisten

 

Die List Storage Accounts Operation Listet die Speicherkonten, die im angegebenen Abonnement verfügbar sind.

Die List Storage Accounts -Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch Ihre Abonnement-ID.

MethodeAnforderungs-URI
GEThttps://management.core.windows.net/<subscription-id>/services/storageservices

Sie müssen sicherstellen, dass die an den Verwaltungsdienst gestellte Anforderung sicher ist. Weitere Informationen finden Sie unter Authentifizieren von Dienstverwaltungsanforderungen.

URI-Parameter

Keine.

Anforderungsheader

In der folgenden Tabelle werden die Anforderungsheader beschrieben.

AnforderungsheaderBeschreibung
x-ms-versionErforderlich. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Dieser Header sollte festgelegt werden, um 2009-10-01 oder höher. Weitere Informationen zu versionsverwaltungsheadern finden Sie unter Service-Versionsverwaltung.

Anforderungstext

Keine.

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes der Dienstverwaltung.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

AntwortheaderBeschreibung
x-ms-request-idEin Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert.

Antworttext

Der Antworttext weist das folgende Format auf:

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

In der folgenden Tabelle sind die Elemente des Antworttexts beschrieben:

ElementnameBeschreibung
UrlGibt den URI des Speicherkontos an.
ServiceNameGibt den Namen des Speicherkontos an. Dieser Name ist der DNS-Präfixname und kann verwendet werden, um auf BLOBs, Warteschlangen und Tabellen im Speicherkonto zuzugreifen.

Wenn der Dienstname z. B. Meinspeicherkonto Sie könnten die Blob-Container zuzugreifen, durch Aufrufen: http://Meinspeicherkonto.blob.core.windows.net/mycontainer/
StorageServicePropertiesGibt die Eigenschaften des Speicherkontos an.
ExtendedPropertiesGibt den Namen und den Wert einer erweiterten Eigenschaft an, die dem Speicherkonto hinzugefügt wurde.

StorageServiceProperties

Gibt die Eigenschaften des Speicherkontos an.

ElementnameBeschreibung
BeschreibungOptional. Eine Beschreibung des Speicherkontos. Die Beschreibung kann bis zu 1024 Zeichen lang sein.

Das Description -Element ist nur bei Version 2012-03-01 und höher verfügbar.
AffinityGroupErforderlich, wenn Location nicht angegeben ist. Der Name einer vorhandenen Affinitätsgruppe, die diesem Abonnement zugeordnet ist. Dieser Name ist eine GUID und kann abgerufen werden, indem das Namenselement des Antworttexts zurückgegeben werden, indem die Affinitätsgruppen auflisten Vorgang.

Das AffinityGroup -Element ist nur bei Version 2012-03-01 und höher verfügbar.
SpeicherortErforderlich, wenn AffinityGroup nicht angegeben ist. Der Speicherort, an dem das Speicherkonto erstellt wird.

Das Location -Element ist nur bei Version 2012-03-01 und höher verfügbar.
LabelErforderlich. Ein Name für den gehosteten Dienst, der Base-64-codiert ist. Der Name kann bis zu 100 Zeichen lang sein. Der Name kann verwendet werden, um das Speicherkonto für die Nachverfolgung zu identifizieren.

Das Label -Element ist nur bei Version 2012-03-01 und höher verfügbar.
StatusDer Status des Speicherkontos. Folgende Werte sind möglich:

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

Das Status -Element ist nur bei Version 2012-03-01 und höher verfügbar.
EndpunkteBlob-, Tabellen-, Warteschlangen- und Dateiendpunkte.

Hinweis 1: Der Dateiendpunkt ist im Vorschaumodus und wird nur für Vorschau-fähige Abonnements zurückgegeben.

Beachten Sie auch, dass für den Kontotyp „Standard_ZRS“ nur der Blobendpunkt zurückgegeben wird. ZRS unterstützt nur Blockblobs (keine Seiten-BLOBs) und ist daher mit virtuellen IaaS-Computern nicht kompatibel.

Hinweis 3: Für den Kontotyp „Premium_LRS“ wird der Blobendpunkt zurückgegeben.
GeoReplicationEnabledGibt an, ob die Daten im Speicherkonto in mehreren geografischen Standorten repliziert werden, um im Fall von schwerwiegenden Dienstverlusten Ausfallsicherheit bereitzustellen. Der Wert ist true Wenn geografische Replikation aktiviert; andernfalls ist false.

Die GeoReplicationEnabled Element ist nur Version 2012-03-01 und höher verfügbar und ersetzt durch das AccountType-Element mit Version 2014-06-01 oder höher.
GeoPrimaryRegionGibt die primäre geografische Region an, in der das Speicherkonto derzeit vorhanden ist.

Das GeoPrimaryRegion -Element ist nur bei Version 2012-03-01 und höher verfügbar.
StatusOfPrimaryGibt an, ob die primäre Speicherregion verfügbar ist.

Folgende Werte sind möglich:

- Available
- Unavailable

Das StatusOfPrimary -Element ist nur bei Version 2013-11-01 und höher verfügbar.
LastGeoFailoverTimeEin Zeitstempel, der die letzte Instanz eines Failovers zur sekundären Region angibt. Im Fall von mehreren Failovern nur die neusten Datums- und Uhrzeitangaben des Failovers.

Das Format des zurückgegebenen Zeitstempels ist: [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitMinute]:[2DigitSecond]:[7DigitsOfPrecision]Z

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

LastGeoFailoverTime wird nicht zurückgegeben, wenn es keine Instanz eines Failovers gab.

Das LastGeoFailoverTime -Element ist nur bei Version 2012-03-01 und höher verfügbar.
GeoSecondaryRegionGibt die geografische Region an, in der das Speicherkonto repliziert wird.

Das Element „GeoSecondaryRegion“ wird nicht zurückgegeben, wenn die geografische Replikation für dieses Konto deaktiviert ist.

Das GeoSecondaryRegion -Element ist nur bei Version 2012-03-01 und höher verfügbar.
StatusOfSecondaryGibt an, ob die sekundäre Speicherregion verfügbar ist.

Das StatusOfSecondary -Element ist nur bei Version 2013-11-01 und höher verfügbar.

Folgende Werte sind möglich:

- Available
- Unavailable
CreationTimeGibt die Uhrzeit an, zu der das Speicherkonto erstellt wurde.
CustomDomainsGibt die benutzerdefinierten Domänen an, die dem Speicherkonto zugeordnet sind.

Das CustomDomains -Element ist nur bei Version 2013-06-01 und höher verfügbar.
SecondaryReadEnabledGibt an, dass sekundäres Lesen für das Speicherkonto aktiviert ist.

Folgende Werte sind möglich:

- true
- false

Die SecondaryReadEnabled Element ist nur verfügbar, die mit Version 2013-11-01 oder höher und ersetzt durch das AccountType-Element mit Version 2014-06-01 oder höher.
SecondaryEndpointsGibt die sekundären Endpunkte des Speicherkontos an.

Das SecondaryEndpoints -Element ist nur bei Version 2013-11-01 und höher verfügbar.
AccountTypeGibt an, ob das Konto lokal redundanten, georedundanten oder zonenredundanten Speicher oder georedundanten Speicher mit Lesezugriff unterstützt.

Folgende Werte sind möglich:

- Standard_LRS
- Standard_ZRS
- Standard_GRS
- Standard_RAGRS
- Premium_LRS

Das AccountType -Element ist nur bei Verwendung von Version 2014-06-01 oder höher verfügbar und ersetzt die Elemente SecondaryReadEnabled und GeoReplicationEnabled.

Das Premium_LRS -Element ist nur bei Verwendung von Version 2014-10-01 oder höher verfügbar.

Endpunkte

Gibt die Endpunkte des Speicherkontos an.

ElementnameBeschreibung
EndpunktEnthält den Blob-Dienstendpunkt im folgenden Format an: https://<storage-service-name>.blob.core.windows.net

Das Endpoint -Element ist nur bei Version 2012-03-01 und höher verfügbar. HTTP-Endpunkte werden mit Version 2014-04-01 oder einer niedrigeren Version zurückgegeben.
EndpunktEnthält den warteschlangendienstendpunkt im folgenden Format an: https://<storage-service-name>.queue.core.windows.net

Das Endpoint -Element ist nur bei Version 2012-03-01 und höher verfügbar. HTTP-Endpunkte werden mit Version 2014-04-01 oder einer niedrigeren Version zurückgegeben.
EndpunktEnthält den tabellendienstendpunkt im folgenden Format an: https://<storage-service-name>.table.core.windows.net

Das Endpoint -Element ist nur bei Version 2012-03-01 und höher verfügbar. HTTP-Endpunkte werden mit Version 2014-04-01 oder einer niedrigeren Version zurückgegeben.
EndpunktEnthält den dateidienstendpunkt im folgenden Format an: https://<storage-service-name>.file.core.windows.net

Das Endpoint -Element ist nur bei Version 2012-03-01 und höher verfügbar. HTTP-Endpunkte werden mit Version 2014-04-01 oder einer niedrigeren Version zurückgegeben.

CustomDomains

Gibt die benutzerdefinierten Domänen an, die dem Speicherkonto zugeordnet sind.

ElementnameBeschreibung
CustomDomainGibt Informationen über eine benutzerdefinierte Domäne an, die dem Speicherkonto zugeordnet ist.
NameGibt den Namen der benutzerdefinierten Domäne an.

SecondaryEndpoints

Gibt die sekundären Endpunkte des Speicherkontos an.

ElementnameBeschreibung
EndpunktEnthält den sekundären Blob-Dienstendpunkt im folgenden Format an: https://<storage-secondary-service-name>.blob.core.windows.net

HTTP-Endpunkte werden mit Version 2014-04-01 oder einer niedrigeren Version zurückgegeben.
EndpunktEnthält den warteschlangendienstendpunkt im folgenden Format an: https://<storage-secondary-service-name>.queue.core.windows.net

HTTP-Endpunkte werden mit Version 2014-04-01 oder einer niedrigeren Version zurückgegeben.
EndpunktEnthält den tabellendienstendpunkt im folgenden Format an: https://<storage-secondary-service-name>.table.core.windows.net

HTTP-Endpunkte werden mit Version 2014-04-01 oder einer niedrigeren Version zurückgegeben.

ExtendedProperties

Gibt den Namen und den Wert einer erweiterten Eigenschaft an, die dem Speicherkonto hinzugefügt wurde.

ElementnameBeschreibung
NameOptional. Stellt den Namen einer erweiterten Speicherkontoeigenschaft dar. Jede erweiterte Eigenschaft muss sowohl einen definierten Namen als auch einen definierten Wert aufweisen. Sie können über maximal 50 erweiterte Eigenschaftsnamen/Wert-Paare verfügen.

Die maximale Länge des Namenelements beträgt 64 Zeichen, nur alphanumerische Zeichen und Unterstriche im Namen sind gültig, und der Name muss mit einem Buchstaben beginnen. Der Versuch, andere Zeichen zu verwenden, den Namen mit einem anderen Zeichen als einem Buchstaben zu beginnen oder einen Namen einzugeben, der dem einer anderen erweiterten Eigenschaft desselben Speicherkontos entspricht, führt zu einem Fehler des Typs Statuscode 400 (ungültige Anforderung).

Das Name -Element ist nur bei Version 2012-03-01 und höher verfügbar.
WertOptional. Stellt den Wert einer erweiterten Speicherkontoeigenschaft dar. Jede erweiterte Eigenschaft muss sowohl einen definierten Namen als auch einen definierten Wert aufweisen. Sie können über maximal 50 erweiterte Eigenschaftsnamen/Wertpaare verfügen, und jeder erweiterte Eigenschaftswert kann eine maximale Länge von 255 Zeichen aufweisen.

Das Value -Element ist nur bei Version 2012-03-01 und höher verfügbar.

Wenn die x-ms-version 2012-03-01 oder höher und die Affinitätsgruppe in einer der veralteten erstellt wurde Anywhere US, Anywhere Europe, Anywhere Asia Regionen das Location -Element zurück, den Speicherort, in dem diese Affinitätsgruppe jetzt zugeordnet ist.

Die List Storage Accounts Operation dienen kann, erhalten die URIs für andere Vorgänge auf Speicherkonten verwenden, wie z. B. Speicherkonteneigenschaften abrufen, Speicherkontenschlüssel abrufen, Speicherkonto löschen, und Speicherkonto aktualisieren.

Das folgende Beispielprogramm nimmt die Abonnement-ID, einen zugeordneten Verwaltungszertifikat-Fingerabdruck und die Vorgangsversionszeichenfolge und gibt die Liste der Speicherkonten an der Konsole aus. Initialisieren Sie die msVersion, subscriptionId, und thumbprint Variablen mit Ihren eigenen Werten, um den Beispielcode auszuführen. Dieses Beispiel verwendet 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; } }  
  

Anzeigen: