Hämta kontoinformation

Artikel
12/13/2024

Å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.

Begäran

Du kan skapa Get Account Information begäran med hjälp av en giltig begäran som har auktoriserats via delad nyckel eller sas-auktorisering (signatur för delad åtkomst).

Om du lägger till ett restype värde för account och ett comp värde för propertiesanvänder begäran åtgärden Get Account Information. Följande tabell visar exempel:

Metod	Begärande-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-parametrar

Du kan ange följande ytterligare parametrar på 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 UTC (Coordinated Universal Time) 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`	Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. 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

Ingen.

Svar

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskod 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 STANDARD HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarsrubrik	Beskrivning
`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`, `BlobStorage`och `StorageV2`. Rubriken skiljer mellan GPv1-lagringskonton (General Purpose v1) och GPv2-lagringskonton (General Purpose v2) med hjälp av `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 för `x-ms-client-request-id`-huvudet, om det finns i begäran och värdet är högst 1 024 synliga ASCII-tecken. Om `x-ms-client-request-id` huvudet 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.

Svarstext

Ingen.

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

Tillstånd

Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden Get Account Information enligt beskrivningen nedan.

Viktig

Microsoft rekommenderar att du använder Microsoft Entra-ID med hanterade identiteter för att auktorisera begäranden till Azure Storage. Microsoft Entra-ID ger överlägsen säkerhet och användarvänlighet jämfört med auktorisering av delad nyckel.

Azure Storage stöder användning av Microsoft Entra-ID för att auktorisera begäranden till blobdata. Med Microsoft Entra-ID kan du använda rollbaserad åtkomstkontroll i Azure (Azure RBAC) för att bevilja behörigheter till ett säkerhetsobjekt. Säkerhetsobjektet kan vara en användare, grupp, huvudnamn för programtjänsten eller en hanterad Azure-identitet. Säkerhetsobjektet autentiseras av Microsoft Entra-ID för att returnera en OAuth 2.0-token. Token kan sedan användas för att auktorisera en begäran mot Blob-tjänsten.

Mer information om auktorisering med Microsoft Entra-ID finns i Auktorisera åtkomst till blobar med hjälp av Microsoft Entra-ID.

Behörigheter

Nedan visas den RBAC-åtgärd som krävs för att en Microsoft Entra-användare, grupp, hanterad identitet eller tjänstens huvudnamn ska anropa den Get Account Information åtgärden:

Azure RBAC-åtgärd:Microsoft.Storage/storageAccounts/blobServices/getInfo/action

Den här RBAC-åtgärden ingår i rollen Ägare, eller så kan du tilldela den här åtgärden till en anpassad roll.

Mer information om hur du tilldelar roller med Hjälp av Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.

En signatur för delad åtkomst (SAS) ger säker delegerad åtkomst till resurser i ett lagringskonto. Med en SAS har du detaljerad kontroll över hur en klient kan komma åt data. Du kan ange vilken resurs klienten kan komma åt, vilka behörigheter de har till dessa resurser och hur länge SAS är giltigt.

Åtgärden Get Account Information stöder auktorisering med hjälp av ett konto-SAS.

Konto-SAS

Ett SAS-konto skyddas med lagringskontonyckeln. Ett KONTO SAS delegerar åtkomst till resurser i en eller flera av lagringstjänsterna. Alla åtgärder som är tillgängliga via en tjänst eller sas för användardelegering är också tillgängliga via ett konto-SAS.

Mer information om sas-kontot finns i Skapa ett KONTO SAS-.

Anmärkningar

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 icke-existerande 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 BLOB Storage REST API 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:

Operation	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 Prissättning för Azure Blob Storage.

Dela via