Speicherkonten auflisten
Die List Storage Accounts
Operation Listet die Speicherkonten, die im angegebenen Abonnement verfügbar sind.
Anforderung
Die List Storage Accounts
-Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id>
durch Ihre Abonnement-ID.
Methode | Anforderungs-URI |
---|---|
GET | https://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.
Anforderungsheader | Beschreibung |
---|---|
x-ms-version |
Erforderlich. 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.
Antwort
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.
Antwortheader | Beschreibung |
---|---|
x-ms-request-id |
Ein 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=”https://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:
Elementname | Beschreibung |
---|---|
Url | Gibt den URI des Speicherkontos an. |
ServiceName | Gibt 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/ |
StorageServiceProperties | Gibt die Eigenschaften des Speicherkontos an. |
ExtendedProperties | Gibt den Namen und den Wert einer erweiterten Eigenschaft an, die dem Speicherkonto hinzugefügt wurde. |
StorageServiceProperties
Gibt die Eigenschaften des Speicherkontos an.
Elementname | Beschreibung |
---|---|
Beschreibung | Optional. 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. |
AffinityGroup | Erforderlich, 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. |
Speicherort | Erforderlich, 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. |
Label | Erforderlich. 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. |
Status | Der 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. |
Endpunkte | Blob-, 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. |
GeoReplicationEnabled | Gibt 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. |
GeoPrimaryRegion | Gibt 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. |
StatusOfPrimary | Gibt 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. |
LastGeoFailoverTime | Ein 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. |
GeoSecondaryRegion | Gibt 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. |
StatusOfSecondary | Gibt 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 |
CreationTime | Gibt die Uhrzeit an, zu der das Speicherkonto erstellt wurde. |
CustomDomains | Gibt 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. |
SecondaryReadEnabled | Gibt 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. |
SecondaryEndpoints | Gibt die sekundären Endpunkte des Speicherkontos an. Das SecondaryEndpoints -Element ist nur bei Version 2013-11-01 und höher verfügbar. |
AccountType | Gibt 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.
Elementname | Beschreibung |
---|---|
Endpunkt | Enthä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. |
Endpunkt | Enthä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. |
Endpunkt | Enthä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. |
Endpunkt | Enthä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.
Elementname | Beschreibung |
---|---|
CustomDomain | Gibt Informationen über eine benutzerdefinierte Domäne an, die dem Speicherkonto zugeordnet ist. |
Name | Gibt den Namen der benutzerdefinierten Domäne an. |
SecondaryEndpoints
Gibt die sekundären Endpunkte des Speicherkontos an.
Elementname | Beschreibung |
---|---|
Endpunkt | Enthä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. |
Endpunkt | Enthä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. |
Endpunkt | Enthä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.
Elementname | Beschreibung |
---|---|
Name | Optional. 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. |
Wert | Optional. 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. |
Hinweise
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.
Beispiel
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 = "https://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; } }