Speicherkonteneigenschaften abrufen

 

Die Get Storage Account Properties Operation gibt die Systemeigenschaften für das angegebene Speicherkonto zurück.

Anforderung

Die Get Storage Account Properties -Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch Ihre Abonnement-ID und <storage-account-name> mit dem Namen des Speicherkontos.

Methode	Anforderungs-URI
GET	https://management.core.windows.net/<subscription-id>/services/storageservices/<storage-account-name>

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"?> <StorageService xmlns="https://schemas.microsoft.com/windowsazure"> <Url>storage-account-request-uri</Url> <ServiceName>storage-account-name</ServiceName> <StorageServiceProperties> <Description>description</Description> <AffinityGroup>affinity-group</AffinityGroup> <Location>location</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> <Capabilities> <Capability>storage-account-capability</Capability> </Capabilities> </StorageService>  
  

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.
Funktion	Gibt an, ob das Speicherkonto mit dem virtuellen Computer verbundene Operationen ausführen kann. Wenn dies der Fall ist, gibt dieses Element eine Zeichenfolge zurück, die PersistentVMRole enthält. Andernfalls ist dieses Element nicht vorhanden. Das Capability -Element ist nur bei Version 2012-03-01 und höher verfügbar.

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. Hinweis 2: Für den Kontotyp „Standard_ZRS“ wird nur der Blobendpunkt zurückgegeben. 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. Folgende Werte sind möglich: - Available - Unavailable Das StatusOfSecondary -Element ist nur bei Version 2013-11-01 und höher verfügbar.
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

Die geografische Replikation kann aktiviert werden, wenn Sie ein Speicherkonto erstellen oder aktualisieren.

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 zugeordnet ist.

Beispiel

Im folgenden Beispielprogramm werden die Abonnement-ID, ein zugeordneter Verwaltungszertifikatfingerabdruck, die Versionszeichenfolge des Vorgangs und ein Speicherkontoname verwendet und die zurückgegebenen Speicherkontoeigenschaften auf der Konsole ausgegeben. Initialisieren Sie die msVersion, subscriptionId, thumbprint und serviceName Variablen mit Ihren eigenen Werten, um den Beispielcode auszuführen.

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-12-01"; string subscriptionId = "subscription-id-guid"; string thumbprint = "certificate-thumbprint"; string serviceName = "myexamplestorage1"; try { // Obtain the certificate with the specified thumbprint X509Certificate2 certificate = GetCertificate(thumbprint); GetStorageAccountPropertiesExample( subscriptionId, certificate, msVersion, serviceName); } 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 GetStorageAccountPropertiesExample( string subscriptionId, X509Certificate2 certificate, string version, string serviceName) { string uriFormat = "https://management.core.windows.net/{0}/services/storageservices/{1}"; Uri uri = new Uri(String.Format(uriFormat, subscriptionId, serviceName)); 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 storageService = responseBody.Element(wa + "StorageService"); Console.WriteLine( "Storage Account Properties for {0}:{1}{2}", serviceName, Environment.NewLine, storageService.ToString(SaveOptions.OmitDuplicateNamespaces)); } else { Console.WriteLine("Call to GetStorageAccountProperties returned an error:"); Console.WriteLine("Status Code: {0} ({1}):{2}{3}", (int)statusCode, statusCode, Environment.NewLine, responseBody.ToString(SaveOptions.OmitDuplicateNamespaces)); } return; } }