Blob Kiralama

İşlem, Lease Blob yazma ve silme işlemleri için blob üzerinde kilit oluşturur ve yönetir. Kilit süresi 15 ile 60 saniye olabilir veya sonsuz olabilir. 2012-02-12 öncesi sürümlerde kilit süresi 60 saniyedir.

İşlemi aşağıdaki modlardan birinde çağırabilirsiniz Lease Blob :

• Acquireögesini seçin.

• Renewögesini seçin.

• Change, mevcut kiralamanın kimliğini değiştirmek için.

• Release, artık gerekli değilse kirayı serbest bırakır, böylece başka bir istemci bloba karşı hemen bir kira alabilir.

• Break, ancak geçerli kiralama süresi dolana kadar başka bir istemcinin yeni kira alamamasını sağlar.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Lease Blob . HTTPS önerilir. myaccount değerini depolama hesabınızın adıyla değiştirin.

Öykünülmüş depolama hizmeti URI'si

Öykünülmüş depolama hizmetine yönelik bir istekte bulunurken öykünücü konak adını ve Azure Blob Depolama bağlantı noktasını olarak 127.0.0.1:10000ve ardından öykünülen depolama hesabı adını belirtin.

Daha fazla bilgi için bkz. Yerel Azure Depolama geliştirmesi için Azurite öykünücüsü kullanma.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreyi belirtebilirsiniz.

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

Bu işlem, yalnızca belirtilen bir koşul karşılandığında işlemi çalıştırmak için koşullu üst bilgilerin kullanımını da destekler. Daha fazla bilgi için bkz. Blob Depolama işlemleri için koşullu üst bilgileri belirtme.

İstek gövdesi

Yok.

Örnek istek

Aşağıdaki örnek istekte kiralama alma işlemi gösterilmektedir:

  
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=  
  

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Kira işlemleri için döndürülen başarı durum kodları şunlardır:

• Acquire: Başarılı bir işlem 201 (Oluşturuldu) durum kodunu döndürür.

• Renew: Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.

• Change: Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.

• Release: Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.

• Break: Başarılı bir işlem 202 (Kabul Edildi) durum kodunu döndürür.

Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek, standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt gövdesi

Yok.

Örnek yanıt

Kira alma isteği için örnek bir yanıt aşağıda verilmiştir:

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>  
  

Yetkilendirme

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Lease Blob verebilirsiniz.

Açıklamalar

Blob üzerindeki kiralama, bloba özel yazma ve silme erişimi sağlar. Etkin kiralaması olan bir bloba yazmak için, istemcinin yazma isteğine sahip etkin kira kimliğini içermesi gerekir. Kira, kira alınırken belirtilen süre boyunca verilir. Bu süre 15 ile 60 saniye arasında veya sonsuz bir süre olabilir.

bir istemci kiralama aldığında, bir kira kimliği döndürülür. Alma isteğinde belirtilmemişse Blob Depolama bir kira kimliği oluşturur. İstemci, kiralamayı yenilemek, kira kimliğini değiştirmek veya kirayı serbest bırakmak için bu kira kimliğini kullanabilir.

Bir kira etkin olduğunda, kira kimliği aşağıdaki işlemlerden herhangi biri için isteğe eklenmelidir:

• İkili Büyük Nesne Koyma

• Blob Meta Verilerini Ayarlama

• Blob Özelliklerini Ayarlama

• İkili Büyük Nesneyi Silme

• Blok Koy

• Put Block List

• Sayfa Koy

• Ekleme Bloğu

• Blobu Kopyalama (hedef blob için gereken kira kimliği)

Kira kimliği dahil değilse, bu işlemler ile 412 – Precondition failedkiralanan bir blobda başarısız olur.

Kiralanan blobda aşağıdaki işlemler, kira kimliği dahil edilmeden başarılı olur:

• Blob Alma

• Blob Meta Verilerini Alma

• BLOB özelliklerini Al

• Blok Listesini Al

• Sayfa Aralıklarını Alma

• Blobları Listeleme

• Blobu Kopyala (Kaynak blob için kira kimliği gerekmez.)

• Kira Blobu (REST API) (için x-ms-lease-action: breakkira kimliği gerekmez.)

Etkin kiralaması olan bir blob üzerindeki işlemler için GET kira kimliğinin eklenmesi gerekmez. Ancak, tüm GET işlemler koşullu kiralama parametresini destekler; burada işlem yalnızca istekle birlikte gelen kira kimliği geçerliyse devam eder.

Etkin kirası olan blobları içeren kapsayıcıda Tüm kapsayıcı işlemlerine izin verilir( Kapsayıcıyı Sil de dahil). Bu nedenle, kapsayıcı içindeki bloblar etkin kiralara sahip olsa bile silinebilir. Kapsayıcı silme haklarını denetlemek için Kira Kapsayıcısı işlemini kullanın.

Kira durumları

Aşağıdaki diyagramda, kiralamanın beş durumu ve kiralama durumunun değişmesine neden olan komutlar veya olaylar gösterilmektedir.

Kiralamanın kilitli veya kilidi açık olmasına ve bu durumda kiranın yenilenebilir olmasına bağlı olarak, kiralama bu durumlardan birinde olabilir. Önceki diyagramda gösterilen kira eylemleri durum geçişlerine neden olur.

• Available: Kira kilidi açılır ve alınabilir. İzin verilen eylem: acquire.

• Leased: Kira kilitlendi. İzin verilen eylemler: acquire (yalnızca aynı kira kimliği), renew, change, releaseve break.

• Expired: Kira süresi doldu. İzin verilen eylemler: acquire, renew, releaseve break.

• Breaking: Kira bozuldu, ancak kesme süresi dolana kadar kira kilitlenmeye devam edecek. İzin verilen eylemler: release ve break.

• Broken: Kira bozuldu ve kesme süresi doldu. İzin verilen eylemler: acquire, releaseve break.

Kiranın süresi dolduktan sonra, blob değiştirilene veya yeniden kiralanana kadar kira kimliği Blob Depolama tarafından korunur. İstemci, süresi dolan kira kimliğini kullanarak kiralamayı yenilemeyi veya serbest bırakma girişiminde bulunabilir. İşlem başarılı olursa bu, kira kimliğinin son geçerli olmasından bu yana blob'un değiştirilmediği anlamına gelir.

İstemci önceki kira kimliğiyle bir kiralamayı yenilemeyi veya serbest bırakmayı denerse ve istek başarısız olursa, istemcinin kirası son etkin olduğundan blob değiştirildi veya yeniden kiralandı. İstemcinin blob üzerinde yeni bir kira alması gerekir.

Bir kiranın süresi açıkça serbest bırakılmak yerine sona eriyorsa, blob için yeni bir kiralamanın alınabilmesi için istemcinin bir dakika kadar beklemesi gerekebilir. Ancak blob değiştirilmediyse istemci kira kimliğini hemen yenileyebilir.

Anlık görüntüler salt okunur olduğundan blob anlık görüntüsü için kira verilemediğine dikkat edin. Anlık görüntüye karşı kiralama isteğinde bulunarak durum kodu 400 (Hatalı İstek) olur.

Blob'un Last-Modified-Time özelliği çağrısıyla Lease Blobgüncelleştirilmez.

Aşağıdaki tablolarda, çeşitli kira durumlarındaki kiraları olan bloblardaki eylemlerin sonuçları gösterilir. Harfler (A), (B) ve (C) kira kimliklerini temsil eder ve (X) Blob Depolama tarafından oluşturulan bir kira kimliğini temsil eder.

Kira durumuna göre bloblarda kullanım denemelerinin sonuçları

Bloblardaki kiralama işlemlerinin kira durumuna göre sonuçları

2012-02-12 sürümünde sunulan Kira Blobu değişiklikleri

Aşağıdaki liste, sürüm 2012-02-12'de sunulan davranış değişikliklerini Lease Blob belirtir.

• Kiralama almak için çağrısı Lease Blob artık bir kira süresi üst bilgisi içermelidir. Kiralama süresi belirtmeden kiralama almayı denerseniz, hizmet döndürür 400 Bad Request – Missing required header.

• Artık bir kirayı serbest bıraktıktan sonra yenileyeemezsiniz. Bunu yapmayı denerseniz, hizmet döndürür 409 Conflict – The lease ID specified did not match the lease ID for the blob. Yayın olarak adlandırılan ve ardından yenileme olarak adlandırılan uygulamaların artık yayın çağrısından öğesini kaydetmesi ETag gerekir. Daha sonra, yalnızca blob değişmediğinde kiralamayı almak için uygulamaların koşullu üst bilgiyle If-Match alma çağrısı yapması gerekir.

• Artık bir kirayı serbest bıraktıktan sonra bozasınız. Bunu yapmayı denerseniz, hizmet döndürür 409 Conflict – There is currently no lease on the blob.

• Artık, kesme işlemlerini bir kez etkili hale getirerek, kopan veya bozulan bir kirayı bozabilirsiniz. Önceki sürümlerde bu, ile 409 Conflict – The lease has already been broken and cannot be broken againbaşarısız oldu. Bu değişiklik, kesme süresini kısaltmanıza olanak tanır. Kesme durumundaki bir kirayı bozarsanız ve kalan kesme döneminden daha kısa bir süre eklerseniz, daha kısa süreniz kullanılır.

Faturalama

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilmeyi etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre istekler için Lease Blob faturalama kategorisi gösterilmektedir:

Ayrıca bkz.

new-blob-lease-features-infinite-leases-smaller-lease-times-and-more.aspx)
Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları
Blob Depolama hata kodları
Kira Kapsayıcısı