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

blob_url

str

Kötelező

A blob teljes URI-ja. Ez sas-jogkivonatot is tartalmazhat.

output

str vagy <xref:<xref:writable stream>>

Kötelező

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

alapértelmezett érték: None

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

None

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

alapértelmezett érték: None

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