Hämta blobegenskaper

Artikel
03/16/2023

Å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:10000fö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 de användaridentitetsvärden som returneras i `x-ms-owner` är sanna omvandlas de från Microsoft Entra objekt-ID:t till användarens huvudnamn. Om värdena är falska 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 ett 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 ett 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 ett 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-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.

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 Properties åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller 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.

En signatur för delad åtkomst (SAS) ger säker delegerad åtkomst till resurser i ett lagringskonto. Med en SAS har du detaljerad kontroll över hur en klient kan komma åt data. Du kan ange vilken resurs klienten kan komma åt, vilka behörigheter de har till dessa resurser och hur länge SAS är giltigt.

Åtgärden Get Blob Properties stöder tre typer av signaturer för delad åtkomst: SAS för användardelegering, sas för tjänsten och konto-SAS.

Vi rekommenderar att du använder Microsoft Entra autentiseringsuppgifter i stället för lagringskontonyckeln, vilket är enklare att kompromettera. Om din programdesign kräver signaturer för delad åtkomst använder du Microsoft Entra autentiseringsuppgifter för att skapa en SAS för användardelegering när det är möjligt.

När åtkomst med delad nyckel inte tillåts för lagringskontot tillåts inte en SAS-token för tjänsten eller en SAS-kontotoken för en begäran till Blob Storage. Mer information finns i Förstå hur nekande av delad nyckel påverkar SAS-token.

SAS för användardelegering

En SAS för användardelegering skyddas med Microsoft Entra autentiseringsuppgifter och även av de behörigheter som anges för SAS.

Get Blob Properties Att anropa åtgärden med hjälp av en SAS-token som delegerats till en container eller blobresurs kräver läsbehörighet (r) som en del av SAS-token för användardelegering.

Mer information om SAS för användardelegering finns i Skapa en SAS för användardelegering.

Tjänst-SAS

En tjänst-SAS skyddas med lagringskontonyckeln. En tjänst-SAS delegerar åtkomst till en resurs i en enda Azure Storage-tjänst, till exempel bloblagring.

Get Blob Properties Att anropa åtgärden med hjälp av en SAS-token som delegerats till en container eller blobresurs kräver läsbehörighet (r) som en del av tjänstens SAS-token.

Mer information om sas-tjänsten finns i Skapa en tjänst-SAS.

Konto-SAS

Ett SAS-konto skyddas med lagringskontonyckeln. En konto-SAS delegerar åtkomst till resurser i en eller flera av lagringstjänsterna. Alla åtgärder som är tillgängliga via en tjänst eller sas för användardelegering är också tillgängliga via ett konto-SAS.

Följande tabell anger den signerade resurstypen och signerade behörigheter som ska anges när åtkomst delegeras:

Åtgärd	Signerad tjänst	Signerad resurstyp	Signerad behörighet
Hämta blobegenskaper	Blob (b)	Objekt (o)	Läsa (r)

Mer information om kontots SAS finns i Skapa ett konto-SAS.

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 Pageoch 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