Hämta kontoinformation
Åtgärden Get Account Information returnerar SKU-namnet och kontotyp för det angivna kontot. Den är tillgänglig i version 2018-03-28 och senare versioner av tjänsten.
Förfrågan
Du kan skapa Get Account Information begäran med hjälp av en giltig begäran som auktoriseras via delad nyckel eller sas-auktorisering (signatur för delad åtkomst).
Om du lägger till värdet restypeaccount och comp värdet propertiesför använder begäran åtgärden Get Account Information . Följande tabell visar exempel:
| Metod | URI för förfrågan | 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-parametrar
Du kan ange följande ytterligare parametrar för begärande-URI:n:
| Parameter | Beskrivning |
|---|---|
restype |
Krävs. Parametervärdet restype måste vara account. |
comp |
Krävs. Parametervärdet comp måste vara properties. |
Begärandehuvuden
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden:
| Begärandehuvud | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date or x-ms-date |
Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. För den här åtgärden måste versionen vara 2018-03-28 eller senare. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. |
Begärandetext
Inga.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 200 (OK).
Information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
| Svarsrubrik | Description |
|---|---|
x-ms-request-id |
Identifierar unikt den begäran som gjordes. Du kan använda den för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Version 2009-09-19 och senare. Anger vilken version av Azure Blob Storage som används för att köra begäran. |
Date |
Ett UTC-datum/tid-värde som anger den tid då tjänsten skickade svaret. |
Content-Length |
Anger längden på begärandetexten. För den här åtgärden är innehållslängden alltid noll. |
x-ms-sku-name |
Identifierar SKU-namnet för det angivna kontot. |
x-ms-account-kind |
Identifierar kontotyp för det angivna kontot. Möjliga värden är Storage, BlobStorageoch StorageV2. Rubriken skiljer mellan Generell användning v1 (GPv1) och Generell användning v2-lagringskonton (GPv2) med hjälp av delsträngen V2 för GPv2-konton. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för huvudet, om det finns i begäran och värdet är högst 1 024 synliga ASCII-tecken.
x-ms-client-request-id Om rubriken inte finns i begäran visas inte det här huvudet i svaret. |
x-ms-is-hns-enabled |
Version 2019-07-07 och senare. Anger om kontot har ett hierarkiskt namnområde aktiverat. |
Själva svaret
Inga.
Exempelsvar
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
Auktorisering
Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden enligt beskrivningen Get Account Information nedan.
Den här åtgärden stöder inte OAuth-baserad auktorisering via en åtkomsttoken från Azure Active Directory/MSI eller en SAS för användardelegering.
Kommentarer
URL-sökvägen för begäran påverkar inte den information som den här åtgärden ger. Syftet är att tillåta att begäran auktoriseras korrekt med en SAS-token som anger den tillåtna resursen.
Den angivna resursen behöver inte finnas för att åtgärden ska lyckas. En SAS-token som genereras med en obefintlig blob och giltiga behörigheter lyckas till exempel med en URL-sökväg som innehåller rätt kontonamn, rätt containernamn och den obefintliga blobens namn.
Fakturering
Prisbegäranden kan komma från klienter som använder Blob Storage-API:er, antingen direkt via REST-API:et för Blob Storage eller från ett Azure Storage-klientbibliotek. Dessa begäranden ackumulerar avgifter per transaktion. Typen av transaktion påverkar hur kontot debiteras. Lästransaktioner ackumuleras till exempel till en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för Get Account Information begäranden baserat på lagringskontotypen:
| Åtgärd | Typ av lagringskonto | Faktureringskategori |
|---|---|---|
| Hämta kontoinformation | Premium-blockblob Standard generell användning v2 |
Andra åtgärder |
| Hämta kontoinformation | Standard generell användning v1 | Läsåtgärder |
Mer information om priser för den angivna faktureringskategorin finns i Azure Blob Storage Prissättning.