Delen via

Accountgegevens ophalen

  • Artikel

De Get Account Information bewerking retourneert de SKU-naam en het accounttype voor het opgegeven account. Deze is beschikbaar op versie 28-03-2018 en latere versies van de service.

Aanvraag

U kunt de Get Account Information aanvraag samenstellen met behulp van een geldige aanvraag die is geautoriseerd via een gedeelde sleutel of SAS-autorisatie (Shared Access Signature).

Als u een restype waarde van account en een comp waarde van propertiestoevoegt, gebruikt de aanvraag de Get Account Information bewerking. In de volgende tabel ziet u voorbeelden:

Methode Aanvraag-URI HTTP-versie
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-parameters

U kunt de volgende aanvullende parameters opgeven voor de aanvraag-URI:

Parameter Beschrijving
restype Vereist. De restype parameterwaarde moet zijn account.
comp Vereist. De comp parameterwaarde moet zijn properties.

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven:

Aanvraagheader Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
Date or x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
x-ms-version Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Voor deze bewerking moet de versie 28-03-28 of hoger zijn. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
x-ms-client-request-id Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader Description
x-ms-request-id Identificeert op unieke wijze de aanvraag die is gedaan. U kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie.
x-ms-version Versie 2009-09-19 en hoger. Geeft de versie van Azure Blob Storage aan die wordt gebruikt om de aanvraag uit te voeren.
Date Een UTC-datum/tijd-waarde die het tijdstip aangeeft waarop de service het antwoord heeft verzonden.
Content-Length Hiermee geeft u de lengte van de aanvraagbody op. Voor deze bewerking is de inhoudslengte altijd nul.
x-ms-sku-name Identificeert de SKU-naam van het opgegeven account.
x-ms-account-kind Identificeert het accounttype van het opgegeven account. De mogelijke waarden zijn Storage, BlobStorageen StorageV2. De header maakt onderscheid tussen Algemeen v1 -opslagaccounts (GPv1) en Algemeen v2 (GPv2) met behulp van de subtekenreeks V2 voor GPv2-accounts.
x-ms-client-request-id Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header, als deze aanwezig is in de aanvraag en de waarde maximaal 1024 zichtbare ASCII-tekens is. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.
x-ms-is-hns-enabled Versie 2019-07-07 en hoger. Geeft aan of voor het account een hiërarchische naamruimte is ingeschakeld.

Hoofdtekst van de reactie

Geen.

Voorbeeldantwoord

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

Autorisatie

Autorisatie is vereist bij het aanroepen van een bewerking voor gegevenstoegang in Azure Storage. U kunt de Get Account Information bewerking autoriseren zoals hieronder wordt beschreven.

Deze bewerking biedt geen ondersteuning voor OAuth-autorisatie via een toegangstoken van Azure Active Directory/MSI of een SAS voor gebruikersdelegatie.

Een Shared Access Signature (SAS) biedt beveiligde gedelegeerde toegang tot resources in een opslagaccount. Met een SAS hebt u gedetailleerde controle over hoe een client toegang heeft tot gegevens. U kunt opgeven tot welke resource de client toegang heeft, welke machtigingen ze hebben voor deze resources en hoe lang de SAS geldig is.

De Get Account Information bewerking ondersteunt autorisatie met behulp van een account-SAS of een service-SAS met ten minste één beschikbare machtiging.

Account-SAS

Een account-SAS wordt beveiligd met de sleutel van het opslagaccount. Een account-SAS delegeert toegang tot resources in een of meer van de opslagservices. Alle bewerkingen die beschikbaar zijn via een service of gebruikersdelegatie-SAS zijn ook beschikbaar via een account-SAS.

Zie Een account-SAS maken voor meer informatie over de account-SAS.

Service-SAS

Een service-SAS wordt beveiligd met de sleutel van het opslagaccount. Een service-SAS delegeert de toegang tot een resource in één Azure Storage-service, zoals blobopslag.

Wanneer gedeelde sleuteltoegang niet is toegestaan voor het opslagaccount, wordt een service-SAS-token niet toegestaan op een aanvraag voor Blob Storage. Zie Begrijpen hoe het niet toewijzen van gedeelde sleutel van invloed is op SAS-tokens voor meer informatie.

Zie Een service-SAS maken voor meer informatie over de service-SAS.

Opmerkingen

Het URL-pad van de aanvraag heeft geen invloed op de informatie die deze bewerking geeft. Het doel is om de aanvraag correct te autoriseren met een SAS-token dat de toegestane resource aangeeft.

De opgegeven resource hoeft niet te bestaan om deze bewerking te laten slagen. Een SAS-token dat is gegenereerd met een niet-bestaande blob en geldige machtigingen, slaagt bijvoorbeeld met een URL-pad dat de juiste accountnaam, de juiste containernaam en de naam van de niet-bestaande blob bevat.

Billing

Prijsaanvragen kunnen afkomstig zijn van clients die gebruikmaken van Blob Storage-API's, rechtstreeks via de Blob Storage REST API of vanuit een Azure Storage-clientbibliotheek. Met deze aanvragen worden kosten per transactie in rekening gebracht. Het type transactie is van invloed op de manier waarop de rekening in rekening wordt gebracht. Leestransacties hebben bijvoorbeeld een andere factureringscategorie dan schrijftransacties. In de volgende tabel ziet u de factureringscategorie voor Get Account Information aanvragen op basis van het type opslagaccount:

Bewerking Type opslagaccount Factureringscategorie
Accountgegevens ophalen Premium blok-blob
Standaard v2 voor algemeen gebruik		 Andere bewerkingen
Accountgegevens ophalen Standaard v1 voor algemeen gebruik Leesbewerkingen

Zie prijzen voor Azure Blob Storage voor meer informatie over prijzen voor de opgegeven factureringscategorie.