BlobLeaseClient Osztály
Létrehoz egy új BlobLeaseClientet.
Ez az ügyfél bérletműveleteket biztosít Egy BlobClient vagy ContainerClient esetében.
- Öröklődés
-
azure.storage.blob._lease.BlobLeaseClientBlobLeaseClient
Konstruktor
BlobLeaseClient(client: BlobClient | ContainerClient, lease_id: str | None = None)
Paraméterek
- lease_id
- str
Egy meglévő bérlet bérletazonosítóját jelölő sztring. Ezt az értéket nem kell megadni egy új bérlet beszerzéséhez vagy az egyik 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 tárolónak nincs aktív bérlete, 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 |
Bontsa fel a bérletet, ha a tároló vagy a blob rendelkezik aktív bérlettal. 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érletszakadási időszak lejár, és ez idő alatt a tárolón vagy blobon 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 lehet beszerezni. |
change |
Módosítsa egy aktív bérlet bérletazonosítóját. |
release |
Adja ki a bérletet. A bérlet felszabadítható, ha a megadott ügyfélbérlet-azonosító megegyezik a tárolóval vagy blobbal. 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 a kiadás befejezése után. |
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 azonosítóval. Vegye figyelembe, hogy a bérlet akkor is megújítható, ha lejárt, ha a tárolót vagy blobot 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 tárolónak nincs aktív bérlete, a Blob szolgáltatás létrehoz egy bérletet a tárolón, és egy új bérletazonosítót ad vissza.
async acquire(lease_duration: int = -1, **kwargs: Any) -> None
Paraméterek
- lease_duration
- int
Megadja a bérlet időtartamát másodpercben vagy negatív (-1) egy olyan bérlet esetén, 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 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. 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.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- 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.
Visszatérési típus
break_lease
Bontsa fel a bérletet, ha a tároló vagy a blob rendelkezik aktív bérlettal.
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érletszakadási időszak lejár, és ez idő alatt a tárolón vagy blobon 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 lehet beszerezni.
async 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. Ez a törési időszak csak akkor használatos, ha rövidebb, mint a bérletben fennmaradó idő. Ha hosszabb ideig tart, a rendszer a bérleten fennmaradó időt használja fel. A megszakítási időszak lejárta előtt nem lesz elérhető új bérlet, 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érlet szakad meg, és a végtelen bérlet azonnal megszakad.
- 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 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. 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.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- 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
A bérletidőszakban fennmaradó 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.
async change(proposed_lease_id: str, **kwargs: Any) -> None
Paraméterek
- proposed_lease_id
- str
Javasolt bérletazonosító GUID sztringformátumban. A Blob szolgáltatás 400-et (érvénytelen kérést) 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 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. 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.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- 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
release
Adja ki a bérletet.
A bérlet felszabadítható, ha a megadott ügyfélbérlet-azonosító megegyezik a tárolóval vagy blobbal. 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 a kiadás befejezése után.
async 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 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. 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.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- 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
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 azonosítóval. Vegye figyelembe, hogy a bérlet akkor is megújítható, ha lejárt, ha a tárolót vagy blobot 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.
async 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 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. 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.
- if_tags_match_condition
- str
Adjon meg egy SQL where záradékot a blobcímkéken, hogy csak egyező értékkel rendelkező blobon működjön.
például: "\"tagname\"='my tag'"
A 12.4.0-s verzió újdonsága.
- 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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: