Dela via

Placera blob

  • Artikel

Åtgärden Put Blob skapar ett nytt block, en sida eller en tilläggsblob eller uppdaterar innehållet i en befintlig blockblob. Åtgärden Put Blob skriver över allt innehåll i en befintlig blob med samma namn.

När du uppdaterar en befintlig blockblob skriver du över alla befintliga metadata på bloben. Innehållet i den befintliga bloben skrivs över med innehållet i den nya bloben. Partiella uppdateringar stöds inte med Put Blob. Om du vill utföra en partiell uppdatering av innehållet i en blockblob använder du åtgärden Placera blocklista .

Du kan skapa en tilläggsblob i versionerna 2015-02-21 och senare.

Ett anrop till en Put Blob för att skapa en sidblob eller en tilläggsblob initierar bara bloben. Om blobben redan finns rensas innehållet. Om du vill lägga till innehåll i en sidblob anropar du put page-åtgärden . Om du vill lägga till innehåll i en tilläggsblob anropar du åtgärden Lägg till block .

Förfrågan

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

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

Emulerad lagringstjänstbegäran

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

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

Lagringsemulatorn stöder endast blobstorlekar på upp till 2 gibibyte (GiB).

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

URI-parametrar

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

Parameter Beskrivning
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för blobtjänståtgärder.

Begärandehuvuden (alla blobtyper)

De obligatoriska och valfria begärandehuvudena för alla blobtyper beskrivs i följande tabell:

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. 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.
Content-Length Krävs. Längden på begäran.

För en sidblob eller en tilläggsblob måste värdet för det här huvudet anges till noll, eftersom Put Blob endast används för att initiera bloben. Om du vill skriva innehåll till en befintlig sidblob anropar du Placera sida. Om du vill skriva innehåll till en tilläggsblob anropar du Tilläggsblock.
Content-Type Valfritt. MIME-innehållstypen för bloben. Standardtypen är application/octet-stream.
Content-Encoding Valfritt. Anger vilka innehållskodningar som har tillämpats på bloben. Det här värdet returneras till klienten när åtgärden Hämta blob utförs på blobresursen. När det här värdet returneras kan klienten använda det för att avkoda blobinnehållet.
Content-Language Valfritt. Anger de naturliga språk som används av den här resursen.
Content-MD5 Valfritt. En MD5-hash för blobinnehållet. Den här hashen används för att verifiera blobens integritet under transporten. När det här huvudet anges kontrollerar lagringstjänsten den hash som har anlänt mot den som skickades. Om de två hashvärdena inte matchar misslyckas åtgärden med felkoden 400 (felaktig begäran).

När rubriken utelämnas i version 2012-02-12 eller senare genererar Blob Storage en MD5-hash.

Resultat från Hämta blob, Hämta blobegenskaper och Listblobar inkluderar MD5-hashen.
x-ms-content-crc64 Valfritt. En CRC64-hash för blobinnehållet. Den här hashen används för att verifiera blobens integritet under transporten. När det här huvudet anges kontrollerar lagringstjänsten den hash som har anlänt mot den som skickades. Om de två hashvärdena inte matchar misslyckas åtgärden med felkoden 400 (felaktig begäran). Det här huvudet stöds i versionerna 02-02-2019 och senare.

Om både Content-MD5- och x-ms-content-crc64-huvuden finns misslyckas begäran med 400 (felaktig begäran).
Cache-Control Valfritt. Blob Storage lagrar det här värdet men använder eller ändrar det inte.
x-ms-blob-content-type Valfritt. Ange blobens innehållstyp.
x-ms-blob-content-encoding Valfritt. Ange blobens innehållskodning.
x-ms-blob-content-language Valfritt. Ange blobens innehållsspråk.
x-ms-blob-content-md5 Valfritt. Ange blobens MD5-hash. För BlockBlob har det här huvudet företräde framför Content-MD5 när du verifierar blobens integritet under transporten. För PageBlob och AppendBlob anger det här huvudet direkt blobens MD5-hash.
x-ms-blob-cache-control Valfritt. Anger blobens cachekontroll.
x-ms-blob-type: <BlockBlob ¦ PageBlob ¦ AppendBlob> Krävs. Anger vilken typ av blob som ska skapas: blockblob, sidblob eller tilläggsblob. Stöd för att skapa en tilläggsblob är endast tillgängligt i version 2015-02-21 och senare.
x-ms-meta-name:value Valfritt. Namn/värde-par som är associerade med bloben som metadata.

Obs! Från och med version 2009-09-19 måste metadatanamn följa namngivningsreglerna för C#-identifierare.
x-ms-encryption-scope Valfritt. Anger krypteringsomfånget som ska användas för att kryptera innehållet i begäran. Det här huvudet stöds i versionerna 2019-02-02 och senare.
x-ms-encryption-context Valfritt. Standardvärdet är "Tom". Om värdet anges anges blobsystemmetadata. Max längd-1024. Gäller endast när hierarkiskt namnområde är aktiverat för kontot. Det här huvudet stöds i versionerna 2021-08-06 och senare.
x-ms-tags Valfritt. Anger de angivna frågesträngskodade taggarna på bloben. Mer information finns i Kommentarer. Stöds i version 2019-12-12 och senare.
x-ms-lease-id:<ID> Krävs om bloben har ett aktivt lån. Om du vill utföra den här åtgärden på en blob med ett aktivt lån anger du det giltiga låne-ID:t för det här huvudet.
x-ms-blob-content-disposition Valfritt. Anger blobens Content-Disposition sidhuvud. Tillgänglig för versionerna 2013-08-15 och senare.

Fältet Content-Disposition svarshuvud förmedlar ytterligare information om hur du bearbetar svarsnyttolasten och du kan använda den för att bifoga ytterligare metadata. Om rubriken till attachmentexempel är inställd på anger det att användaren-agenten inte ska visa svaret. I stället bör dialogrutan Spara som visas med ett annat filnamn än det angivna blobnamnet.

Svaret från åtgärderna Hämta blobb - och Hämta blobegenskaper innehåller content-disposition huvudet.
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. Mer information finns i CORS-stöd för Azure Storage-tjänsterna.
x-ms-client-request-id Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en kibibyte-teckengräns (KiB) som registreras i analysloggarna när loggning konfigureras. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Om loggning av lagringsanalys.
x-ms-access-tier Valfritt. Den nivå som ska anges på bloben. För sidblobar på ett Premium Storage konto endast med version 2017-04-17 och senare. En fullständig lista över nivåer som stöds av sidblob finns i Premium-lagring med höga prestanda och hanterade diskar för virtuella datorer .) För blockblobar stöds endast på bloblagringskonton eller v2-konton för generell användning med version 2018-11-09 och senare. Giltiga värden för blockblobnivåer är Hot, Cool, Coldoch Archive. Cold Obs! Nivån stöds för version 2021-12-02 och senare. Detaljerad information om blockblobnivåer finns i Frekvent, lågfrekvent och arkivlagringsnivåer.
x-ms-immutability-policy-until-date Version 2020-06-12 och senare. Anger det kvarhållningsdatum som ska anges på bloben. Det här är det datum då bloben kan skyddas från att ändras eller tas bort. Följer RFC1123 format.
x-ms-immutability-policy-mode Version 2020-06-12 och senare. Anger det oföränderlighetsprincipläge som ska anges på bloben. Giltiga värden är unlocked och locked. Med unlockedkan användare ändra principen genom att öka eller minska kvarhållningsdatumet tills dess. Med lockedär dessa åtgärder förbjudna.
x-ms-legal-hold Version 2020-06-12 och senare. Anger det juridiska undantag som ska anges för bloben. Giltiga värden är true och false.
x-ms-expiry-option Valfritt. Version 2023-08-03 och senare. Anger alternativet för förfallodatum för begäran. Mer information finns i ExpiryOption. Det här huvudet är giltigt för konton med hierarkiskt namnområde aktiverat.
x-ms-expiry-time Valfritt. Version 2023-08-03 och senare. Anger den tid då blobben är inställd på att upphöra att gälla. Formatet för förfallodatum varierar beroende på x-ms-expiry-option. Mer information finns i ExpiryOption. Det här huvudet är giltigt för konton med hierarkiskt namnområde aktiverat.

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

Begärandehuvuden (endast sidblobar)

De begärandehuvuden som endast gäller för åtgärder på sidblobar beskrivs i följande tabell:

Begärandehuvud Beskrivning
x-ms-blob-content-length: bytes Krävs för sidblobar. Det här huvudet anger den maximala storleken för sidbloben, upp till 8 tebibyte (TiB). Sidblobens storlek måste justeras till en gräns på 512 byte.

Om det här huvudet anges för en blockblob eller en tilläggsblob returnerar Blob Storage statuskod 400 (felaktig begäran).
x-ms-blob-sequence-number: <num> Valfritt. Ange endast för sidblobar. Sekvensnumret är ett användarstyrt värde som du kan använda för att spåra begäranden. Värdet för sekvensnumret måste vara mellan 0 och 2^63 – 1. Standardvärdet är 0.
x-ms-access-tier Version 2017-04-17 och senare. Endast för sidblobar på ett Premium Storage-konto. Anger den nivå som ska anges på bloben. En fullständig lista över nivåer som stöds finns i Premium-lagring med höga prestanda och hanterade diskar för virtuella datorer.
x-ms-client-request-id Det här huvudet kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet 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 visas den inte i svaret.

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

Från och med version 2019-02-02 kan följande rubriker anges på begäran om att kryptera en blob med en kundtilldelad nyckel. Kryptering med en nyckel som tillhandahålls av kunden (och motsvarande uppsättning rubriker) är valfri.

Begärandehuvud Beskrivning
x-ms-encryption-key Krävs. Den Base64-kodade AES-256-krypteringsnyckeln.
x-ms-encryption-key-sha256 Krävs. 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

För en blockblob innehåller begärandetexten innehållet i bloben.

För en sidblob eller en tilläggsblob är begärandetexten tom.

Exempelbegäran

I följande exempel visas en begäran om att skapa en blockblob:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 11  
  
Request Body:  
hello world

Den här exempelbegäran skapar en sidblob och anger dess maximala storlek som 1 024 byte. Om du vill lägga till innehåll i en sidblob måste du anropa Placera sida:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/mypageblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: PageBlob  
x-ms-blob-content-length: 1024  
x-ms-blob-sequence-number: 0  
Authorization: SharedKey   
Origin: http://contoso.com  
Vary: Origin  
myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

Den här exempelbegäran skapar en tilläggsblob. Om du vill lägga till innehåll i tilläggsbloben måste du anropa Tilläggsblock:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myappendblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: AppendBlob  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Origin: http://contoso.com  
Vary: Origin  
Content-Length: 0

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskoden 201 (skapad).

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

Svarsrubrik Description
ETag Innehåller ett värde som klienten kan använda för att utföra villkorsstyrda PUT åtgärder med hjälp av begärandehuvudet If-Match . Om begärandeversionen är 2011-08-18 eller senare omges ETag-värdet av citattecken.
Last-Modified Datum/tid då bloben senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representera datum/tid-värden i rubriker.

Alla skrivåtgärder på bloben (inklusive uppdateringar av blobens metadata eller egenskaper) ändrar blobens senast ändrade tid.
Content-MD5 Returneras för en blockblob så att klienten kan kontrollera integriteten för meddelandeinnehållet. Värdet Content-MD5 som returneras beräknas av Blob Storage. I version 2012-02-12 och senare returneras det här huvudet även när begäran inte innehåller Content-MD5 eller x-ms-blob-content-md5 rubriker.
x-ms-content-crc64 Returneras för en blockblob så att klienten kan kontrollera integriteten för meddelandeinnehållet. Värdet x-ms-content-crc64 som returneras beräknas av Blob Storage. Det här huvudet returneras alltid från och med version 2019-02-02.
x-ms-request-id Identifierar begäran som gjordes unikt 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ändes för att köra begäran. Returneras för begäranden mot version 2009-09-19 och senare.
Date Ett UTC-datum/tid-värde 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. Det här huvudet returnerar värdet för ursprungsbegärans huvud om det finns 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 över svarshuvuden som ska exponeras för klienten eller utfärdaren av begäran.
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 är inställt på sant.
x-ms-request-server-encrypted: true/false Version 2015-12-11 och senare. Värdet för det här huvudet anges till true om innehållet i begäran har krypterats med hjälp av den angivna algoritmen. Annars är falsevärdet .
x-ms-encryption-key-sha256 Version 2019-02-02 och senare. Returneras om begäran använde en kundtilldelad nyckel för kryptering, så att klienten kan se till att innehållet i begäran krypteras med hjälp av den angivna nyckeln.
x-ms-encryption-scope Version 2019-02-02 och senare. Returneras om begäran använde ett krypteringsomfång, så att klienten kan se till att innehållet i begäran har krypterats med hjälp av krypteringsomfånget.
x-ms-version-id: <DateTime> Version 2019-12-12 och senare. Det här huvudet returnerar ett täckande DateTime värde som unikt identifierar bloben. Värdet för det här huvudet anger blobens version och kan användas i efterföljande begäranden för att komma åt bloben.

Själva svaret

Inga.

Exempelsvar

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>

Auktorisering

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

Om en begäran anger taggar med x-ms-tags begärandehuvudet måste anroparen uppfylla auktoriseringskraven för åtgärden Ange blobtaggar .

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 Put Blob åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som inkluderar 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

När du skapar en blob måste du ange om det är en blockblob, tilläggsblob eller sidblob genom att ange värdet för x-ms-blob-type huvudet. När en blob har skapats kan inte typen av blob ändras om den inte tas bort och återskapas.

I följande tabell beskrivs de högsta tillåtna block- och blobstorlekarna efter tjänstversion:

Tjänstversion Maximal blockstorlek (via Put Block) Maximal blobstorlek (via Put Block List) Maximal blobstorlek via en enda skrivåtgärd (via Put Blob)
Version 2019-12-12 och senare 4 000 mebibyte (MiB) Cirka 190,7 TiB (4 000 MiB × 50 000 block) 5 000 MiB
Versioner 2016-05-31 till och med 2019-07-07 100 MiB Cirka 4,75 TiB (100 MiB × 50 000 block) 256 MiB
Tidigare versioner än 2016-05-31 4 MiB Cirka 195 GiB (4 MiB × 50 000 block) 64 MiB

Om du försöker ladda upp antingen en blockblob som är större än den maximala tillåtna storleken för den tjänstversionen eller en sidblob som är större än 8 TiB returnerar tjänsten statuskod 413 (Begärandeentiteten är för stor). Blob Storage returnerar också ytterligare information om felet i svaret, inklusive den maximala tillåtna blobstorleken, i byte.

Om du vill skapa en ny sidblob initierar du först bloben genom att anropa Put Bloboch anger sedan dess maximala storlek, upp till 8 TiB. När du skapar en sidblob ska du inte inkludera innehåll i begärandetexten. När bloben har skapats anropar du Put Page för att lägga till innehåll i bloben eller ändra den.

Om du vill skapa en ny tilläggsblob anropar du Put Blob för att skapa den med en innehållslängd på 0 byte. När tilläggsbloben har skapats anropar du Lägg till block för att lägga till innehåll i slutet av den.

Om du anropar Put Blob för att skriva över en befintlig blob med samma namn behålls alla ögonblicksbilder som är associerade med den ursprungliga bloben. Om du vill ta bort associerade ögonblicksbilder anropar du först Ta bort blob och anropar Put Blob sedan för att återskapa bloben.

Anpassade blobegenskaper

En blob har anpassade egenskaper (anges via rubriker) som du kan använda för att lagra värden som är associerade med HTTP-standardhuvuden. Därefter kan du läsa dessa värden genom att anropa Hämta blobegenskaper eller ändra dem genom att anropa Ange blobegenskaper. De anpassade egenskapsrubrikerna och motsvarande STANDARD HTTP-huvud visas i följande tabell:

HTTP-huvud Anpassat blobegenskapshuvud
Content-Type x-ms-blob-content-type
Content-Encoding x-ms-blob-content-encoding
Content-Language x-ms-blob-content-language
Content-MD5 x-ms-blob-content-md5
Cache-Control x-ms-blob-cache-control

Semantiken för att ange eller spara dessa egenskapsvärden med bloben är följande:

  • Om klienten anger ett anpassat egenskapshuvud, enligt prefixet x-ms-blob , lagras det här värdet med bloben.

  • Om klienten anger ett STANDARD-HTTP-huvud, men inte det anpassade egenskapshuvudet, lagras värdet i motsvarande anpassade egenskap som är associerad med bloben och returneras av ett anrop till Get Blob Properties. Om klienten till exempel anger Content-Type huvudet på begäran lagras det värdet i blobens x-ms-blob-content-type egenskap.

  • Om klienten anger både http-standardrubriken och motsvarande egenskapsrubrik på samma begäran använder PUT-begäran det värde som anges för http-standardrubriken, men värdet som anges för det anpassade egenskapshuvudet sparas med bloben och returneras av efterföljande GET-begäranden.

Om taggar anges i x-ms-tags huvudet måste de vara frågesträngskodade. Taggnycklar och värden måste överensstämma med namngivnings- och längdkraven som anges i Set Blob Tags. x-ms-tags Dessutom kan rubriken innehålla upp till 2 kB taggar. Om fler taggar krävs använder du åtgärden Ange blobtaggar .

Om bloben har ett aktivt lån måste klienten ange ett giltigt låne-ID för begäran för att skriva över bloben. Om klienten inte anger något låne-ID eller anger ett ogiltigt låne-ID returnerar Blob Storage statuskoden 412 (villkoret misslyckades). Om klienten anger ett låne-ID men bloben inte har något aktivt lån returnerar Blob Storage även statuskoden 412 (villkoret misslyckades). Om klienten anger ett låne-ID på en blob som ännu inte finns returnerar Blob Storage statuskod 412 (villkorsfel) för begäranden som görs mot version 2013-08-15 och senare. För tidigare versioner än 2013-08-15 returnerar Blob Storage statuskoden 201 (skapad).

Om en befintlig blob med ett aktivt lån skrivs över av en Put Blob åtgärd behålls lånet på den uppdaterade bloben tills den upphör att gälla eller släpps.

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

Det går inte att skriva över en archive blob och om du skriver över en hot eller cool en blob ärver du nivån från den gamla bloben om inget x-ms-access-tier huvud anges.

ExpiryOption

Du kan skicka följande värden som en x-ms-expiry-option rubrik. Det här huvudet är inte skiftlägeskänsligt.

Förfalloalternativ Description
RelativeToNow Anger förfallodatumet i förhållande till den aktuella tiden. x-ms-expiry-time måste anges som det antal millisekunder som ska förflutit från den aktuella tiden.
Absolute x-ms-expiry-time måste anges som en absolut tid i RFC 1123-format.
NeverExpire Anger att bloben aldrig ska upphöra att gälla eller tar bort det aktuella förfallodatumet. x-ms-expiry-time får inte anges.

Semantiken för att ange ett förfallodatum för en blob är följande:

  • Set Expiry kan bara anges på en blob och inte i en katalog.
  • Set Expiry expiryTime tidigare tillåts inte.
  • ExpiryTime kan inte anges med värdet expiryOptionNever.

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 Put Blob begäranden baserat på lagringskontotypen:

Åtgärd Typ av lagringskonto Faktureringskategori
Placera blob Premium-blockblob
Standard generell användning v2
Standard generell användning v1		 Skrivå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 blobtjänsten
Ange tidsgränser för blobtjänståtgärder