Hämta blob

  • Artikel

Åtgärden Get Blob läser eller laddar ned en blob från systemet, inklusive dess metadata och egenskaper. Du kan också anropa Get Blob för att läsa en ögonblicksbild.

Förfrågan

Du kan skapa begäran på Get Blob följande sätt. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto:

URI för GET-metodbegäran HTTP-version
https://myaccount.blob.core.windows.net/mycontainer/myblob

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>

 HTTP/1.0

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 Azure Blob Storage port som 127.0.0.1:10000, följt av namnet på det emulerade lagringskontot:

URI för GET-metodbegäran HTTP-version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

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

URI-parametrar

Följande ytterligare parametrar kan anges i begärande-URI:n:

Parameter Beskrivning
snapshot Valfritt. Parametern snapshot är ett täckande DateTime värde som när den finns anger den blobögonblicksbild som ska hämtas. 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 DateTime värde som anger vilken version av bloben som ska hämtas när den finns.
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Storage-åtgärder.

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 eller x-ms-date Krävs. Anger Coordinated Universal Time (UTC) 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. Valfritt för anonyma begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Om det här huvudet utelämnas för en anonym begäran kör tjänsten begäran med version 2009-09-19. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
Range Valfritt. Returnera endast blobens byte i det angivna intervallet.
x-ms-range Valfritt. Returnera endast blobens byte i det angivna intervallet. Om både Range och x-ms-range anges använder tjänsten värdet x-ms-range. Om inget av intervallen anges returneras hela blobinnehållet. Mer information finns i Ange intervallrubriken för Blob Storage-åtgärder.
x-ms-lease-id: <ID> Valfritt. Om det här huvudet anges utförs åtgärden endast om båda följande villkor är uppfyllda:

– Blobens lån är för närvarande aktivt.
– Det låne-ID som anges i begäran matchar blobens låne-ID.

Om det här huvudet anges men något av dessa villkor inte uppfylls misslyckas begäran och Get Blob åtgärden misslyckas med statuskoden 412 (villkoret misslyckades).
x-ms-range-get-content-md5: true Valfritt. När det här huvudet anges till true och anges tillsammans med huvudet returnerar tjänsten MD5-hashen för intervallet, så länge intervallet är mindre än eller lika med Range 4 mebibyte (MiB) i storlek.

Om rubriken anges utan Range huvudet returnerar tjänsten statuskoden 400 (felaktig begäran).

Om rubriken anges till true när intervallet överskrider 4 MiB returnerar tjänsten statuskoden 400 (felaktig begäran).
x-ms-range-get-content-crc64: true Valfritt. När det här huvudet anges till true och anges tillsammans med huvudet returnerar tjänsten CRC64-hashen för intervallet, så länge intervallet är mindre än eller lika med Range 4 MiB i storlek.

Om rubriken anges utan Range huvudet returnerar tjänsten statuskoden 400 (felaktig begäran).

Om rubriken anges till true när intervallet överskrider 4 MiB returnerar tjänsten statuskoden 400 (felaktig begäran).

Om både huvudena x-ms-range-get-content-md5 och x-ms-range-get-content-crc64 finns misslyckas begäran med 400 (felaktig begäran).

Det här huvudet stöds i versionerna 2019-02-02 och senare.
Origin Valfritt. Anger ursprunget från vilket begäran utfärdas. Förekomsten av det här huvudet resulterar i CORS-huvuden (cross-origin resource sharing) i svaret.
x-ms-client-request-id Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB), som registreras i analysloggarna när loggning av lagringsanalys är aktiverad. Vi rekommenderar starkt att du använder det här huvudet när du korrelerar aktiviteter på klientsidan med begäranden som tas emot av servern. Mer information finns i Om Azure Lagringsanalys loggning.

Den här åtgärden stöder också användning av villkorsstyrda rubriker för att endast läsa bloben om ett angivet villkor uppfylls. Mer information finns i Ange villkorsstyrda rubriker för Blob Storage-åtgärder.

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

Från och med version 2019-02-02 kan du ange följande rubriker på begäran för att läsa en blob som är krypterad med en nyckel som tillhandahålls av kunden. Kryptering med en nyckel som tillhandahålls av kunden (och motsvarande uppsättning rubriker) är valfri. Om en blob tidigare har krypterats med en kundtilldelad nyckel måste du inkludera dessa huvuden 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. Den Base64-kodade SHA256-hashen 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, en uppsättning svarshuvuden och svarstexten som innehåller innehållet i bloben.

Statuskod

En lyckad åtgärd för att läsa den fullständiga bloben returnerar statuskoden 200 (OK).

En lyckad åtgärd för att läsa ett angivet intervall returnerar statuskod 206 (partiellt innehåll).

Mer 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 HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Syntax Description
Last-Modified Datum/tid då bloben senast ändrades. Datumformatet följer RFC 1123.

Alla åtgärder som ändrar bloben, inklusive en uppdatering av blobens metadata eller egenskaper, ändrar blobens senast ändrade tid.
x-ms-creation-time Version 2017-11-09 och senare. Datum/tid då bloben skapades. Datumformatet följer RFC 1123.
x-ms-meta-name:value En uppsättning namn/värde-par som är associerade med den här bloben som användardefinierade metadata.
x-ms-tag-count Version 2019-12-12 och senare. Om bloben har några taggar returnerar den här rubriken antalet taggar som lagras på bloben. Rubriken returneras inte om det inte finns några taggar på bloben.
Content-Length Antalet byte som finns i svarstexten.
Content-Type Den innehållstyp som har angetts för bloben. Standardinnehållstypen är application/octet-stream.
Content-Range Anger det byteintervall som returneras om klienten begärde en delmängd av bloben genom att ange Range begärandehuvudet.
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 rubriker för Blob Storage-åtgärder. Om begärandeversionen är 2011-08-18 eller senare omges ETag-värdet av citattecken.
Content-MD5 Om bloben har en MD5-hash och åtgärden Get Blob är att läsa den fullständiga bloben returneras det här svarshuvudet så att klienten kan söka efter meddelandets innehållsintegritet.

I version 2012-02-12 och senare Put Blob anger en blockblobs MD5-hashvärde även om Put Blob begäran inte innehåller ett MD5-huvud.

Om begäran ska läsa ett angivet intervall och x-ms-range-get-content-md5 är inställt på truereturnerar begäran en MD5-hash för intervallet, så länge områdesstorleken är mindre än eller lika med 4 MiB.

Om ingen av dessa villkorsuppsättningar är truereturneras inget värde för Content-MD5 huvudet.

Om x-ms-range-get-content-md5 anges utan Range -huvudet returnerar tjänsten statuskod 400 (felaktig begäran).

Om x-ms-range-get-content-md5 anges till true när intervallet överskrider 4 MiB returnerar tjänsten statuskod 400 (felaktig begäran).
x-ms-content-crc64 Om begäran ska läsa ett angivet intervall och x-ms-range-get-content-crc64 är inställt truepå returnerar begäran en CRC64-hash för intervallet, så länge intervallstorleken är mindre än eller lika med 4 MiB.

Om x-ms-range-get-content-crc64 anges utan Range -huvudet returnerar tjänsten statuskod 400 (felaktig begäran).

Om x-ms-range-get-content-crc64 anges till true när intervallet överskrider 4 MiB returnerar tjänsten statuskod 400 (felaktig begäran).
Content-Encoding Returnerar värdet som angavs för begärandehuvudet Content-Encoding .
Content-Language Returnerar värdet som angavs för begärandehuvudet Content-Language .
Cache-Control Returneras om rubriken tidigare har angetts för bloben.
Content-Disposition Returneras för begäranden mot version 2013-08-15 och senare. Den här rubriken returnerar det värde som angavs för x-ms-blob-content-disposition rubriken.

Fältet Content-Disposition för svarshuvud förmedlar ytterligare information om hur du bearbetar svarsnyttolasten och kan användas för att bifoga ytterligare metadata. Om rubriken till attachmentexempel är inställd på anger det att user-agenten inte ska visa svaret. I stället visas dialogrutan Spara som med ett annat filnamn än det angivna blobnamnet.
x-ms-blob-sequence-number Det aktuella sekvensnumret för en sidblob.

Det här huvudet returneras inte för blockblobar eller tilläggsblobar.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Returnerar blobens typ.
x-ms-copy-completion-time: <datetime> Version 2012-02-12 och senare. Sluttiden för den senaste åtgärden Copy Blob där den här bloben var målbloben. Det här värdet kan ange tidpunkten för ett slutfört, avbrutet eller misslyckat kopieringsförsök. Det här huvudet visas inte om en kopia väntar, om den här bloben aldrig har varit målet i en Copy Blob åtgärd eller om den här bloben har ändrats efter en slutförd Copy Blob åtgärd som använde Set Blob Properties, Put Blobeller 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 den senaste allvarliga eller icke-dödliga kopieringsåtgärden. Det här huvudet visas inte om den här bloben aldrig har varit målet i en Copy Blob åtgärd, eller om den här bloben har ändrats efter en slutförd Copy Blob åtgärd som använde Set Blob Properties, Put Blobeller Put Block List.
x-ms-copy-id: <id> Version 2012-02-12 och senare. En strängidentifierare Copy Blob för den senaste åtgärden där den här bloben var målbloben. Det här huvudet visas inte om den här bloben aldrig har varit målet i en Copy Blob åtgärd, eller om den här bloben har ändrats efter en slutförd Copy Blob åtgärd som använde Set Blob Properties, Put Blobeller Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Version 2012-02-12 och senare. Innehåller antalet byte som kopierades och det totala antalet byte i källan i den senaste åtgärden Copy Blob där den här bloben var målbloben. Den kan visa från 0 till Content-Length kopierade byte. Det här huvudet visas inte om den här bloben aldrig har varit målet i en Copy Blob åtgärd, eller om den här bloben har ändrats efter en slutförd Copy Blob åtgärd som använde Set Blob Properties, Put Blobeller Put Block List.
x-ms-copy-source: url Version 2012-02-12 och senare. En URL på upp till 2 KiB som anger källbloben eller filen som användes i den senaste åtgärden Copy Blob där den här bloben var målbloben. Det här huvudet visas inte om den här bloben aldrig har varit målet i en Copy Blob åtgärd, eller om den här bloben har ändrats efter en slutförd Copy Blob åtgärd som använde Set Blob Properties, Put Blobeller Put Block List.

URL:en som returneras i det här huvudet innehåller alla begärandeparametrar som användes i kopieringsåtgärden på källbloben, inklusive den SAS-token (signatur för delad åtkomst) som användes för att komma åt källbloben.
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: Kopiering har slutförts.
- pending: Kopiering pågår. Kontrollera x-ms-copy-status-description om tillfälliga, icke-allvarliga fel saktar kopieringsförloppet men inte orsakar fel.
- aborted: Kopian avslutades av Abort Copy Blob.
- failed: Kopiering misslyckades. Information om fel finns i x-ms-copy-status-description.

Det här huvudet visas inte om den här bloben aldrig har varit målet i en Copy Blob åtgärd, eller om den här bloben har ändrats efter en slutförd Copy Blob åtgärd som använde Set Blob Properties, Put Blobeller Put Block List.
x-ms-lease-duration: <infinite | fixed> Version 2012-02-12 och senare. När en blob hyrs anger om lånet är av oändlig eller fast varaktighet.
x-ms-lease-state: <available | leased | expired | breaking | broken> Version 2012-02-12 och senare. Blobens lånetillstånd.
x-ms-lease-status:<locked | unlocked> Blobens aktuella lånestatus.
x-ms-request-id Identifierar begäran som gjordes unikt och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version Anger den Blob Storage-version som användes för att köra begäran. Ingår för begäranden som gjordes med 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 hjälp av Blob Storage version 2009-09-19.
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 2011-08-18 och senare, och för den lokala lagringstjänsten i SDK version 1.6 och senare.
Date Ett DATUM-/tidsvärde för UTC som genereras av tjänsten, vilket anger den tid då svaret initierades.
Access-Control-Allow-Origin Returneras om begäran innehåller ett Origin huvud och CORS är aktiverat med en matchande regel. Den här rubriken returnerar värdet för ursprungsbegärandehuvudet vid en matchning.
Access-Control-Expose-Headers Returneras om begäran innehåller ett Origin huvud och CORS är aktiverat med en matchande regel. Returnerar listan med svarshuvuden som ska exponeras för klienten eller utfärdaren av begäran.
Vary Returneras med värdet för Origin rubriken när CORS-regler anges. Mer information finns i CORS-stöd för Azure Storage-tjänsterna .
Access-Control-Allow-Credentials Returneras om begäran innehåller ett Origin huvud och CORS är aktiverat med en matchande regel som inte tillåter alla ursprung. Det här huvudet anges till true.
x-ms-blob-committed-block-count Antalet bekräftade 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 och senare. Värdet för den här rubriken anges till true om blobdata och programmetadata är helt krypterade med hjälp av den angivna algoritmen. Annars anges värdet till false (när bloben är okrypterad eller om endast delar av bloben eller programmetadata krypteras).
x-ms-encryption-key-sha256 Version 2019-02-02 och senare. Det här huvudet returneras om bloben är krypterad med en nyckel som tillhandahålls av kunden.
x-ms-encryption-context Version 2021-08-06 och senare. Om värdet för krypteringskontextegenskapen anges returneras det angivna värdet. Gäller endast när hierarkiskt namnområde är aktiverat för kontot.
x-ms-encryption-scope Version 2019-02-02 och senare. Det här huvudet returneras om bloben är krypterad med ett krypteringsomfång.
x-ms-blob-content-md5 Version 2016-05-31 och senare. Om bloben har en MD5-hash och begäran innehåller ett intervallhuvud (intervall eller x-ms-intervall) returneras det här svarshuvudet med värdet för hela blobens MD5-värde. Det här värdet kan vara lika med det värde som returneras i Content-MD5-huvudet, där det senare beräknas från det begärda intervallet.
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 x-ms-client-request-id för huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. x-ms-client-request-id Om rubriken inte finns i begäran finns inte det här huvudet i svaret.
x-ms-last-access-time Version 2020-02-10 och senare. Anger den senaste gången blobens data användes baserat på lagringskontots spårningsprincip för senaste åtkomsttid. Huvudet returneras inte om lagringskontot inte har någon spårningsprincip för senaste åtkomsttid eller om principen är inaktiverad. Information om hur du ställer in lagringskontots spårningsprincip för senaste åtkomsttid finns i Blob Service API.
x-ms-blob-sealed Version 2019-12-12 och senare. Returneras endast för tilläggsblobar. Om tilläggsbloben har förseglats är truevärdet . Mer information finns i Append Blob Seal
x-ms-immutability-policy-until-date Version 2020-06-12 och senare. Anger kvarhållningen fram till det datum som har 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änderlig princip har angetts för bloben. Värdet för det här huvudet är i RFC1123 format.
x-ms-immutability-policy-mode: unlocked/locked Version 2020-06-12 och senare. Returneras om en oföränderlighetsprincip har angetts för bloben. Värdena är unlocked och locked. unlocked anger att användaren kan ändra principen genom att öka eller minska kvarhållningen fram till datumet. locked anger att dessa åtgärder är förbjudna.
x-ms-legal-hold: true/false Version 2020-06-12 och senare. Det här huvudet returneras inte om det inte finns något lagligt undantag för bloben. Värdet för det här huvudet anges till true om bloben innehåller ett bevarande av juridiska skäl och dess värde är true. Annars anges värdet till false om bloben innehåller ett juridiskt undantag och dess värde är false.
x-ms-owner Version 2020-06-12 och senare, endast för konton med hierarkiskt namnområde aktiverat. Returnerar filens eller katalogens ägare-användare.
x-ms-group Version 2020-06-12 och senare, endast för konton med hierarkiskt namnområde aktiverat. Returnerar den ägande gruppen för filen eller katalogen.
x-ms-permissions Version 2020-06-12 och senare, endast för konton med hierarkiskt namnområde aktiverat. Returnerar behörighetsuppsättningen för "användare", "grupp" och "annan" i filen eller katalogen. Varje enskild behörighet är i [r,w,x,-]{3} -format.
x-ms-resource-type Version 2020-10-02 och senare, endast för konton med hierarkiskt namnområde aktiverat. Returnerar resurstypen för sökvägen, som kan vara antingen file eller directory.

Själva svaret

Svarstexten innehåller innehållet i bloben.

Exempelsvar

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
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

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

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, programtjänstens huvudnamn 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 Microsoft Entra ID.

Behörigheter

Nedan visas den RBAC-åtgärd som krävs för att en Microsoft Entra användare, grupp eller tjänstens huvudnamn ska kunna anropa Get Blob åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den här åtgärden:

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

Kommentarer

För en sidblob returnerar en Get Blob åtgärd över ett antal sidor som ännu inte har innehåll eller som har rensats nollor för dessa byte.

Om du anropar Get Blob en sidblob utan angivet intervall returnerar tjänsten sidintervallet upp till det angivna värdet för x-ms-blob-content-length rubriken. För alla sidor som saknar innehåll returnerar tjänsten nollor för dessa byte.

För en tilläggsblob Get Blob returnerar x-ms-blob-committed-block-count åtgärden huvudet. Det här huvudet anger antalet bekräftade block i bloben. Huvudet x-ms-blob-committed-block-count returneras inte för blockblobar eller sidblobar.

En Get Blob åtgärd tillåts att två minuter per MiB slutförs. Om åtgärden tar längre tid än två minuter per MiB i genomsnitt överskrider åtgärden tidsgränsen.

Huvudet x-ms-version krävs för att hämta en blob som tillhör en privat container. Om bloben tillhör en container som är tillgänglig för fullständig eller partiell offentlig åtkomst kan alla klienter läsa den utan att ange någon version. tjänstversionen krävs inte för att hämta en blob som tillhör en offentlig container. Mer information finns i Begränsa åtkomsten till containrar och blobar.

En Get Blob åtgärd på en arkiverad blockblob misslyckas.

Kopieringsåtgärder

För att avgöra om en Copy Blob åtgärd har slutförts kontrollerar du först att x-ms-copy-id huvudvärdet för målbloben matchar det kopierings-ID som tillhandahölls 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. Leta sedan efter x-ms-copy-status: success rubriken. Tänk dock på att alla skrivåtgärder på en blob utom Lease, Put Pageoch Put Block åtgärder tar bort alla x-ms-copy-* egenskaper från blobben. Dessa egenskaper kopieras inte heller av Copy Blob åtgärder som använder Blob Storage-versioner tidigare än 2012-02-12.

Varning

URL:en som returneras i x-ms-copy-source huvudet innehåller alla begärandeparametrar som användes i kopieringsåtgärden på källbloben. Om du använder en SAS-token för att komma åt källbloben visas sas-token i x-ms-copy-source huvudet när Get Blob anropas på målbloben.

När x-ms-copy-status: failed visas i svaret x-ms-copy-status-description innehåller mer information om felet Copy Blob .

De tre fälten för varje x-ms-copy-status-description värde beskrivs i följande tabell:

Komponent Beskrivning
HTTP-statuskod Ett standard-3-siffrigt heltal som anger felet.
Felkod Ett nyckelord som beskriver felet, 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 tresiffriga HTTP-statuskoden i HTTP-specifikationen. Se Vanliga REST API-felkoder.
Information En detaljerad beskrivning av felet, omgivet av citattecken.

Värdena x-ms-copy-status och x-ms-copy-status-description för vanliga felscenarier beskrivs i följande tabell:

Viktigt

Felbeskrivningarna i den här tabellen kan ändras utan varning, även utan en versionsändring, så de kanske inte matchar texten exakt.

Scenario x-ms-copy-status-värde x-ms-copy-status-description värde
Kopieringsåtgärden slutfördes. lyckades tomt
Användaren avbröt kopieringsåtgärden 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 försöka igen. Väntar 502 BadGateway "Påträffade ett nytt försöksfel när källan lästes. Försöker igen. Feltid: <tid>"
Ett fel uppstod vid skrivning till målbloben för en kopieringsåtgärd, men åtgärden kommer att försöka igen. Väntar 500 InternalServerError "Påträffade ett nytt försöksfel. Försöker igen. Feltid: <tid>"
Ett oåterkalleligt fel uppstod vid läsning från källbloben för en kopieringsåtgärd. misslyckades 404 ResourceNotFound "Kopiering misslyckades när källan lästes".

Observera: När tjänsten rapporterar det här underliggande felet returneras ResourceNotFound det i -elementet ErrorCode . Om inget ErrorCode element visas i svaret visas en standardsträngrepresentation av HTTP-status, till exempel NotFound, .
Tidsgränsen som begränsar alla kopieringsåtgärder som har förflutit. (Tidsgränsen är för närvarande 2 veckor.) misslyckades 500 OperationCancelled "Kopian överskred den maximala tillåtna tiden."
Kopieringsåtgärden misslyckades för ofta vid läsning från källan och uppfyllde inte det minsta förhållandet mellan försök och lyckade försök. (Den här tidsgränsen förhindrar att en mycket dålig källa försöker igen under två veckor innan den misslyckas). misslyckades 500 OperationCancelled "Kopian misslyckades när källan lästes".

x-ms-last-access-time spårar tiden då blobens data användes baserat på lagringskontots spårningsprincip för senaste åtkomsttid. Åtkomst till metadata för en blob ändrar inte den senaste åtkomsttiden.

Fakturering

Prisbegäranden kan komma från klienter som använder Blob Storage-API:er, antingen direkt via REST-API:et för Blob Storage eller från ett Azure Storage-klientbibliotek. Dessa begäranden ackumulerar avgifter per transaktion. Typen av transaktion påverkar hur kontot debiteras. Lästransaktioner till exempel tillfaller en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för Get Blob begäranden baserat på lagringskontotypen:

Åtgärd Typ av lagringskonto Faktureringskategori
Hämta blob Premium-blockblob
Standard generell användning v2
Standard generell användning v1		 Läsåtgärder

Mer information om priser för den angivna faktureringskategorin finns i Azure Blob Storage Prissättning.

Se även

Auktorisera begäranden till Azure Storage
Status- och felkoder
Felkoder för Blob Storage
Ange tidsgränser för Blob Storage-åtgärder