DataLakeLeaseClient Osztály

Létrehoz egy új DataLakeLeaseClient objektumot.

Ez az ügyfél bérletműveleteket biztosít a FileSystemClient, a DataLakeDirectoryClient vagy a DataLakeFileClient rendszereken.

Öröklődés

builtins.object

DataLakeLeaseClient

Konstruktor

DataLakeLeaseClient(client: FileSystemClient | DataLakeDirectoryClient | DataLakeFileClient, lease_id: str | None = None)

Paraméterek

client

FileSystemClient vagy DataLakeDirectoryClient vagy DataLakeFileClient

Kötelező

A bérletbe vett fájlrendszer, könyvtár vagy fájl ü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 fenntartott bérlet azonosítója. Ez Nem lesz , ha még nem szereztek be bérletet.

etag

str

A jelenleg fenntartott bérlet ETagje. Ez Nem lesz , ha még nem szerezték meg vagy módosították a bérletet.

last_modified

datetime

A jelenleg karbantartott bérlet utolsó módosított időbélyege. Ez Nem lesz , ha még nem szerezték meg vagy módosították a bérletet.

Metódusok

acquire	Új bérletet kér. Ha a fájl/fájlrendszer nem rendelkezik aktív bérletekkel, a DataLake szolgáltatás létrehoz egy bérletet a fájl-/fájlrendszeren, és egy új bérletazonosítót ad vissza.
break_lease	Megszakíthatja a bérletet, ha a fájlrendszer vagy fájl 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érletmegszakítási időszak eltelhet, és ez alatt az idő alatt a fájlrendszerben vagy fájlban nem végezhető el a 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 fájlrendszerrel vagy fájllal társítottakkal. A bérlet felszabadítása lehetővé teszi, hogy egy másik ügyfél azonnal megszerezze a fájlrendszer vagy fájl 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 fájlrendszerrel vagy fájllal. Vegye figyelembe, hogy a bérlet akkor is megújítható, ha lejárt, ha a fájlrendszert vagy fájlt a bérlet lejárata óta nem adták tovább. A bérlet megújításakor a bérlet időtartama visszaáll.

acquire

Új bérletet kér.

Ha a fájl/fájlrendszer nem rendelkezik aktív bérletekkel, a DataLake szolgáltatás létrehoz egy bérletet a fájl-/fájlrendszeren, és egy új bérletazonosítót ad vissza.

acquire(lease_duration: int = -1, **kwargs: int | None) -> 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.

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 fájlrendszer vagy fájl 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érletmegszakítási időszak eltelhet, és ez alatt az idő alatt a fájlrendszerben vagy fájlban nem végezhető el a 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.

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 DataLake 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.

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 fájlrendszerrel vagy fájllal társítottakkal. A bérlet felszabadítása lehetővé teszi, hogy egy másik ügyfél azonnal megszerezze a fájlrendszer vagy fájl 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.

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 fájlrendszerrel vagy fájllal. Vegye figyelembe, hogy a bérlet akkor is megújítható, ha lejárt, ha a fájlrendszert vagy fájlt a bérlet lejárata óta nem adták tovább. A bérlet megújításakor a bérlet időtartama visszaá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-nek tekinti. 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 típusú dátum/idő időpontok UTC-vé lesznek konvertálva. Ha egy dátumot időzón-információ nélkül ad át, akkor a rendszer UTC-nek tekinti. Adja meg ezt a fejlécet 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 működik-e.

match_condition

MatchConditions

Az etagen használandó egyezési feltétel.

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át itt találja.

Válaszok

None