aio Balíček

  • Reference

Třídy

BlobClient

Klient pro interakci s konkrétním objektem blob, i když tento objekt blob ještě nemusí existovat.
BlobLeaseClient

Vytvoří nový objekt BlobLeaseClient.

Tento klient poskytuje operace zapůjčení v objektech BlobClient nebo ContainerClient.
BlobPrefix

Iterable s vlastnostmi objektu blob.

Vrátí se z walk_blobs při použití oddělovače. Můžete si ho představit jako virtuální adresář objektů blob.
BlobServiceClient

Klient pro interakci se službou Blob Service na úrovni účtu.

Tento klient poskytuje operace pro načtení a konfiguraci vlastností účtu a také výpis, vytvoření a odstranění kontejnerů v rámci účtu. U operací souvisejících s konkrétním kontejnerem nebo objektem blob je možné klienty pro tyto entity načíst také pomocí funkcí get_client .
ContainerClient

Klient pro interakci s konkrétním kontejnerem, i když tento kontejner ještě nemusí existovat.

Pro operace související s konkrétním objektem blob v rámci tohoto kontejneru je možné pomocí funkce načíst get_blob_client klienta objektů blob.
ExponentialRetry

Exponenciální opakování.

Vytvoří objekt Exponenciální opakování. Pro první opakování se použije initial_backoff. Další opakování se po initial_backoff + increment_power^retry_count sekundách zopakují. Ve výchozím nastavení například k prvnímu opakování dochází po 15 sekundách, druhé po (15+3^1) = 18 sekund a třetí po (15+3^2) = 24 sekund.
LinearRetry

Lineární opakování.

Vytvoří objekt lineárního opakování.
StorageStreamDownloader

Streamovací objekt ke stažení ze služby Azure Storage.

Funkce

download_blob_from_url

Stáhněte obsah objektu blob do místního souboru nebo streamu.

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

Parametry

blob_url
str
Vyžadováno

Úplný identifikátor URI objektu blob To může zahrnovat také token SAS.

output
str nebo <xref:<xref:writable stream>>
Vyžadováno

Kam by se data měla stáhnout. Může to být buď cesta k souboru, do které se má zapisovat, nebo otevřený popisovač vstupně-výstupních operací, do které se má zapisovat.

credential
výchozí hodnota: None

Přihlašovací údaje, pomocí kterých se má ověřit. Tato možnost je volitelná, pokud adresa URL objektu blob už má token SAS nebo je objekt blob veřejný. Hodnotou může být řetězec tokenu SAS, instance AzureSasCredential nebo AzureNamedKeyCredential z azure.core.credentials, sdílený přístupový klíč účtu nebo instance třídy TokenCredentials z azure.identity. Pokud identifikátor URI prostředku už obsahuje token SAS, bude se tento token ignorovat ve prospěch explicitních přihlašovacích údajů.

  • s výjimkou případu AzureSasCredential, kde konfliktní tokeny SAS způsobí chybu ValueError. Pokud používáte instanci AzureNamedKeyCredential, název by měl být název účtu úložiště a klíč by měl být klíč účtu úložiště.
overwrite
bool

Zda má být místní soubor přepsán, pokud již existuje. Výchozí hodnota je False – v takovém případě bude vyvolána chyba ValueError, pokud soubor již existuje. Pokud je nastavená hodnota Pravda, provede se pokus o zápis do existujícího souboru. Pokud je obslužný rutina datového proudu předána, bude tato hodnota ignorována.

max_concurrency
int

Počet paralelních připojení ke stažení.

offset
int

Začátek rozsahu bajtů, který se má použít ke stažení části objektu blob. Pokud je k dispozici délka, musí být nastavena.

length
int

Počet bajtů ke čtení ze streamu Tato možnost je volitelná, ale pro zajištění optimálního výkonu by měla být poskytována.

validate_content
bool

Pokud ano, vypočítá hodnotu hash MD5 pro každý blok objektu blob. Služba úložiště zkontroluje hodnotu hash obsahu, která přišla s hodnotou hash, která byla odeslána. To je primárně užitečné pro detekci bitflips na drátu, pokud se už ověří použití protokolu HTTP místo https jako https (výchozí nastavení). Všimněte si, že tato hodnota hash MD5 se s objektem blob neukládá. Všimněte si také, že pokud je povolená, algoritmus nahrávání efektivní z paměti se nepoužije, protože výpočet hodnoty hash MD5 vyžaduje ukládání celých bloků do vyrovnávací paměti, a tím se porazí účel algoritmu efektivního z hlediska paměti.

Návratový typ

None

upload_blob_to_url

Nahrání dat na danou adresu URL

Data se nahrají jako objekt blob bloku.

param str blob_url: Úplný identifikátor URI objektu blob. To může zahrnovat také token SAS.

param data: Data, která se mají nahrát. Může se jednat o bajty, text, iterovatelný objekt nebo objekt podobný souboru.

typ dat: bajty nebo str nebo 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]

Parametry

credential
výchozí hodnota: None

Přihlašovací údaje, pomocí kterých se má ověřit. Tato možnost je volitelná, pokud adresa URL objektu blob už token SAS obsahuje. Hodnotou může být řetězec tokenu SAS, instance AzureSasCredential nebo AzureNamedKeyCredential z azure.core.credentials, sdílený přístupový klíč účtu nebo instance třídy TokenCredentials z azure.identity. Pokud identifikátor URI prostředku už obsahuje token SAS, bude se tento token ignorovat ve prospěch explicitních přihlašovacích údajů.

  • s výjimkou případu AzureSasCredential, kde konfliktní tokeny SAS způsobí chybu ValueError. Pokud používáte instanci AzureNamedKeyCredential, název by měl být název účtu úložiště a klíč by měl být klíč účtu úložiště.

přihlašovací údaje paramtype: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long

klíčové slovo bool overwrite: Jestli by měl objekt blob, který se má nahrát, přepsat aktuální data. Pokud je true, upload_blob_to_url přepíše všechna existující data. Pokud je nastavená hodnota False, operace selže s chybou ResourceExistsError.

keyword int max_concurrency: Počet paralelních připojení ke stažení.

keyword int length: Počet bajtů, které se mají číst ze streamu. Tato možnost je volitelná, ale pro zajištění optimálního výkonu by měla být poskytována.

metadata klíčového slova dict(str,str): Dvojice název-hodnota přidružené k objektu blob jako metadata.

klíčové slovo bool validate_content: Pokud je true, vypočítá hodnotu hash MD5 pro každý blok objektu blob. Služba úložiště zkontroluje hodnotu hash obsahu, která přišla s hodnotou hash, která byla odeslána. To je primárně užitečné pro detekci bitflips na drátu, pokud se už ověří použití protokolu HTTP místo https jako https (výchozí nastavení). Všimněte si, že tato hodnota hash MD5 se s objektem blob neukládá. Všimněte si také, že pokud je povolená, algoritmus nahrávání efektivní z paměti se nepoužije, protože výpočet hodnoty hash MD5 vyžaduje ukládání celých bloků do vyrovnávací paměti, a tím se porazí účel algoritmu efektivního z hlediska paměti.

kódování klíčového slova str: Kódování, které se použije, pokud je text zadán jako vstup. Výchozí hodnota je UTF-8.

returns: Objekt blob-updated property dict (Etag a naposledy změněno)

rtype: dict(str, Any)

blob_url
data