BlobLeaseClient Sınıf

  • Başvuru

Yeni bir BlobLeaseClient oluşturur.

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

Devralma
builtins.object
BlobLeaseClient

Oluşturucu

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

Parametreler

client
BlobClient veya ContainerClient
Gerekli

Kiraya vermek istediğiniz blobun veya kapsayıcının istemcisi.

lease_id
str
varsayılan değer: None

Var olan bir kiranı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 bir kira isteğinde bulunur.

Kapsayıcının etkin bir kirası 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 bozulduktan sonra yenilenemez. Herhangi bir yetkili istek 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 kiranı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 bir kira isteğinde bulunur.

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

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şiklik 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi 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 üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition
str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak 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 izlenmiyor veya doğrulanmıyor. İ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 bozulduktan sonra yenilenemez. Herhangi bir yetkili istek 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.

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 süresi 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi belirtin.

if_tags_match_condition
str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak 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 izlenmiyor veya doğrulanmıyor. İ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 kiranın kira kimliğini değiştirin.

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

Parametreler

proposed_lease_id
str
Gerekli

GUID dizesi 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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi 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 üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition
str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak 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 izlenmiyor veya doğrulanmıyor. İ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.

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. İşlemi yalnızca kaynak belirtilen süreden sonra değiştirilmişse gerçekleştirmek için bu üst bilgiyi 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. İşlemi yalnızca kaynak belirtilen tarih/saatten sonra değiştirilmemişse gerçekleştirmek için bu üst bilgiyi 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 üzerinde kullanılacak eşleştirme koşulu.

if_tags_match_condition
str

Blob etiketleri üzerinde yalnızca eşleşen değere sahip blob üzerinde çalışacak 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.

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