Hämta blobegenskaper
Åtgärden Get Blob Properties returnerar alla användardefinierade metadata, standard-HTTP-egenskaper och systemegenskaper för bloben. Den returnerar inte innehållet i bloben.
Förfrågan
Begäran Get Blob Properties kan konstrueras på följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto:
| URI för HEAD-metodbegäran | HTTP-version |
|---|---|
https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime> |
HTTP/1.1 |
Emulerad URI för lagringstjänst
När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorn värdnamn och Blob Service-port som följt av namnet på det 127.0.0.1:10000 emulerade lagringskontot:
| URI för HEAD-metodbegäran | HTTP-version |
|---|---|
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob |
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 på begärans-URI:en.
| Parameter | Beskrivning |
|---|---|
snapshot |
Valfritt. Parametern för ögonblicksbilden ä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 | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden att Azure Storage. |
Date eller x-ms-date |
Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden att 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 Properties 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 blobens id. Om båda dessa villkor inte uppfylls misslyckas begäran och åtgärden misslyckas med Get Blob Properties statuskod 412 (förhandsvillkoret misslyckades). |
x-ms-upn |
Valfritt, version 2020-06-12 eller senare. Giltigt för konton med hierarkisk namnrymd aktiverad. Om värdet är true omvandlas de användaridentitetsvärden som x-ms-owner returneras i från Azure Active Directory-ID:t till användarens huvudnamn. Om värdet är false returneras värdena som Azure Active Directory objekt-ID:er. Standardvärdet är falskt. Observera att grupp- och programobjekt-ID:t inte översätts eftersom de inte har unika egna namn. |
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 Om Storage Analytics-loggning och Azure Logging: 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 endast returnera blobegenskaper och metadata 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 rubriker) är valfritt. Om en blob tidigare har krypterats med en kundtilldelade nyckel måste dessa huvuden inkluderas i begäran för att slutföra läsåtgärden.
| 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 | Beskrivning |
|---|---|
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 tidpunkten för senaste ändring av bloben. |
x-ms-creation-time |
Version 2017-11-09 och senare. Datum/tid då bloben skapades. Datumformatet följer RFC 1123. Mer information finns i Representation of Date-Time Values in Headers. |
x-ms-meta-name:value |
En uppsättning namn/värde-par som motsvarar de användardefinierade metadata som är associerade med den här bloben. |
x-ms-tag-count |
Version 2019-12-12 eller senare. Om bloben har några taggar returnerar antalet taggar som lagras på bloben. Det här huvudet returneras inte om det inte finns några taggar på bloben. |
x-ms-blob-type:<BlockBlob|PageBlob|AppendBlob> |
Blobtypen. |
x-ms-copy-completion-time:<datetime> |
Version 2012-02-12 och senare. Slutsatstiden för den senaste åtgärden där Copy Blob bloben var målbloben. Det här värdet kan ange tiden för ett slutfört, avbrutet eller misslyckat kopieringsförsök. Det här huvudet visas inte om en kopia är väntande, om den här bloben aldrig har varit målet i en åtgärd, eller om bloben har ändrats efter en slutförd åtgärd med Copy Blob hjälp av , eller Copy Blob Set Blob Properties Put Blob Put Block List . |
x-ms-copy-status-description: <error string> |
Version 2012-02-12 och senare visas bara när x-ms-copy-status är failed eller pending . Beskriver orsaken till ett allvarligt eller icke-allvarligt kopieringsfel. Det här huvudet visas inte om den här bloben aldrig har varit målet i en åtgärd, eller om den här bloben har ändrats efter en slutförd åtgärd med Copy Blob hjälp av , eller Copy Blob Set Blob Properties Put Blob Put Block List . |
x-ms-copy-id: <id> |
Version 2012-02-12 och senare. Strängidentifierare för den senaste åtgärden Copy Blob där bloben var målbloben. Det här huvudet visas inte om den här bloben aldrig har varit målet i en åtgärd, eller om den här bloben har ändrats efter en slutförd åtgärd med Copy Blob hjälp av , eller Copy Blob Set Blob Properties Put Blob Put Block List . |
x-ms-copy-progress: <bytes copied/bytes total> |
Version 2012-02-12 och senare. Innehåller antalet kopierade byte och totalt antal byte i källan i den senaste åtgärden där Copy Blob bloben var målbloben. Kan visa mellan 0 och Content-Length kopierade byte. Det här huvudet visas inte om den här bloben aldrig har varit målet i en åtgärd, eller om den här bloben har ändrats efter en slutförd åtgärd med Copy Blob hjälp av , eller Copy Blob Set Blob Properties Put Blob Put Block List . |
x-ms-copy-source: url |
Version 2012-02-12 och senare. URL med en längd på upp till 2 KiB som anger den källblob som användes vid det senaste försöket där Copy Blob bloben var målbloben. Det här huvudet visas inte om den här bloben aldrig har varit målet i en åtgärd, eller om den här bloben har ändrats efter en slutförd åtgärd med Copy Blob hjälp av , eller Copy Blob Set Blob Properties Put Blob Put Block List . |
x-ms-copy-status: <pending | success | aborted | failed> |
Version 2012-02-12 och senare. Tillståndet för kopieringsåtgärden som identifieras av x-ms-copy-id med följande värden: - success: Kopieringen har slutförts.- pending: Kopian pågår. Kontrollera x-ms-copy-status-description om tillfälliga, icke-allvarliga fel hindrar kopieringsförloppet men inte orsakar fel.- aborted: Kopian avslutades med Abort Copy Blob .- failed: Kopieringen misslyckades. Se x-ms-copy-status-description för information om fel.Det här huvudet visas inte om den här bloben aldrig har varit målet i en åtgärd, eller om den här bloben har ändrats efter en slutförd åtgärd med Copy Blob hjälp av , eller Copy Blob Set Blob Properties Put Blob Put Block List . |
x-ms-incremental-copy: true |
Version 2016-05-31 och senare. Inkluderas om bloben är inkrementell kopieringsblob. |
x-ms-copy-destination-snapshot:<datetime> |
Version 2016-05-31 och senare. Inkluderas om bloben är inkrementell kopieringsblob eller inkrementell x-ms-copy-status kopieringsögonblicksbild, om lyckas. Ögonblicksbildstid för den senaste lyckade ögonblicksbilden av den inkrementella kopian för den här bloben. |
x-ms-lease-duration: <infinite | fixed> |
När en blob lånas anger om lånet har en oändlig eller fast varaktighet. Ingår för begäranden som använder version 2012-02-12 och senare. |
x-ms-lease-state: <available | leased | expired | breaking | broken> |
Lånetillstånd för bloben. Ingår för begäranden som görs med version 2012-02-12 och senare. |
x-ms-lease-status:<locked| unlocked> |
Lånestatus för bloben. |
Content-Length |
Storleken på bloben i byte. För en sidblob returnerar den här rubriken värdet för x-ms-blob-content-length rubriken som lagras med bloben. |
Content-Type |
Den innehållstyp som anges för bloben. Om ingen innehållstyp har angetts är standardinnehållstypen application/octet-stream . |
Etag |
ETag innehåller ett värde som du kan använda för att utföra åtgärder villkorligt. Mer information finns i Ange villkorsstyrda huvuden för Blob Service-åtgärder. Om begärandeversionen är 2011-08-18 eller senare är ETag-värdet inom citattecken. |
Content-MD5 |
Om Content-MD5 -huvudet har angetts för bloben returneras svarshuvudet så att klienten kan kontrollera meddelandeinnehållets integritet.I version 2012-02-12 och senare anger md5-värdet för en blockblob även om begäran inte innehåller ett Put Blob Put Blob MD5-huvud. |
Content-Encoding |
Om Content-Encoding begärandehuvudet tidigare har angetts för bloben returneras det värdet i det här huvudet. |
Content-Language |
Om Content-Language begärandehuvudet tidigare har angetts för bloben returneras det värdet i det här huvudet. |
Content-Disposition |
Om begärandehuvudet tidigare har angetts för bloben returneras det värdet i det här huvudet för begäranden mot Content-Disposition version 2013-08-15 och senare.Fältet Content-Disposition för svarshuvud förmedlar ytterligare information om hur svarsnyttolasten ska bearbetas och kan även användas för att bifoga ytterligare metadata. Om det till exempel är inställt på anger det att användaragenten inte ska visa svaret, utan i attachment stället visa dialogrutan Spara som. |
Cache-Control |
Om Cache-Control begärandehuvudet tidigare har angetts för bloben returneras det värdet i det här huvudet. |
x-ms-blob-sequence-number |
Det aktuella sekvensnumret för en sidblob. Det här huvudet returneras inte för blockblobar eller tilläggsblobar. Det här huvudet returneras inte för blockblobar. |
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 tidpunkt svaret initierades. |
Accept-Ranges: bytes |
Anger att tjänsten stöder begäranden om partiellt blobinnehåll. Ingår för begäranden som görs med version 2013-08-15 och senare. |
x-ms-blob-committed-block-count |
Antalet indelade block som finns i bloben. Det här huvudet returneras endast för tilläggsblobar. |
x-ms-server-encrypted: true/false |
Version 2015-12-11 eller senare. Värdet för det här huvudet är inställt på true om blobdata och programmetadata är helt krypterade med den angivna algoritmen. Annars anges värdet till (när bloben är okrypterad eller om endast delar av false blob-/programmetadata krypteras). |
x-ms-encryption-key-sha256 |
Version 2019-02-02 eller senare. Det här huvudet returneras om bloben krypteras med en nyckel som tillhandahålls av kunden. |
x-ms-encryption-scope |
Version 2019-02-02 eller senare. Det här huvudet returneras om bloben krypteras med ett krypteringsomfång. |
x-ms-access-tier |
Version 2017-04-17 eller senare. Nivån för sidblob på ett Premium Storage-konto eller blockblobnivå på bloblagring eller ett v2-konto för generell användning. En lista över tillåtna blobnivåer för Premium-sidor finns i Högpresterande Premium Storage och hanterade diskar för virtuella datorer. För bloblagring eller v2-konto för generell användning är giltiga värden Hot / Cool / Archive . Detaljerad information om blockblobnivåindelade standardblobnivåer finns i Lagringsnivåer för hot, låg nivå och arkivlagring. |
x-ms-access-tier-inferred: true |
Version 2017-04-17 och senare. Endast för sidblobar på ett Premium Storage-konto. Om åtkomstnivån inte uttryckligen har angetts för bloben härförs nivån baserat på dess innehållslängd och det här huvudet returneras med true värdet . För blockblobar på Blob Storage- eller generell användning v2-konto, och om blobben inte har åtkomstnivån inställd, härför vi nivån från lagringskontots egenskaper. Det här huvudet anges bara om blockblobnivån härförs |
x-ms-archive-status |
Version 2017-04-17 eller senare. För bloblagring eller v2-konto för generell användning är giltiga värden rehydrate-pending-to-hot / rehydrate-pending-to-cool . Om bloben rehydreras och inte är klar returneras det här huvudet som anger att rehydrering väntar och anger även målnivån. Detaljerad information om blockblobnivåindelade standardblobnivåer finns i Lagringsnivåer för hot, låg nivå och arkivlagring. |
x-ms-access-tier-change-time |
Version 2017-04-17 eller senare. Detta ger den senaste gången som nivån ändrades för objektet. Det här huvudet returneras bara om nivån på blockbloben någonsin har angetts. Datumformatet följer RFC 1123. Mer information finns i Representation of Date-Time Values in Headers. Detaljerad information om blockblobnivåindelade standardblobnivåer finns i Lagringsnivåer för hot, låg nivå och arkivlagring. |
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 den här rubriken är lika med värdet för rubriken 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 kommer det här huvudet inte att finnas i svaret. |
x-ms-rehydrate-priority |
Version 2019-12-12 eller senare. Om ett objekt är i väntande tillstånd för rehydrera returneras det här huvudet med prioriteten rehydrera. Giltiga värden är High / Standard . Detaljerad information om blockblobnivåindelade standardblobnivåer finns i Lagringsnivåer för hot, låg nivå och arkivlagring. |
x-ms-or-{policy-id}_{rule-id} |
Version 2019-12-12 eller senare, returneras endast för blockblobar. policy-id är ett GUID-värde som representerar identifieraren för en objektreplikeringsprincip på lagringskontot. rule-id är ett guid-värde som representerar identifieraren för en principregel i blobcontainern. Om kontot är aktiverat representerar värdet för det här huvudet replikeringsstatusen för bloben med angivna princip- och ObjectReplication regelidentifierare, antingen complete eller failed . |
x-ms-or-policy-id |
Version 2019-12-12 eller senare returneras endast för blockblobar. Om kontot är ObjectReplication aktiverat representerar värdet för det här huvudet den princip som styr replikeringen. |
x-ms-last-access-time |
Version 2020-02-10 eller senare. Anger den senaste gången blobens data koms åt baserat på lagringskontots spårningsprincip för senaste åtkomsttid. Huvudet returneras inte om lagringskontot inte har någon spårningsprincip för senaste åtkomst eller om principen är inaktiverad. Information om hur du anger lagringskontots spårningsprincip för senaste åtkomsttid finns i Blob Service API. |
x-ms-blob-sealed |
Version 2019-12-12 eller senare returneras endast för tilläggsblobar. Om tilläggsbloben har förseglats skulle värdet vara sant. Mer information finns i Seal Append Blobs (Försegla tilläggsblobar) |
x-ms-immutability-policy-until-date |
Version 2020-06-12 eller senare. Anger det datum för "kvarhållning tills" som angetts för bloben. Det här är det datum då bloben kan skyddas från att ändras eller tas bort. Returneras endast om en oföränderlighetsprincip har angetts för bloben. Värdet för det här huvudet är RFC1123-format. |
x-ms-immutability-policy-mode: unlocked/locked |
Version 2020-06-12 eller senare. Oföränderlighetsprincipen returneras om en oföränderlighetsprincip har angetts för bloben. Värdena är unlocked / locked . unlocked anger att användaren kan ändra principen genom att öka eller minska kvarhållningsdatumet. locked anger att dessa åtgärder är förbjudna. |
x-ms-legal-hold: true/false |
Version 2020-06-12 eller senare. Det här huvudet returneras inte om det inte finns något juridiskt kvarknäck för bloben. Värdet för det här huvudet är inställt på true om bloben innehåller ett juridiskt kvarknäckning och dess värde är true. Annars är värdet inställt på false om bloben innehåller ett juridiskt värde och dess värde falskt. |
x-ms-owner |
Version 2020-06-12 eller senare endast för konton med hierarkisk namnrymd aktiverad. Returnerar ägarens användare av filen eller katalogen. |
x-ms-group |
Version 2020-06-12 eller senare endast för konton med hierarkisk namnrymd aktiverad. Returnerar den äga gruppen för filen eller katalogen. |
x-ms-permissions |
Version 2020-06-12 eller senare endast för konton med hierarkisk namnrymd aktiverad. Returnerar de behörigheter som angetts för "användare", "grupp" och "övrigt" i filen eller katalogen. Varje enskild behörighet har formatet [r,w,x,-]. {3} |
Svarstext
Inga.
Exempelsvar
Response Status:
HTTP/1.1 200 OK
Response Headers:
x-ms-meta-Name: myblob.txt
x-ms-meta-DateUploaded: <date>
x-ms-blob-type: AppendBlob
x-ms-lease-status: unlocked
x-ms-lease-state: available
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: <date>
ETag: "0x8CAE97120C1FF22"
Accept-Ranges: bytes
x-ms-blob-committed–block-count: 1
x-ms-version: 2015-02-21
Last-Modified: <date>
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6
x-ms-copy-source: <url>
x-ms-copy-status: success
x-ms-copy-progress: 11/11
x-ms-copy-completion-time: <date>
Auktorisering
Om containerns åtkomstkontrollista (ACL) är inställd på att tillåta anonym åtkomst till bloben kan alla klienter anropa den här åtgärden. Om containern är privat kan den här åtgärden utföras av kontoägaren och av vem som helst med en signatur för delad åtkomst som har behörighet att läsa bloben.
Kommentarer
För att avgöra om en åtgärd har slutförts kontrollerar du först att huvudvärdet matchar det Copy Blob x-ms-copy-id kopierings-ID som angavs av det ursprungliga anropet till Copy Blob . En matchning säkerställer att ett annat program inte avbröt kopieringen och startar en ny Copy Blob åtgärd. Sök sedan efter x-ms-copy-status: success rubriken. Tänk dock på att alla skrivåtgärder på en blob utom Lease , och åtgärder tar bort alla egenskaper från Put Page Put Block x-ms-copy-* bloben. Dessa egenskaper kopieras inte heller av åtgärder Copy Blob som använder versioner före 2012-02-12.
x-ms-copy-status-description innehåller mer information om Copy Blob felet. I följande tabell visas x-ms-copy-status-description värden och deras betydelse.
I följande tabell beskrivs de tre fälten för varje x-ms-copy-status-description värde.
| Komponent | Beskrivning |
|---|---|
| HTTP-statuskod | Standard 3-siffrigt heltal som anger felet. |
| Felkod | Nyckelord som beskriver fel som tillhandahålls av Azure i <> ErrorCode-elementet. Om inget <ErrorCode-element visas används ett nyckelord som innehåller standardfeltext som är associerad med > den 3-siffriga HTTP-statuskoden i HTTP-specifikationen. Se Vanliga REST API felkoder. |
| Information | Detaljerad beskrivning av fel, inom citattecken. |
I följande tabell beskrivs värdena x-ms-copy-status och x-ms-copy-status-description för vanliga felscenarier.
Viktigt
Beskrivningstexten som visas här kan ändras utan varning, även utan versionsändring, så förlita dig inte på att matcha den här exakta texten.
| Scenario | x-ms-copy-status-värde | x-ms-copy-status-description-värde |
|---|---|---|
| Kopieringsåtgärden har slutförts. | lyckades | tomt |
| Användaren avbröt kopieringen innan den slutfördes. | Avbröts | tomt |
| Ett fel uppstod vid läsning från källbloben under en kopieringsåtgärd, men åtgärden kommer att göras på nytt. | Väntar | 502 BadGateway "Ett återförsöksbart fel inträffade vid läsning av källan. Försöker igen. Feltid: <> " |
| Ett fel uppstod när du skrev till målbloben för en kopieringsåtgärd, men åtgärden kommer att försökas igen. | Väntar | 500 InternalServerError "Encountered a retryable error. Försöker igen. Feltid: <> " |
| Ett oåterkalleligt fel inträffade vid läsning från källbloben för en kopieringsåtgärd. | misslyckades | 404 ResourceNotFound "Kopieringen misslyckades vid läsning av källan". Obs! När du rapporterar det här underliggande felet returnerar Azure ResourceNotFound <ErrorCode-elementet. > Om inget <> ErrorCode-element visas i svaret visas en standardsträngrepresentation av HTTP-statusen, till NotFound exempel . |
| Tidsgränsen begränsar alla kopieringsåtgärder som har förflutit. (För närvarande är tidsgränsen 2 veckor.) | misslyckades | 500 OperationCancelled "The copy exceeded the maximum allowed time". |
| Kopieringsåtgärden misslyckades för ofta vid läsning från källan och uppfyller inte minsta möjliga antal försök till lyckade försök. (Den här tidsgränsen förhindrar återförsök av en mycket dålig källa under 2 veckor innan den misslyckas). | misslyckades | 500 OperationCancelled "Kopian misslyckades vid läsning av källan". |
x-ms-last-access-time spårar den tid då blobens data koms åt baserat på lagringskontots spårningsprincip för senaste åtkomsttid. Åtkomst till en blobs metadata ändrar inte den senaste åtkomsttiden.
Se även
Auktorisera begäranden till Azure Storage
Status och felkoder
Felkoder för Blob Service