BlobLeaseClient Osztály

Létrehoz egy új BlobLeaseClientet.

Ez az ügyfél bérletműveleteket biztosít BlobClienten vagy ContainerClienten.

Öröklődés

builtins.object

BlobLeaseClient

Konstruktor

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

Paraméterek

client

BlobClient vagy ContainerClient

Kötelező

A bérlethez tartozó blob vagy tároló ügyfele.

lease_id

str

alapértelmezett érték: None

Egy meglévő bérlet bérletazonosítóját képviselő sztring. Ezt az értéket nem kell megadni egy új bérlet beszerzéséhez vagy megszakításához.

Változók

id

str

A jelenleg karbantartott bérlet azonosítója. Ez Nem lesz , ha még nem szereztek be bérletet.

etag

str

A jelenleg karbantartott bérlet ETagje. Ez Nem lesz , ha még nem szereztek be vagy módosítottak bérletet.

last_modified

datetime

A jelenleg karbantartott bérlet utolsó módosított időbélyege. Ez Nem lesz , ha még nem szereztek be vagy módosítottak bérletet.

Metódusok

acquire	Új bérletet kér. Ha a tároló nem rendelkezik aktív bérletekkel, a Blob szolgáltatás létrehoz egy bérletet a tárolón, és egy új bérletazonosítót ad vissza.
break_lease	Megszakíthatja a bérletet, ha a tároló vagy a blob aktív bérletet kapott. A bérlet megszakadása után a bérlet nem újítható meg. Bármely engedélyezett kérelem megszakíthatja a bérletet; a kérelem nem szükséges egyező bérletazonosító megadásához. Ha egy bérlet megszakad, a bérlettörési időszak lejárhat, és ez alatt az idő alatt a tárolón vagy blobon nem végezhető bérletművelet, kivéve a megszakítást és a kiadást. Ha egy bérlet sikeresen megszakad, a válasz másodpercek alatt jelzi az időközt, amíg új bérletet nem szerezhet be.
change	Módosítsa egy aktív bérlet bérletazonosítóját.
release	Engedje fel a bérletet. A bérlet felszabadítható, ha a megadott ügyfélbérlet-azonosító megegyezik a tárolóhoz vagy blobhoz társítottakkal. A bérlet felszabadítása lehetővé teszi, hogy egy másik ügyfél azonnal megszerezze a tároló vagy blob bérletét, amint a kiadás befejeződött.
renew	Megújítja a bérletet. A bérlet megújítható, ha a bérletügyfélben megadott bérletazonosító megegyezik a tárolóhoz vagy blobhoz társított bérletazonosítóval. Vegye figyelembe, hogy a bérlet akkor is megújítható, ha lejárt, feltéve, hogy a tárolót vagy blobot a bérlet lejárata óta nem bérletelték újra. A bérlet megújításakor a bérlet időtartama alaphelyzetbe áll.

acquire

Új bérletet kér.

Ha a tároló nem rendelkezik aktív bérletekkel, a Blob szolgáltatás létrehoz egy bérletet a tárolón, és egy új bérletazonosítót ad vissza.

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

Paraméterek

lease_duration

int

Kötelező

Megadja a bérlet időtartamát másodpercben, vagy negatívat (-1) egy olyan bérlethez, amely soha nem jár le. A nem végtelen bérlet 15 és 60 másodperc között lehet. A bérlet időtartama nem módosítható megújítással vagy módosítással. Az alapértelmezett érték -1 (végtelen bérlet).

if_modified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás a megadott időpont óta módosult.

if_unmodified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás nem lett módosítva a megadott dátum/idő óta.

etag

str

ETag-érték vagy helyettesítő karakter (*). Annak ellenőrzésére szolgál, hogy az erőforrás megváltozott-e, és a match_condition paraméter által megadott feltételnek megfelelően jár-e el.

match_condition

MatchConditions

Az etagen használni kívánt egyeztetési feltétel.

if_tags_match_condition

str

Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik. például: "\"tagname\"='my tag'"

Új a 12.4.0-s verzióban.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időtúllépések konfigurálásához lásd itt.

Visszatérési típus

None

break_lease

Megszakíthatja a bérletet, ha a tároló vagy a blob aktív bérletet kapott.

A bérlet megszakadása után a bérlet nem újítható meg. Bármely engedélyezett kérelem megszakíthatja a bérletet; a kérelem nem szükséges egyező bérletazonosító megadásához. Ha egy bérlet megszakad, a bérlettörési időszak lejárhat, és ez alatt az idő alatt a tárolón vagy blobon nem végezhető bérletművelet, kivéve a megszakítást és a kiadást. Ha egy bérlet sikeresen megszakad, a válasz másodpercek alatt jelzi az időközt, amíg új bérletet nem szerezhet be.

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

Paraméterek

lease_break_period

int

Kötelező

Ez a javasolt időtartam a bérlet megszakítása előtt 0 és 60 másodperc között. Ezt a szünetidőt csak akkor használja a rendszer, ha rövidebb, mint a bérletben fennmaradó idő. Ha hosszabb ideig tart, a rendszer a bérleten hátralévő időt használja fel. Az új bérlet nem lesz elérhető a megszakítási időszak lejárta előtt, de a bérlet hosszabb ideig tartható, mint a megszakítási időszak. Ha ez a fejléc nem jelenik meg törésművelettel, a fennmaradó bérletidőszak letelte után egy rögzített időtartamú bérlettöredék, és azonnal végtelen bérlettörések jelennek meg.

if_modified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás a megadott időpont óta módosult.

if_unmodified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás nem lett módosítva a megadott dátum/idő óta.

if_tags_match_condition

str

Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik. például: "\"tagname\"='my tag'"

Új a 12.4.0-s verzióban.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időtúllépések konfigurálásához lásd itt.

Válaszok

A bérletidőszakban hátralévő hozzávetőleges idő másodpercben.

Visszatérési típus

int

change

Módosítsa egy aktív bérlet bérletazonosítóját.

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

Paraméterek

proposed_lease_id

str

Kötelező

Javasolt bérletazonosító GUID sztringformátumban. A Blob szolgáltatás 400(Érvénytelen kérelem) értéket ad vissza, ha a javasolt bérletazonosító nem a megfelelő formátumú.

if_modified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás a megadott időpont óta módosult.

if_unmodified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás nem lett módosítva a megadott dátum/idő óta.

etag

str

ETag-érték vagy helyettesítő karakter (*). Annak ellenőrzésére szolgál, hogy az erőforrás megváltozott-e, és a match_condition paraméter által megadott feltételnek megfelelően jár-e el.

match_condition

MatchConditions

Az etagen használni kívánt egyeztetési feltétel.

if_tags_match_condition

str

Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik. például: "\"tagname\"='my tag'"

Új a 12.4.0-s verzióban.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időtúllépések konfigurálásához lásd itt.

Válaszok

None

release

Engedje fel a bérletet.

A bérlet felszabadítható, ha a megadott ügyfélbérlet-azonosító megegyezik a tárolóhoz vagy blobhoz társítottakkal. A bérlet felszabadítása lehetővé teszi, hogy egy másik ügyfél azonnal megszerezze a tároló vagy blob bérletét, amint a kiadás befejeződött.

release(**kwargs: Any) -> None

Paraméterek

if_modified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás a megadott időpont óta módosult.

if_unmodified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás nem lett módosítva a megadott dátum/idő óta.

etag

str

ETag-érték vagy helyettesítő karakter (*). Annak ellenőrzésére szolgál, hogy az erőforrás megváltozott-e, és a match_condition paraméter által megadott feltételnek megfelelően jár-e el.

match_condition

MatchConditions

Az etagen használni kívánt egyeztetési feltétel.

if_tags_match_condition

str

Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik. például: "\"tagname\"='my tag'"

Új a 12.4.0-s verzióban.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időtúllépések konfigurálásához lásd itt.

Válaszok

None

renew

Megújítja a bérletet.

A bérlet megújítható, ha a bérletügyfélben megadott bérletazonosító megegyezik a tárolóhoz vagy blobhoz társított bérletazonosítóval. Vegye figyelembe, hogy a bérlet akkor is megújítható, ha lejárt, feltéve, hogy a tárolót vagy blobot a bérlet lejárata óta nem bérletelték újra. A bérlet megújításakor a bérlet időtartama alaphelyzetbe áll.

renew(**kwargs: Any) -> None

Paraméterek

if_modified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás a megadott időpont óta módosult.

if_unmodified_since

datetime

DateTime érték. Az Azure azt várja, hogy a megadott dátumérték UTC legyen. Ha az időzónát is tartalmazza, a nem UTC dátumidőket a rendszer UTC-vé alakítja. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC értéket feltételez. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás nem lett módosítva a megadott dátum/idő óta.

etag

str

ETag-érték vagy helyettesítő karakter (*). Annak ellenőrzésére szolgál, hogy az erőforrás megváltozott-e, és a match_condition paraméter által megadott feltételnek megfelelően jár-e el.

match_condition

MatchConditions

Az etagen használni kívánt egyeztetési feltétel.

if_tags_match_condition

str

Adjon meg egy SQL-t, ahol a blobcímkék záradéka csak egyező értékkel rendelkező blobokon működik. például: "\"tagname\"='my tag'"

Új a 12.4.0-s verzióban.

timeout

int

Beállítja a művelet kiszolgálóoldali időtúllépését másodpercben. További információ: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Ez az érték nincs nyomon követve vagy érvényesítve az ügyfélen. Az ügyféloldali hálózati időtúllépések konfigurálásához lásd itt.

Válaszok

None