(0) exportieren Drucken
Alle erweitern

Speicherkonten auflisten

Letzte Aktualisierung: Oktober 2014

Durch den Vorgang List Storage Accounts werden die Speicherkonten aufgeführt, 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.

 

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. Zusätzliche Informationen finden Sie im Thema Authentifizieren von Dienstverwaltungsanforderungen.

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 auf 01.10.2009 oder höher festgelegt werden. Weitere Informationen zu den Versionsangaben in den Headern finden Sie unter Dienstverwaltungs-Versionsverwaltung.

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

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

Weitere Informationen zu Statuscodes finden Sie unter Dienstverwaltungsstatus und Fehlercodes.

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.

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:

 

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. MyStorageAccount lautet, können Sie auf die BLOB-Container zugreifen, indem Sie Folgendes aufrufen: http://MyStorageAccount.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.

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 01.03.2012 und höher verfügbar.

AffinityGroup

Erforderlich, wenn Location nicht angegeben wird. Der Name einer vorhandenen Affinitätsgruppe, die diesem Abonnement zugeordnet ist. Dieser Name ist ein GUID und kann abgerufen werden, indem das Namenselement des Antworttexts überprüft wird, der durch den Auflisten von Affinitätsgruppen-Vorgang zurückgegeben wird.

Das AffinityGroup-Element ist nur bei Version 01.03.2012 und höher verfügbar.

Speicherort

Erforderlich, wenn AffinityGroup nicht angegeben wird. Der Speicherort, an dem das Speicherkonto erstellt wird.

Das Location-Element ist nur bei Version 01.03.2012 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 01.03.2012 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 01.03.2012 und höher verfügbar.

Endpoints

Gibt die Endpunkte des Speicherkontos an.

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 die geografische Replikation aktiviert ist; andernfalls false.

Das GeoReplicationEnabled-Element ist nur in Version 01.03.2012 und höher verfügbar und wird ab Version 01.06.2014 oder höher durch das AccountType-Element ersetzt.

GeoPrimaryRegion

Gibt die primäre geografische Region an, in der das Speicherkonto derzeit vorhanden ist.

Das GeoPrimaryRegion-Element ist nur bei Version 01.03.2012 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 01.11.2013 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.

Der zurückgegebene Zeitstempel weist das folgende Format auf: [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 01.03.2012 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 01.03.2012 und höher verfügbar.

StatusOfSecondary

Gibt an, ob die sekundäre Speicherregion verfügbar ist.

Das StatusOfSecondary-Element ist nur bei Version 01.11.2013 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 01.06.2013 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

Das SecondaryReadEnabled-Element ist nur in Version 01.11.2013 und höher verfügbar und wird ab Version 01.06.2014 oder höher durch das AccountType-Element ersetzt.

SecondaryEndpoints

Gibt die sekundären Endpunkte des Speicherkontos an.

Das SecondaryEndpoints-Element ist nur bei Version 01.11.2013 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

Das AccountType-Element ist nur unter Verwendung von Version 01.06.2014 oder höher verfügbar und ersetzt die Elemente SecondaryReadEnabled und GeoReplicationEnabled.

Gibt die Endpunkte des Speicherkontos an.

 

Elementname Beschreibung

Endpunkt

Enthält den BLOB-Dienstendpunkt im folgenden Format: https://<storage-service-name>.blob.core.windows.net

Das Endpoint-Element ist nur bei Version 01.03.2012 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: https://<storage-service-name>.queue.core.windows.net

Das Endpoint-Element ist nur bei Version 01.03.2012 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: https://<storage-service-name>.table.core.windows.net

Das Endpoint-Element ist nur bei Version 01.03.2012 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: https://<storage-service-name>.file.core.windows.net

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

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.

Gibt die sekundären Endpunkte des Speicherkontos an.

 

Elementname Beschreibung

Endpunkt

Enthält den sekundären BLOB-Dienstendpunkt im folgenden Format: 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: 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: https://<storage-secondary-service-name>.table.core.windows.net

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

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 01.03.2012 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 01.03.2012 und höher verfügbar.

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

Der List Storage Accounts-Vorgang kann verwendet werden, um die für andere Vorgänge auf Speicherkonten zu verwendenden URIs abzurufen, zum Beispiel 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 Variablen msVersion, subscriptionId und thumbprint mit Ihren eigenen Werten, um den Beispielcode auszuführen. In diesem Beispiel wird x-ms-version 2011-10-01 verwendet.

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:
© 2014 Microsoft