Accountgegevens ophalen
De Get Account Information-bewerking retourneert de SKU-naam en het accounttype voor het opgegeven account. Deze is beschikbaar op versie 2018-03-28 en nieuwere versies van de service.
Verzoek
U kunt de Get Account Information aanvraag maken 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 parameterwaarde restype moet accountzijn. |
comp |
Vereist. De parameterwaarde comp moet propertieszijn. |
Aanvraagheaders
In de volgende tabel worden de 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 Storagevoor meer informatie. |
Date or x-ms-date |
Vereist. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Voor deze bewerking moet de versie 2018-03-28 of hoger zijn. Zie Versiebeheer voor de Azure Storage-servicesvoor meer informatie. |
x-ms-client-request-id |
Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet 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 foutcodesvoor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Beschrijving |
|---|---|
x-ms-request-id |
Identificeer de aanvraag die is gedaan, uniek. U kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossenvoor 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 de tijd aangeeft waarop de service het antwoord heeft verzonden. |
Content-Length |
Hiermee geeft u de lengte van de aanvraagbody. 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 opslagaccounts voor algemeen gebruik v1 (GPv1) en GPv2-opslagaccounts voor algemeen gebruik (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 bevat. 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 antwoord
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
Machtiging
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.
Belangrijk
Microsoft raadt aan om Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen voor Azure Storage te autoriseren. Microsoft Entra ID biedt superieure beveiliging en gebruiksgemak in vergelijking met autorisatie van gedeelde sleutels.
- Microsoft Entra ID (aanbevolen)
-
Sas- (Shared Access Signatures)
- gedeelde sleutel
Azure Storage ondersteunt het gebruik van Microsoft Entra ID om aanvragen voor blobgegevens te autoriseren. Met Microsoft Entra ID kunt u op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) gebruiken om machtigingen te verlenen aan een beveiligingsprincipaal. De beveiligingsprincipaal kan een door een gebruiker, groep, toepassingsservice-principal of door Azure beheerde identiteit zijn. De beveiligingsprincipaal wordt geverifieerd door de Microsoft Entra-id om een OAuth 2.0-token te retourneren. Het token kan vervolgens worden gebruikt om een aanvraag te autoriseren voor de Blob-service.
Zie Toegang tot blobs autoriseren met behulp van Microsoft Entra IDvoor meer informatie over autorisatie met Behulp van Microsoft Entra ID.
Machtigingen
Hieronder vindt u de RBAC-actie die nodig is voor een Microsoft Entra-gebruiker, groep, beheerde identiteit of service-principal om de Get Account Information-bewerking aan te roepen:
- Azure RBAC-actie:Microsoft.Storage/storageAccounts/blobServices/getInfo/action
Deze RBAC-actie is opgenomen in de rol Eigenaar of u kunt deze actie toewijzen aan een aangepaste rol.
Zie Een Azure-rol toewijzen voor toegang tot blobgegevensvoor meer informatie over het toewijzen van rollen met behulp van Azure RBAC.
Opmerkingen
Het URL-pad van de aanvraag heeft geen invloed op de informatie die deze bewerking geeft. Het doel is om de aanvraag toe te staan 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 voltooien. 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.
Facturering
Prijsaanvragen kunnen afkomstig zijn van clients die Blob Storage-API's gebruiken, rechtstreeks via de Blob Storage REST API of vanuit een Azure Storage-clientbibliotheek. Deze aanvragen maken kosten per transactie. Het type transactie is van invloed op de manier waarop het account in rekening wordt gebracht. Leestransacties worden bijvoorbeeld opgebouwd tot een andere factureringscategorie dan schrijftransacties. In de volgende tabel ziet u de factureringscategorie voor Get Account Information aanvragen op basis van het type opslagaccount:
| Operatie | Type opslagaccount | Factureringscategorie |
|---|---|---|
| Accountgegevens ophalen | Premium blok-blob Standaard algemeen gebruik v2 |
Andere bewerkingen |
| Accountgegevens ophalen | Standaard algemeen gebruik v1 | Leesbewerkingen |
Zie Prijzen voor Azure Blob Storagevoor meer informatie over prijzen voor de opgegeven factureringscategorie.