Hämta blobmetadata

  • Artikel
  • 4 minuter för att läsa

Åtgärden Get Blob Metadata returnerar alla användardefinierade metadata för den angivna bloben eller ögonblicksbilden.

Förfrågan

Begäran Get Blob Metadata kan konstrueras på följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto:

URI för GET- eller HEAD-metodbegäran HTTP-version
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata&snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata&versionid=<DateTime>		 HTTP/1.1

Emulerad lagringstjänst-URI

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Blob Service-port som följt av namnet på det 127.0.0.1:10000 emulerade lagringskontot:

URI för GET- eller HEAD-metodbegäran HTTP-version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=metadata HTTP/1.1

Mer information finns i Använda Azure Storage Emulator för utveckling och testning.

URI-parametrar

Följande ytterligare parametrar kan anges för URI:en för begäran.

Parameter Beskrivning
snapshot Valfritt. Parametern snapshot är ett täckande DateTime värde som anger vilken blobögonblicksbild som ska hämtas när den finns. Mer information om hur du arbetar med blobögonblicksbilder finns i Skapa en ögonblicksbild av en blob
versionid Valfritt, version 2019-12-12 och senare. Parametern versionid är ett täckande värde som anger vilken version av bloben som ska hämtas när den DateTime finns.
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Service-åtgärder.

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud Description
Authorization Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Authorize requests to Azure Storage.
Date eller x-ms-date Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Authorize requests to Azure Storage.
x-ms-version Krävs för alla auktoriserade begäranden, valfritt för anonyma begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage Services.
x-ms-lease-id:<ID> Valfritt. Om det här huvudet anges Get Blob Metadata utförs åtgärden endast om båda följande villkor är uppfyllda:

– Blobens lån är aktivt för närvarande.
– Låne-ID:t som anges i begäran matchar det för bloben.

Om båda dessa villkor inte uppfylls misslyckas begäran och åtgärden misslyckas med Get Blob Metadata statuskod 412 (förhandsvillkoret misslyckades).
x-ms-client-request-id Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 KiB som registreras i analysloggarna när loggning av lagringsanalys är aktiverat. Användning av det här huvudet rekommenderas starkt för korrelering av aktiviteter på klientsidan med begäranden som tas emot av servern. Mer information finns i About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests (Om Storage Analytics-loggning och Azure Logging: Using Logs to Track Storage Requests (Använda loggar för att spåra Storage begäranden).

Den här åtgärden stöder också användning av villkorsstyrda huvuden för att hämta blobens metadataåtgärd endast om ett angivet villkor uppfylls. Mer information finns i Ange villkorsstyrda huvuden för Blob Service-åtgärder.

Begärandehuvuden (krypteringsnycklar som tillhandahålls av kunden)

Från och med version 2019-02-02 kan följande huvuden anges i begäran om att läsa en blob krypterad med en nyckel som tillhandahålls av kunden. Kryptering med en nyckel som tillhandahålls av kunden (och motsvarande uppsättning huvuden) är valfritt. Om en blob tidigare har krypterats med en kundtilldelade nyckel måste dessa huvuden inkluderas i begäran för att läsningen ska kunna slutföras.

Begärandehuvud Beskrivning
x-ms-encryption-key Krävs. Den Base64-kodade AES-256-krypteringsnyckeln.
x-ms-encryption-key-sha256 Valfritt. Base64-kodad SHA256-hash för krypteringsnyckeln.
x-ms-encryption-algorithm: AES256 Krävs. Anger vilken algoritm som ska användas för kryptering. Värdet för det här huvudet måste vara AES256 .

Begärandetext

Inga.

Svarsåtgärder

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.

Svarsrubriker

Svaret för den här åtgärden innehåller följande huvuden. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden följer protokollspecifikationen HTTP/1.1.

Svarshuvud Description
x-ms-meta-name:value Returnerar ett metadatavärde för containern.
Last-Modified Datum/tid då bloben senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representation of Date-Time Values in Headers.

Alla åtgärder som ändrar bloben, inklusive en uppdatering av blobens metadata eller egenskaper, ändrar blobens senaste ändringstid.
ETag ETag för bloben. Om begärandeversionen är 2011-08-18 eller senare är ETag-värdet inom citattecken.
x-ms-request-id Det här huvudet identifierar unikt begäran som har gjorts och kan användas för felsökning av begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version Anger vilken version av blobtjänsten som används för att köra begäran. Det här huvudet returneras för begäranden som görs mot version 2009-09-19 och senare.

Det här huvudet returneras också för anonyma begäranden utan en angiven version om containern har markerats för offentlig åtkomst med blobtjänstens version 2009-09-19.
Date Ett datum-/tidsvärde för UTC som genererats av tjänsten och som anger vid vilken tid svaret initierades.
x-ms-client-request-id Det här huvudet 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 -huvudet om det finns i begäran och värdet är högst x-ms-client-request-id 1 024 synliga ASCII-tecken. Om x-ms-client-request-id -huvudet inte finns i begäran finns det här huvudet inte i svaret.

Svarstext

Inga.

Auktorisering

Den här åtgärden kan utföras av kontoägaren eller av någon som använder en signatur för delad åtkomst som har behörighet att läsa bloben. Om containerns ACL är inställd på att tillåta anonym åtkomst kan alla klienter anropa den här åtgärden.

Kommentarer

Inga.

Se även

Auktorisera begäranden till Azure Storage
Status och felkoder
Felkoder för Blob Service