Hämta blobegenskaper
Åtgärden Get Blob Properties
returnerar alla användardefinierade metadata, HTTP-standardegenskaper och systemegenskaper för bloben. Den returnerar inte innehållet i bloben.
Förfrågan
Du kan skapa begäran på Get Blob Properties
följande sätt. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto.
URI för HEAD-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.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 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-emulatorn för utveckling och testning.
URI-parametrar
Du kan ange följande ytterligare parametrar på begärande-URI:n:
Parameter | Beskrivning |
---|---|
snapshot |
Valfritt. Parametern snapshot är ett täckande DateTime värde som när den finns anger blobögonblicksbilden 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 när den finns anger vilken version av bloben som ska hämtas. |
timeout |
Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ställa in 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. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
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 uppfylls:– Blobens lån är för närvarande aktivt. – Låne-ID:t som anges i begäran matchar låne-ID:t för bloben. Om något av dessa villkor inte uppfylls misslyckas begäran och Get Blob Properties åtgärden misslyckas med statuskod 412 (Förhandsvillkoret misslyckades). |
x-ms-upn |
Valfritt. Version 2020-06-12 och senare. Giltigt för konton med hierarkiskt namnområde aktiverat. Om det är sant omvandlas användaridentitetsvärdena som returneras i - och x-ms-acl -svarshuvudena x-ms-owner x-ms-group från Microsoft Entra objekt-ID:t till användarens huvudnamn. Om värdet är falskt returneras de som Microsoft Entra objekt-ID:t. Standardvärdet är falskt. Observera att grupp- och programobjekt-ID:na 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 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 returnera blobegenskaper och metadata endast 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 i 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 valfritt. Om en blob tidigare har krypterats med en nyckel från kunden måste du inkludera dessa huvuden i begäran så att läsåtgärden kan slutföras.
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 och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskod 200 (OK).
Mer information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller rubrikerna i följande tabell. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.
Svarsrubrik | Description |
---|---|
Last-Modified |
Datum/tid då bloben senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representera datum-/tidsvärden i rubriker. 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. Mer information finns i Representera datum-/tidsvärden i rubriker. |
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 och senare. Om bloben har några taggar returnerar du 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. Sluttid 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 avslutad Copy Blob åtgärd som använder Set Blob Properties , Put Blob eller 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-dödligt kopieringsfel. 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 avslutad Copy Blob åtgärd som använder Set Blob Properties , Put Blob eller Put Block List . |
x-ms-copy-id: <id> |
Version 2012-02-12 och senare. Strängidentifieraren 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 avslutad Copy Blob åtgärd som använder Set Blob Properties , Put Blob eller Put Block List . |
x-ms-copy-progress: <bytes copied/bytes total> |
Version 2012-02-12 och senare. Innehåller antalet kopierade byte och det totala antalet byte i källan i den senaste åtgärden Copy Blob , där den här bloben var målbloben. Kan visas 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 avslutad Copy Blob åtgärd som använder Set Blob Properties , Put Blob eller Put Block List . |
x-ms-copy-source: url |
Version 2012-02-12 och senare. En URL på upp till 2 KiB som anger den källblob 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 avslutad Copy Blob åtgärd som använder Set Blob Properties , Put Blob eller 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 : Kopiering har slutförts.- pending : Kopiering 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 av Abort Copy Blob .- failed : Kopiering misslyckades. Se x-ms-copy-status-description för felinformation.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änder Set Blob Properties , Put Blob eller Put Block List . |
x-ms-incremental-copy: true |
Version 2016-05-31 och senare. Ingår om bloben är en inkrementell kopieringsblob. |
x-ms-copy-destination-snapshot:<datetime> |
Version 2016-05-31 och senare. Ingår om bloben är en inkrementell kopieringsblob eller inkrementell kopiaögonblicksbild, om x-ms-copy-status det lyckas. Ögonblicksbildstid för den senaste lyckade inkrementella kopieringsögonblicksbilden för den här blobben. |
x-ms-lease-duration: <infinite \| fixed> |
När en blob leasas anger om lånet är av 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> |
Blobens lånetillstånd. Ingår för begäranden som använder version 2012-02-12 och senare. |
x-ms-lease-status:<locked\| unlocked> |
Blobens lånestatus. |
Content-Length |
Storleken på bloben i byte. För en sidblob returnerar det här huvudet värdet för x-ms-blob-content-length huvudet som lagras med bloben. |
Content-Type |
Den innehållstyp som har angetts för bloben. Om ingen innehållstyp anges är application/octet-stream standardinnehållstypen . |
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 rubriker för Blob Storage-åtgärder. Om begärandeversionen är 2011-08-18 eller senare omges ETag-värdet av citattecken. |
Content-MD5 |
Content-MD5 Om rubriken har angetts för blobben returneras det här svarshuvudet så att klienten kan söka efter meddelandeinnehållsintegritet.I version 2012-02-12 och senare Put Blob anger en blockblobs MD5-värde även om Put Blob begäran inte innehåller ett MD5-huvud. |
Content-Encoding |
Content-Encoding Om begärandehuvudet tidigare har angetts för blobben returneras det värdet i det här huvudet. |
Content-Language |
Content-Language Om begärandehuvudet tidigare har angetts för blobben returneras det värdet i det här huvudet. |
Content-Disposition |
Content-Disposition Om begärandehuvudet tidigare har angetts för blobben returneras det värdet i det här huvudet för begäranden mot version 2013-08-15 och senare.Fältet Content-Disposition svarshuvud förmedlar ytterligare information om hur du bearbetar svarsnyttolasten och kan även användas för att bifoga ytterligare metadata. Om rubriken till exempel är inställd på attachment anger det att användaragenten inte ska visa svaret, utan i stället visa en Spara som-dialogruta. |
Cache-Control |
Cache-Control Om begärandehuvudet tidigare har angetts för blobben 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 den begäran som gjordes och du kan använda den 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ä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 hjälp av Blob Storage version 2009-09-19. |
Date |
Ett UTC-datum/tid-värde som genererats av tjänsten som anger den tid då 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 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 det här huvudet anges till true om blobdata och programmetadata är helt krypterade med den angivna algoritmen. Annars anges värdet till false (när bloben är okrypterad eller om endast delar av blob-/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-access-tier |
Version 2017-04-17 och senare. Nivån för sidblob på ett Premium Storage konto eller nivå för en blockblob i ett Blob Storage- eller generell användning v2-konto. En lista över tillåtna premium-sidblobnivåer 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 Hot giltiga värden , Cool , Cold och Archive .
Observera:Cold nivå stöds för version 2021-12-02 och senare. Detaljerad information om blocknivåindelning för standardblobkonton finns i Lagringsnivåer för frekvent, lågfrekvent lagring 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 anges på bloben härleds nivån baserat på dess innehållslängd och det här huvudet returneras med värdet true . För blockblobar på Blob Storage eller ett v2-konto för generell användning kan du härleda nivån från lagringskontots egenskaper om bloben inte har angett åtkomstnivån. Det här huvudet anges endast om blockblobnivån härleds. |
x-ms-archive-status |
Version 2017-04-17 och senare. För bloblagring eller v2-konto för generell användning är rehydrate-pending-to-hot giltiga värden , rehydrate-pending-to-cool och rehydrate-pending-to-cold . Om bloben håller på att extraheras och är ofullständig returneras det här huvudet, vilket båda anger att rehydraten väntar och visar målnivån. Detaljerad information om standardnivåindelning för blobkontoblock på blobnivå finns i Lagringsnivåer för frekvent, lågfrekvent lagring och arkivlagring. |
x-ms-access-tier-change-time |
Version 2017-04-17 och senare. Anger senaste gången nivån ändrades för objektet. Det här huvudet returneras endast om en nivå på blockblob någonsin har angetts. Datumformatet följer RFC 1123. Mer information finns i Representera datum/tid-värden i rubriker. Mer information om standardnivåindelning för blobkontoblock på blobnivå finns i Lagringsnivåer för frekvent, lågfrekvent lagring och arkivlagring. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och deras 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 är högst 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-rehydrate-priority |
Version 2019-12-12 och senare. Om ett objekt är i väntande tillstånd returneras det här huvudet med rehydratprioritet. Giltiga värden är High /Standard . Detaljerad information om blocknivåindelning för standardblobkonton finns i Lagringsnivåer för frekvent, lågfrekvent lagring och arkivlagring. |
x-ms-or-{policy-id}_{rule-id} |
Version 2019-12-12 och 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 ObjectReplication -aktiverat representerar värdet för det här huvudet replikeringsstatusen för blob med den angivna principen och regelidentifierare, antingen complete eller failed . |
x-ms-or-policy-id |
Version 2019-12-12 och 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 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 anger lagringskontots spårningsprincip för senaste åtkomsttid finns i Blob Storage API. |
x-ms-blob-sealed |
Version 2019-12-12 och senare, returneras endast för tilläggsblobar. Om tilläggsbloben har förseglats är värdet sant. Mer information finns i Append Blob Seal |
x-ms-immutability-policy-until-date |
Version 2020-06-12 och senare. Anger datumet "kvarhållning tills" som angetts på 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 RFC1123 format. |
x-ms-immutability-policy-mode: unlocked/locked |
Version 2020-06-12 och senare. Det oföränderliga principläget returneras om en oföränderlighetsprincip har angetts på blobben. 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 och senare. Det här huvudet returneras inte om det inte finns något juridiskt undantag för bloben. Värdet för det här huvudet är inställt på sant om bloben innehåller ett bevarande av juridiska skäl och dess värde är sant. Annars anges värdet till false om bloben innehåller ett bevarande av juridiska skäl och värdet falskt. |
x-ms-owner |
Version 2020-06-12 och senare. Endast för konton med hierarkiskt namnområde aktiverat. Returnerar ägaranvändaren för filen eller katalogen. |
x-ms-group |
Version 2020-06-12 och senare. Endast för konton med hierarkiskt namnområde aktiverat. Returnerar ägargruppen för filen eller katalogen. |
x-ms-permissions |
Version 2020-06-12 och senare. Endast för konton med hierarkiskt namnområde aktiverat. Returnerar de behörigheter som har angetts för användare, grupper och andra i filen eller katalogen. Varje enskild behörighet är i [r,w,x,-]{3} format. |
x-ms-acl |
Version 2023-11-03 och senare. Endast för konton med hierarkiskt namnområde aktiverat. Returnerar den kombinerade listan över åtkomst- och standardåtkomstkontrollistan som har angetts för användare, grupp och annat i filen eller katalogen. Varje åtkomstkontrollpost (ACE) består av ett omfång, en typ, en användare eller gruppidentifierare och behörigheter i formatet [scope]:[type]:[id]:[permissions] . Omfånget default anger att ACE tillhör standard-ACL:en för en katalog. Annars är omfånget implicit och ACE tillhör åtkomst-ACL:en. 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 ett hierarkiskt namnområde aktiverat. Returnerar resurstypen för sökvägen, som kan vara antingen file eller directory . |
x-ms-expiry-time |
Version 2020-02-10 och senare. Endast för konton med ett hierarkiskt namnområde aktiverat. Returnerar den förfallotid som anges på bloben. Returneras endast för filer som har en angiven förfallotid. |
Själva svaret
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
Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden enligt beskrivningen Get Blob Properties
nedan.
Viktigt
Microsoft rekommenderar att du använder Microsoft Entra ID med hanterade identiteter för att auktorisera begäranden till Azure Storage. Microsoft Entra ID ger överlägsen säkerhet och användarvänlighet jämfört med auktorisering av delad nyckel.
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, hanterad identitet eller tjänstens huvudnamn ska anropa Get Blob Properties
åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som inkluderar den här åtgärden:
- Azure RBAC-åtgärd:Microsoft.Storage/storageAccounts/blobServices/containers/blobar/read
- Minst privilegierad inbyggd roll:Storage Blob Data Reader
Mer information om hur du tilldelar roller med Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.
Kommentarer
Om du vill ta reda på om en Copy Blob
åtgärd har slutförts kontrollerar du först att x-ms-copy-id
rubrikvärdet 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 startade 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 Page
och Put Block
-åtgärder tar bort alla x-ms-copy-*
egenskaper från bloben. Dessa egenskaper kopieras inte heller av Copy Blob
åtgärder som använder tidigare versioner än 2012-02-12.
x-ms-copy-status-description
innehåller mer information om felet Copy Blob
. Värdena x-ms-copy-status-description
beskrivs i följande tabell:
Komponent | Beskrivning |
---|---|
HTTP-statuskod | Ett 3-siffrigt standardheltal 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 med standardfeltext som är associerad med den tresiffriga HTTP-statuskoden i HTTP-specifikationen. Mer information finns i Vanliga REST API-felkoder. |
Information | Detaljerad beskrivning av felet, inom citattecken. |
Värdena x-ms-copy-status
och x-ms-copy-status-description
för vanliga felscenarier beskrivs i följande tabell:
Viktigt
Följande felbeskrivningar kan ändras utan varning, även utan en versionsändring, så texten kanske inte matchar exakt.
Scenario | x-ms-copy-status-värde | x-ms-copy-status-description-value |
---|---|---|
Kopieringsåtgärden har slutförts. | 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 återförsöksbart fel 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 återförsöksbart fel. 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". Obs! När tjänsten rapporterar det här underliggande felet returneras ResourceNotFound det <i ErrorCode-elementet> . Om inget <ErrorCode-element> visas i svaret visas en standardsträngrepresentation av HTTP-statusen, till exempel NotFound , . |
Tidsgränsen som begränsar alla kopieringsåtgärder som har förflutit. (För närvarande är tidsgränsen två 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 den uppfyllde inte det minsta förhållandet mellan 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 två veckor innan den misslyckas). | misslyckades | 500 OperationCancelled "Kopieringen 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. Åtkomsten till en blobs metadata ä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 ackumuleras till exempel till en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för Get Blob Properties
begäranden baserat på lagringskontotypen:
Åtgärd | Typ av lagringskonto | Faktureringskategori |
---|---|---|
Hämta blobegenskaper | Premium-blockblob Standard generell användning v2 |
Andra åtgärder |
Hämta blobegenskaper | 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