BlobLeaseClient Sınıf

Yeni bir BlobLeaseClient oluşturur.

Bu istemci bir BlobClient veya ContainerClient üzerinde kiralama işlemleri sağlar.

Devralma

azure.storage.blob._lease.BlobLeaseClient

BlobLeaseClient

Oluşturucu

BlobLeaseClient(client: BlobClient | ContainerClient, lease_id: str | None = None)

Parametreler

client

BlobClient veya ContainerClient

Gerekli

Kiraya vermek için blobun veya kapsayıcının istemcisi.

lease_id

str

varsayılan değer: None

Mevcut kiralamanın kira kimliğini temsil eden dize. Yeni bir kira almak veya bir kirayı kesmek için bu değerin belirtilmesi gerekmez.

Değişkenler

id

str

Şu anda bakımı yapılan kiralamanın kimliği. Henüz kira alınmadıysa, bu Hiçbiri olur.

etag

str

Kiranın ETag'i şu anda korunuyor. Henüz kira alınmadıysa veya değiştirilmediyse, bu Hiçbiri olur.

last_modified

datetime

Şu anda bakımda olan kiranın son değiştirilen zaman damgası. Henüz kira alınmadıysa veya değiştirilmediyse, bu Hiçbiri olur.

Yöntemler

acquire	Yeni kiralama isteğinde bulunur. Kapsayıcının etkin kiralaması yoksa, Blob hizmeti kapsayıcıda bir kira oluşturur ve yeni bir kira kimliği döndürür.
break_lease	Kapsayıcı veya blob etkin bir kiraya sahipse kirayı sonlandırın. Kira bozulursa, yenilenemez. Yetkili istekler kirayı bozabilir; eşleşen bir kira kimliği belirtmek için istek gerekli değildir. Kira kesildiğinde, kira kesme süresinin geçmesine izin verilir ve bu süre boyunca kapsayıcı veya blob üzerinde kesme ve serbest bırakma dışında hiçbir kiralama işlemi gerçekleştirilemez. Kira başarıyla kesildiğinde, yanıt yeni bir kira alınıncaya kadar saniye cinsinden aralığı gösterir.
change	Etkin kiralamanın kira kimliğini değiştirin.
release	Kirayı serbest bırakın. İstemci kira kimliği belirtilen kapsayıcı veya blob ile ilişkili eşleşiyorsa kiralama serbest bırakılabilir. Kiranın serbest bırakılması, yayın tamamlandıktan hemen sonra başka bir istemcinin kapsayıcı veya blob için kirayı hemen almasını sağlar.
renew	Kirayı yeniler. Kira istemcisinde belirtilen kira kimliği kapsayıcı veya blobla ilişkiliyle eşleşiyorsa kira yenilenebilir. Bu kiralamanın sona erme tarihinden sonra kapsayıcı veya blob yeniden kiralanmadığı sürece süresi dolmuş olsa bile kiralamanın yenilenebileceğini unutmayın. Kiralamayı yenilediğinizde, kira süresi saati sıfırlanır.

acquire

Yeni kiralama isteğinde bulunur.

Kapsayıcının etkin kiralaması yoksa, Blob hizmeti kapsayıcıda bir kira oluşturur ve yeni bir kira kimliği döndürür.

async acquire(lease_duration: int = -1, **kwargs: Any) -> None

Parametreler

lease_duration

int

Gerekli

Süresi hiç dolmamış bir kiralama için kiranın süresini saniye cinsinden veya negatif bir (-1) olarak belirtir. Sonsuz olmayan kiralama 15 ile 60 saniye arasında olabilir. Kiralama süresi yenileme veya değiştirme kullanılarak değiştirilemez. Varsayılan değer -1'dir (sonsuz kiralama).

if_modified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.

if_unmodified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.

etag

str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition

MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition

str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout

int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Dönüş türü

None

break_lease

Kapsayıcı veya blob etkin bir kiraya sahipse kirayı sonlandırın.

Kira bozulursa, yenilenemez. Yetkili istekler kirayı bozabilir; eşleşen bir kira kimliği belirtmek için istek gerekli değildir. Kira kesildiğinde, kira kesme süresinin geçmesine izin verilir ve bu süre boyunca kapsayıcı veya blob üzerinde kesme ve serbest bırakma dışında hiçbir kiralama işlemi gerçekleştirilemez. Kira başarıyla kesildiğinde, yanıt yeni bir kira alınıncaya kadar saniye cinsinden aralığı gösterir.

async break_lease(lease_break_period: int | None = None, **kwargs: Any) -> int

Parametreler

lease_break_period

int

Gerekli

Bu, kiranın bozulmadan önce 0 ile 60 saniye arasında devam etmesi için önerilen saniye süresidir. Bu kesme dönemi yalnızca kirada kalan süreden kısaysa kullanılır. Daha uzunsa, kirada kalan süre kullanılır. Kesme süresi dolmadan önce yeni bir kira kullanılamaz, ancak kiralama kesme döneminden daha uzun süre tutulabilir. Bu üst bilgi bir kesme işlemiyle birlikte görünmüyorsa, kalan kiralama dönemi geçtikten sonra sabit süreli kiralama bozulur ve sonsuz kiralama hemen sona erer.

if_modified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.

if_unmodified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.

if_tags_match_condition

str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout

int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Kira döneminde kalan yaklaşık süre (saniye cinsinden).

Dönüş türü

int

change

Etkin kiralamanın kira kimliğini değiştirin.

async change(proposed_lease_id: str, **kwargs: Any) -> None

Parametreler

proposed_lease_id

str

Gerekli

GUID dize biçiminde önerilen kira kimliği. Önerilen kira kimliği doğru biçimde değilse Blob hizmeti 400 (Geçersiz istek) döndürür.

if_modified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.

if_unmodified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.

etag

str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition

MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition

str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout

int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Hiçbiri

release

Kirayı serbest bırakın.

İstemci kira kimliği belirtilen kapsayıcı veya blob ile ilişkili eşleşiyorsa kiralama serbest bırakılabilir. Kiranın serbest bırakılması, yayın tamamlandıktan hemen sonra başka bir istemcinin kapsayıcı veya blob için kirayı hemen almasını sağlar.

async release(**kwargs: Any) -> None

Parametreler

if_modified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.

if_unmodified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.

etag

str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition

MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition

str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout

int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Hiçbiri

renew

Kirayı yeniler.

Kira istemcisinde belirtilen kira kimliği kapsayıcı veya blobla ilişkiliyle eşleşiyorsa kira yenilenebilir. Bu kiralamanın sona erme tarihinden sonra kapsayıcı veya blob yeniden kiralanmadığı sürece süresi dolmuş olsa bile kiralamanın yenilenebileceğini unutmayın. Kiralamayı yenilediğinizde, kira süresi saati sıfırlanır.

async renew(**kwargs: Any) -> None

Parametreler

if_modified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için belirtin.

if_unmodified_since

datetime

Bir DateTime değeri. Azure, geçirilen tarih değerinin UTC olmasını bekler. Saat dilimi dahil edilirse, UTC olmayan tarih saatleri UTC'ye dönüştürülür. Saat dilimi bilgisi olmadan bir tarih geçirilirse UTC olduğu varsayılır. bu üst bilgiyi, yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse işlemi gerçekleştirmek için belirtin.

etag

str

ETag değeri veya joker karakter (*). Kaynağın değişip değişmediğini denetlemek ve match_condition parametresi tarafından belirtilen koşula göre hareket etmek için kullanılır.

match_condition

MatchConditions

Etag'de kullanılacak eşleştirme koşulu.

if_tags_match_condition

str

Yalnızca eşleşen bir değere sahip blob üzerinde çalışmak için blob etiketleri üzerinde bir SQL where yan tümcesi belirtin. Örneğin "\"tagname\"='my tag'"

Sürüm 12.4.0'da yeni.

timeout

int

İşlemin sunucu tarafı zaman aşımını saniye olarak ayarlar. Diğer ayrıntılar için bkz: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Bu değer istemcide izlenmez veya doğrulanmaz. İstemci tarafı ağ zaman aşımlarını yapılandırmak için buraya bakın.

Döndürülenler

Hiçbiri