Kontoinformationen abrufen

Der vorgang Get Account Information gibt den SKU-Namen und die Kontoart für das angegebene Konto zurück. Es ist in Version 2018-03-28 und höheren Versionen des Diensts verfügbar.

Bitten

Sie können die Get Account Information Anforderung erstellen, indem Sie eine gültige Anforderung verwenden, die über die Freigabeschlüssel- oder SAS-Autorisierung (Shared Access Signature) autorisiert ist.

Wenn Sie einen restype Wert von account und einen comp Wert von propertieshinzufügen, verwendet die Anforderung den Get Account Information Vorgang. Die folgende Tabelle zeigt Beispiele:

Methode	Anforderungs-URI	HTTP-Version
GET/HEAD	https://myaccount.blob.core.windows.net/?restype=account&comp=properties	HTTP/1.1
GET/HEAD	https://myaccount.blob.core.windows.net/?restype=account&comp=properties&sv=myvalidsastoken	HTTP/1.1
GET/HEAD	https://myaccount.blob.core.windows.net/mycontainer/?restype=account&comp=properties&sv=myvalidsastoken	HTTP/1.1
GET/HEAD	https://myaccount.blob.core.windows.net/mycontainer/myblob?restype=account&comp=properties&sv=myvalidsastoken	HTTP/1.1

URI-Parameter

Sie können die folgenden zusätzlichen Parameter für den Anforderungs-URI angeben:

Parameter	Beschreibung
restype	Erforderlich. Der Wert des restype Parameters muss accountwerden.
comp	Erforderlich. Der Wert des comp Parameters muss propertieswerden.

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben:

Anforderungsheader	Beschreibung
Authorization	Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
Date or x-ms-date	Erforderlich. Gibt die koordinierte Weltzeit (UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
x-ms-version	Erforderlich für alle autorisierten Anforderungen. Gibt die Version des Vorgangs an, der für diese Anforderung verwendet werden soll. Für diesen Vorgang muss die Version 2018-03-28 oder höher sein. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure Storage-Dienste.
x-ms-client-request-id	Wahlfrei. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (KiB) bereit, der in den Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt.

Anforderungstext

Nichts.

Antwort

Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 200 (OK) zurück.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang enthält die folgenden Header. Die Antwort kann auch zusätzliche Standard-HTTP-Header enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortheader	Beschreibung
x-ms-request-id	Identifiziert eindeutig die Anforderung, die durchgeführt wurde. Sie können es verwenden, um die Anforderung zu beheben. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.
x-ms-version	Version 2009-09-19 und höher. Gibt die Version von Azure Blob Storage an, die zum Ausführen der Anforderung verwendet wird.
Date	Ein UTC-Datums-/Uhrzeitwert, der die Uhrzeit angibt, zu der der Dienst die Antwort gesendet hat.
Content-Length	Gibt die Länge des Anforderungstexts an. Für diesen Vorgang ist die Inhaltslänge immer null.
x-ms-sku-name	Gibt den SKU-Namen des angegebenen Kontos an.
x-ms-account-kind	Gibt die Kontoart des angegebenen Kontos an. Die möglichen Werte sind Storage, BlobStorageund StorageV2. Der Header unterscheidet zwischen General Purpose v1 (GPv1) und General Purpose v2 (GPv2)-Speicherkonten mithilfe der Teilzeichenfolge V2 für GPv2-Konten.
x-ms-client-request-id	Kann verwendet werden, um Anfragen und entsprechende Antworten zu behandeln. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert höchstens 1.024 sichtbare ASCII-Zeichen aufweist. Wenn der x-ms-client-request-id-Header in der Anforderung nicht vorhanden ist, ist dieser Header in der Antwort nicht vorhanden.
x-ms-is-hns-enabled	Version 2019-07-07 und höher. Gibt an, ob das Konto einen hierarchischen Namespace aktiviert hat.

Antworttext

Nichts.

Beispielantwort

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Date: Sat, 28 Mar 2018 12:43:08 GMT  
x-ms-version: 2018-03-28  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0  
x-ms-sku-name: Standard_LRS  
x-ms-account-kind: StorageV2  

Ermächtigung

Die Autorisierung ist beim Aufrufen eines Datenzugriffsvorgangs in Azure Storage erforderlich. Sie können den Get Account Information Vorgang wie unten beschrieben autorisieren.

Wichtig

Microsoft empfiehlt die Verwendung der Microsoft Entra-ID mit verwalteten Identitäten, um Anforderungen an Azure Storage zu autorisieren. Die Microsoft Entra-ID bietet eine bessere Sicherheit und Benutzerfreundlichkeit im Vergleich zur Shared Key-Autorisierung.

Microsoft Entra ID (empfohlen)

Azure Storage unterstützt die Verwendung der Microsoft Entra-ID zum Autorisieren von Anforderungen an BLOB-Daten. Mit Der Microsoft Entra-ID können Sie azure role-based access control (Azure RBAC) verwenden, um Berechtigungen für einen Sicherheitsprinzipal zu erteilen. Der Sicherheitsprinzipal kann ein Benutzer, eine Gruppe, ein Anwendungsdienstprinzipal oder eine von Azure verwaltete Identität sein. Der Sicherheitsprinzipal wird von der Microsoft Entra-ID authentifiziert, um ein OAuth 2.0-Token zurückzugeben. Das Token kann dann verwendet werden, um eine Anforderung für den Blob-Dienst zu autorisieren.

Weitere Informationen zur Autorisierung mithilfe der Microsoft Entra-ID finden Sie unter Autorisieren des Zugriffs auf Blobs mithilfe von Microsoft Entra ID.

Erlaubnisse

Nachfolgend finden Sie die RBAC-Aktion, die für einen Microsoft Entra-Benutzer, eine Gruppe, eine verwaltete Identität oder einen Dienstprinzipal erforderlich ist, um den Get Account Information Vorgang aufzurufen:

• Azure RBAC-Aktion:Microsoft.Storage/storageAccounts/blobServices/getInfo/action

Diese RBAC-Aktion ist in der Rolle "Besitzer" enthalten, oder Sie können diese Aktion einer benutzerdefinierten Rolle zuweisen.

Weitere Informationen zum Zuweisen von Rollen mithilfe von Azure RBAC finden Sie unter Zuweisen einer Azure-Rolle für den Zugriff auf BLOB-Daten.

Freigegebene Zugriffssignaturen (SAS)

Eine freigegebene Zugriffssignatur (SHARED Access Signature, SAS) bietet sicheren delegierten Zugriff auf Ressourcen in einem Speicherkonto. Mit einer SAS haben Sie präzise Kontrolle darüber, wie ein Client auf Daten zugreifen kann. Sie können angeben, auf welche Ressource der Client zugreifen kann, auf welche Berechtigungen sie für diese Ressourcen verfügen und wie lange die SAS gültig ist.

Der Get Account Information-Vorgang unterstützt die Autorisierung mithilfe eines Kontos SAS.

Konto SAS

Ein Konto-SAS ist mit dem Speicherkontoschlüssel gesichert. Ein Konto SAS delegiert den Zugriff auf Ressourcen in einem oder mehreren Speicherdiensten. Alle vorgänge, die über einen Dienst oder eine Benutzerdelegierung SAS verfügbar sind, stehen auch über ein Konto SAS zur Verfügung.

Weitere Informationen zum SAS-Konto finden Sie unter Erstellen eines Kontos sas.

Freigegebener Schlüssel

Der Get Account Information-Vorgang unterstützt Gemeinsam genutzte Schlüsselautorisierung. Die Autorisierung mit Kontoschlüsseln wird für die meisten Szenarien nicht empfohlen, da sie weniger sicher ist. Microsoft empfiehlt, die Autorisierung gemeinsam genutzter Schlüssel für das Speicherkonto nach Möglichkeit zu verbieten. Weitere Informationen finden Sie unter Verhindern der Autorisierung mit freigegebenem Schlüssel.

Bemerkungen

Der URL-Pfad der Anforderung wirkt sich nicht auf die Informationen aus, die dieser Vorgang angibt. Der Zweck besteht darin, der Anforderung die ordnungsgemäße Autorisierung mit einem SAS-Token zu ermöglichen, das die zulässige Ressource angibt.

Die angegebene Ressource muss nicht vorhanden sein, damit dieser Vorgang erfolgreich ausgeführt werden kann. Beispielsweise wird ein SAS-Token, das mit einem nicht vorhandenen BLOB generiert wurde, und gültige Berechtigungen werden mit einem URL-Pfad erfolgreich ausgeführt, der den richtigen Kontonamen, den richtigen Containernamen und den Namen des nicht vorhandenen BLOB enthält.

Abrechnung

Preisanforderungen können von Clients stammen, die Blob Storage-APIs verwenden, entweder direkt über die BLOB Storage-REST-API oder aus einer Azure Storage-Clientbibliothek. Diese Anforderungen anfallen Gebühren pro Transaktion. Der Transaktionstyp wirkt sich auf die Belastung des Kontos aus. Lesen Sie z. B. Transaktionen, die einer anderen Abrechnungskategorie als dem Schreiben von Transaktionen zugerechnet werden. Die folgende Tabelle zeigt die Abrechnungskategorie für Get Account Information Anforderungen basierend auf dem Speicherkontotyp:

Operation	Speicherkontotyp	Abrechnungskategorie
Kontoinformationen abrufen	Premium-Block-BLOB Standard general-purpose v2	Andere Vorgänge
Kontoinformationen abrufen	Standard general-purpose v1	Lesevorgänge

Informationen zu den Preisen für die angegebene Abrechnungskategorie finden Sie unter Azure Blob Storage Pricing.