aio Csomag
Osztályok
BlobClient |
Egy ügyfél, amely egy adott blobot használ, bár ez a blob még nem létezik. |
BlobLeaseClient |
Létrehoz egy új BlobLeaseClientet. Ez az ügyfél bérletműveleteket biztosít Egy BlobClient vagy ContainerClient esetében. |
BlobPrefix |
Blobtulajdonságok iterable tulajdonsága. Ha elválasztót használ, walk_blobs adja vissza. Virtuális blobkönyvtárként is felfogható. |
BlobServiceClient |
Egy ügyfél, amely a blobszolgáltatással a fiók szintjén kommunikál. Ez az ügyfél műveleteket biztosít a fióktulajdonságok lekéréséhez és konfigurálásához, valamint a fiókon belüli tárolók létrehozásához és törléséhez. Egy adott tárolóhoz vagy blobhoz kapcsolódó műveletek esetén az entitások ügyfelei a get_client függvényekkel is lekérhetők. |
ContainerClient |
Egy adott tárolóval kommunikáló ügyfél, bár előfordulhat, hogy ez a tároló még nem létezik. A tárolón belüli adott blobokkal kapcsolatos műveletek esetén a blobügyfél lekérhető a get_blob_client függvénnyel. |
ExponentialRetry |
Exponenciális újrapróbálkozás. Exponenciális újrapróbálkozási objektumot állít össze. Az első újrapróbálkozáshoz a initial_backoff használja a rendszer. A következő újrapróbálkozások initial_backoff + increment_power^retry_count másodperc után újrapróbálkoznak. Az első újrapróbálkozás például alapértelmezés szerint 15 másodperc, a második (15+3^1) = 18 másodperc, a harmadik pedig (15+3^2) = 24 másodperc után következik be. |
LinearRetry |
Lineáris újrapróbálkozás. Lineáris újrapróbálkozás objektumot hoz létre. |
StorageStreamDownloader |
Az Azure Storage-ból letölthető streamobjektum. |
Függvények
download_blob_from_url
Töltse le egy blob tartalmát egy helyi fájlba vagy streambe.
async download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None
Paraméterek
- output
- str vagy <xref:<xref:writable stream>>
Ahová az adatokat le kell tölteni. Ez lehet egy fájl elérési útja, amelybe írni szeretne, vagy egy nyitott I/O-leíró, amelybe írni szeretne.
- credential
A hitelesítéshez használt hitelesítő adatok. Ez nem kötelező, ha a blob URL-címe már rendelkezik SAS-jogkivonattal, vagy a blob nyilvános. Az érték lehet SAS-jogkivonat-sztring, az AzureSasCredential vagy az AzureNamedKeyCredential példánya az azure.core.credentials-ből, egy fiók megosztott hozzáférési kulcsa vagy az azure.identity tokencredentials osztályának egy példánya. Ha az erőforrás URI-ja már tartalmaz SAS-jogkivonatot, a rendszer ezt figyelmen kívül hagyja egy explicit hitelesítő adat mellett.
- kivéve az AzureSasCredential esetében, ahol az ütköző SAS-jogkivonatok ValueError értéket fognak létrehozni. Ha az AzureNamedKeyCredential egy példányát használja, a "name" legyen a tárfiók neve, a "kulcs" pedig a tárfiók kulcsa.
- overwrite
- bool
Felülírja-e a helyi fájlt, ha már létezik. Az alapértelmezett érték Hamis – ebben az esetben egy ValueError érték jelenik meg, ha a fájl már létezik. Ha igaz értékre van állítva, a rendszer megkísérel írni a meglévő fájlba. Ha egy streamfogantyút ad át, a rendszer figyelmen kívül hagyja ezt az értéket.
- max_concurrency
- int
Azoknak a párhuzamos kapcsolatoknak a száma, amelyekkel le kell tölteni.
- offset
- int
A blob egy szakaszának letöltéséhez használandó bájttartomány kezdete. Ha a hossz meg van adva, be kell állítani.
- length
- int
A streamből beolvasandó bájtok száma. Ez nem kötelező, de az optimális teljesítmény érdekében kell megadni.
- validate_content
- bool
Ha igaz, kiszámít egy MD5-kivonatot a blob minden egyes darabjára. A tárolási szolgáltatás ellenőrzi annak a tartalomnak a kivonatát, amely az elküldött kivonattal érkezett. Ez elsősorban akkor hasznos, ha bitflipeket észlel a vezetéken, ha a https helyett http-t használ, mivel a https (alapértelmezett) már érvényesíthető. Vegye figyelembe, hogy ez az MD5-kivonat nem a blobban van tárolva. Azt is vegye figyelembe, hogy ha engedélyezve van, a memóriahatékony feltöltési algoritmus nem lesz használva, mivel az MD5 kivonatának kiszámításához teljes blokkok pufferelésére van szükség, és ez nem teszi lehetővé a memóriahatékony algoritmus használatát.
Visszatérési típus
upload_blob_to_url
Adatok feltöltése egy adott URL-címre
Az adatok blokkblobként lesznek feltöltve.
param str blob_url: A blob teljes URI-ja. Ez sas-jogkivonatot is tartalmazhat.
param adatok: A feltöltendő adatok. Ez lehet bájt, szöveg, iterálási vagy fájlszerű objektum.
adattípus: bájt vagy str vagy iterable
async upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> dict[str, Any]
Paraméterek
- credential
A hitelesítéshez használt hitelesítő adatok. Ez nem kötelező, ha a blob URL-címe már rendelkezik SAS-jogkivonattal. Az érték lehet SAS-jogkivonat-sztring, az AzureSasCredential vagy az AzureNamedKeyCredential példánya az azure.core.credentials-ből, egy fiók megosztott hozzáférési kulcsa vagy az azure.identity tokencredentials osztályának egy példánya. Ha az erőforrás URI-ja már tartalmaz SAS-jogkivonatot, a rendszer ezt figyelmen kívül hagyja egy explicit hitelesítő adat mellett.
- kivéve az AzureSasCredential esetében, ahol az ütköző SAS-jogkivonatok ValueError értéket fognak létrehozni. Ha az AzureNamedKeyCredential egy példányát használja, a "name" legyen a tárfiók neve, a "kulcs" pedig a tárfiók kulcsa.
paramtype credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long
keyword bool overwrite: Azt jelzi, hogy a feltöltendő blob felülírja-e az aktuális adatokat. Ha igaz, upload_blob_to_url felülírja a meglévő adatokat. Ha False (Hamis) értékre van állítva, a művelet ResourceExistsError értékkel meghiúsul.
keyword int max_concurrency: Azoknak a párhuzamos kapcsolatoknak a száma, amelyekkel le kell tölteni.
keyword int length(Kulcsszó int length): A streamből beolvasandó bájtok száma. Ez nem kötelező, de az optimális teljesítmény érdekében kell megadni.
keyword dict(str,str) metadata: A blobhoz metaadatként társított név-érték párok.
keyword bool validate_content: Ha igaz, kiszámít egy MD5-kivonatot a blob minden egyes darabjára. A tárolási szolgáltatás ellenőrzi annak a tartalomnak a kivonatát, amely az elküldött kivonattal érkezett. Ez elsősorban akkor hasznos, ha bitflipeket észlel a vezetéken, ha a https helyett http-t használ, mivel a https (alapértelmezett) már érvényesíthető. Vegye figyelembe, hogy ez az MD5-kivonat nem a blobban van tárolva. Azt is vegye figyelembe, hogy ha engedélyezve van, a memóriahatékony feltöltési algoritmus nem lesz használva, mivel az MD5 kivonatának kiszámításához teljes blokkok pufferelésére van szükség, és ez nem teszi lehetővé a memóriahatékony algoritmus használatát.
kulcsszó str kódolása: Kódolás, ha a szöveg bemenetként van megadva. Alapértelmezés szerint UTF-8.
visszaadja: Blob által frissített tulajdonságdikt (Etag és utolsó módosítás)
rtype: dict(str, Any)
- blob_url
- data
Azure SDK for Python