Låna blob

Åtgärden Lease Blob skapar och hanterar ett lås på en blob för skriv- och borttagningsåtgärder. Låsets varaktighet kan vara mellan 15 och 60 sekunder eller oändlig. I versioner före 2012-02-12 är låsets varaktighet 60 sekunder.

Du kan anropa åtgärden Lease Blob i något av följande lägen:

• Acquire, för att begära ett nytt lån.

• Renew, för att förnya ett befintligt lån.

• Change, för att ändra ID:t för ett befintligt lån.

• Release, för att frigöra lånet om det inte längre behövs, så att en annan klient omedelbart kan hämta ett lån mot bloben.

• Break, för att avsluta lånet, men se till att en annan klient inte kan skaffa ett nytt lån förrän den aktuella låneperioden har upphört att gälla.

Förfrågan

Du kan skapa begäran på Lease Blob följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto.

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.

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

URI-parametrar

Du kan ange följande ytterligare parameter i begärande-URI:n.

Begärandehuvuden

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

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

Begärandetext

Inga.

Exempelbegäran

Följande exempelbegäran visar hur du skaffar ett lån:

  
Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=lease HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-lease-action: acquire  
x-ms-lease-duration: -1  
x-ms-proposed-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
x-ms-date: <date>  
Authorization: SharedKey testaccount1:esSKMOYdK4o+nGTuTyeOLBI+xqnqi6aBmiW4XI699+o=  
  

Svarsåtgärder

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

Statuskod

Statuskoderna för lyckade lån som returneras för låneåtgärder är följande:

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

• Renew: En lyckad åtgärd returnerar statuskoden 200 (OK).

• Change: En lyckad åtgärd returnerar statuskoden 200 (OK).

• Release: En lyckad åtgärd returnerar statuskoden 200 (OK).

• Break: En lyckad åtgärd returnerar statuskoden 202 (godkänd).

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.

Själva svaret

Inga.

Exempelsvar

Följande är ett exempelsvar för en begäran om att skaffa ett lån:

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402  
x-ms-version: 2015-02-21  
x-ms-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
Date: <date>  
  

Auktorisering

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

Kommentarer

Ett lån på en blob ger exklusiv skriv- och borttagningsåtkomst till bloben. Om du vill skriva till en blob med ett aktivt lån måste en klient inkludera det aktiva låne-ID:t med skrivbegäran. Lånet beviljas för den period som anges när lånet förvärvas. Den här varaktigheten kan vara mellan 15 och 60 sekunder eller en oändlig varaktighet.

När en klient hämtar ett lån returneras ett låne-ID. Blob Storage genererar ett låne-ID om inget anges i begäran om att hämta. Klienten kan använda det här låne-ID:t för att förnya lånet, ändra sitt låne-ID eller frigöra lånet.

När ett lån är aktivt måste låne-ID:t inkluderas i begäran för någon av följande åtgärder:

• Placera blob

• Ange blobmetadata

• Ange blobegenskaper

• Ta bort blob

• Placera block

• Put Block List

• Placera sida

• Lägg till block

• Kopiera blob (låne-ID krävs för målblob)

Om låne-ID:t inte ingår misslyckas dessa åtgärder på en hyrd blob med 412 – Precondition failed.

Följande åtgärder lyckas på en hyrd blob, utan att inkludera låne-ID:t:

• Hämta blob

• Hämta blobmetadata

• Hämta blobegenskaper

• Hämta blockeringslista

• Hämta sidintervall

• Lista blobar

• Kopiera blob (inget låne-ID krävs för källbloben.)

• Lease Blob (REST API) ( Inget låne-ID behövs för x-ms-lease-action: break.)

Du behöver inte inkludera låne-ID:t för GET åtgärder på en blob som har ett aktivt lån. Alla åtgärder stöder dock GET en villkorsstyrd låneparameter, där åtgärden endast fortsätter om låne-ID:t som ingår i begäran är giltigt.

Alla containeråtgärder tillåts på en container som innehåller blobar med ett aktivt lån, inklusive Ta bort container. Därför kan en container tas bort även om blobar i den har aktiva lån. Använd åtgärden Lease Container (Låna container ) för att kontrollera behörigheter för att ta bort en container.

Lånetillstånd

Följande diagram visar de fem tillstånden för ett lån och de kommandon eller händelser som orsakar ändringar i lånetillståndet.

Ett lån kan vara i något av dessa tillstånd, baserat på om lånet är låst eller olåst och om lånet är förnybart i det tillståndet. Låneåtgärderna som visas i föregående diagram orsakar tillståndsövergångar.

• Available: Lånet är olåst och kan förvärvas. Tillåten åtgärd: acquire.

• Leased: Lånet är låst. Tillåtna åtgärder: acquire (endast samma låne-ID), renew, change, releaseoch break.

• Expired: Lånetiden har upphört att gälla. Tillåtna åtgärder: acquire, renew, releaseoch break.

• Breaking: Lånet har brutits, men lånet fortsätter att vara låst tills avbrottsperioden har gått ut. Tillåtna åtgärder: release och break.

• Broken: Lånet har brutits och avbrottsperioden har upphört att gälla. Tillåtna åtgärder: acquire, releaseoch break.

När ett lån har upphört att gälla underhålls låne-ID:t av Blob Storage tills bloben ändras eller leasas igen. En klient kan försöka förnya eller frigöra lånet med hjälp av sitt utgångna låne-ID. Om åtgärden lyckas innebär det att bloben inte har ändrats sedan låne-ID:t senast var giltigt.

Om klienten försöker förnya eller släppa ett lån med sitt tidigare låne-ID och begäran misslyckas, ändrades eller hyrdes bloben igen eftersom klientens lån senast var aktivt. Klienten måste sedan skaffa ett nytt lån för bloben.

Om ett lån upphör att gälla i stället för att uttryckligen frisläppas kan en klient behöva vänta upp till en minut innan ett nytt lån kan hämtas för bloben. Klienten kan dock förnya lånet med sitt låne-ID omedelbart, om bloben inte har ändrats.

Observera att ett lån inte kan beviljas för en blobögonblicksbild eftersom ögonblicksbilder är skrivskyddade. Att begära ett lån mot en ögonblicksbild resulterar i statuskod 400 (felaktig begäran).

Blobens Last-Modified-Time egenskap uppdateras inte av anrop till Lease Blob.

Följande tabeller visar resultatet av åtgärder på blobar med lån i olika lånetillstånd. Bokstäverna (A), (B) och (C) representerar låne-ID:n och (X) representerar ett låne-ID som genereras av Blob Storage.

Utfall av användningsförsök på blobar efter lånetillstånd

Resultat av låneåtgärder på blobar efter lånetillstånd

Ändringar i lånebloben som introducerades i version 2012-02-12

I följande lista anges ändringar Lease Blob i beteendet som introducerades i version 2012-02-12.

• Ett anrop till för att Lease Blob skaffa ett lån måste nu innehålla en rubrik för lånetid. Om du försöker skaffa ett lån utan att ange en lånetid returnerar 400 Bad Request – Missing required headertjänsten .

• Du kan inte längre förnya ett lån när du har släppt det. Om du försöker göra det returnerar 409 Conflict – The lease ID specified did not match the lease ID for the blobtjänsten . Program som anropade release och sedan anropade renew måste nu spara ETag från versionsanropet. Sedan måste program anropa acquire, med en If-Match villkorsstyrd rubrik, för att hämta lånet endast när bloben är oförändrad.

• Du kan inte längre avbryta ett lån när du har släppt det. Om du försöker göra det returnerar 409 Conflict – There is currently no lease on the blobtjänsten .

• Du kan nu bryta ett lån som bryter eller bryts, vilket gör avbrottsåtgärder idempotent. I tidigare versioner misslyckades detta med 409 Conflict – The lease has already been broken and cannot be broken again. Med den här ändringen kan du förkorta varaktigheten för en paus. Om du bryter ett lån som är i ett icke-bakåtkompatibelt tillstånd och inkluderar en kortare varaktighet än den återstående avbrottsperioden används din kortare varaktighet.

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

Se även

new-blob-lease-features-infinite-leases-smaller-lease-times-and-more.aspx)
Auktorisera begäranden till Azure Storage
Status- och felkoder
Felkoder för Blob Storage
Lånecontainer