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.objectDataLakeLeaseClient
Konstruktor
DataLakeLeaseClient(client: FileSystemClient | DataLakeDirectoryClient | DataLakeFileClient, lease_id: str | None = None)
Paraméterek
- client
- FileSystemClient vagy DataLakeDirectoryClient vagy DataLakeFileClient
A bérletbe vett fájlrendszer, könyvtár vagy fájl ügyfele.
- lease_id
- str
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
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
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
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
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
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
Azure SDK for Python