blob Balíček

Balíčky

aio

Třídy

AccessPolicy	Třída zásad přístupu používaná sadou a metodami zásad přístupu get v každé službě. Uložené zásady přístupu můžou určovat čas zahájení, čas vypršení platnosti a oprávnění pro sdílené přístupové podpisy, ke kterým jsou přidružené. V závislosti na tom, jak chcete řídit přístup k vašemu prostředku, můžete zadat všechny tyto parametry v rámci uložených zásad přístupu a vynechat je z adresy URL sdíleného přístupového podpisu. To vám umožní kdykoli změnit chování přidruženého podpisu a také ho odvolat. Nebo můžete zadat jeden nebo více parametrů zásad přístupu v rámci uložených zásad přístupu a ostatní na adrese URL. Nakonec můžete zadat všechny parametry adresy URL. V takovém případě můžete pomocí uložených zásad přístupu podpis odvolat, ale ne změnit jeho chování. Sdílený přístupový podpis a uložené zásady přístupu musí společně obsahovat všechna pole potřebná k ověření podpisu. Pokud některá požadovaná pole chybí, požadavek se nezdaří. Podobně pokud je pole zadané v adrese URL sdíleného přístupového podpisu i v uložených zásadách přístupu, požadavek selže se stavovým kódem 400 (Chybný požadavek).
AccountSasPermissions	ResourceTypes třída, která se má použít s funkcí generate_account_sas a pro accesspolicies používané s set_*_acl. Existují dva typy SAS, které se dají použít k udělení přístupu k prostředkům. Jedním z nich je udělení přístupu ke konkrétnímu prostředku (specifickému prostředku). Další je udělit přístup k celé službě pro konkrétní účet a povolit určité operace založené na příkladech, které najdete tady.
ArrowDialect	pole schématu šipky. Aby bylo možné odesílat do Azure, musí být vyplněny všechny požadované parametry.
BlobAnalyticsLogging	Nastavení protokolování Azure Analytics.
BlobBlock	BlockBlob Block – třída.
BlobClient	Klient pro interakci s konkrétním objektem blob, i když tento objekt blob ještě nemusí existovat. Další volitelnou konfiguraci potřebujete kliknutím sem.
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.
BlobProperties	Vlastnosti objektu blob.
BlobQueryError	K chybě došlo během rychlé operace dotazu.
BlobQueryReader	Objekt streamování pro čtení výsledků dotazu.
BlobSasPermissions	Třída BlobSasPermissions, která se má použít s generate_blob_sas funkcí.
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 . Další volitelnou konfiguraci potřebujete kliknutím sem.
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. Další volitelnou konfiguraci potřebujete kliknutím sem.
ContainerEncryptionScope	Výchozí konfigurace oboru šifrování pro kontejner. Tento obor se implicitně používá pro všechny budoucí zápisy v rámci kontejneru, ale je možné ho přepsat pro každou operaci objektu blob. Novinka ve verzi 12.2.0.
ContainerProperties	Třída vlastností kontejneru objektů blob Vrácené ContainerProperties instance zpřístupňují tyto hodnoty prostřednictvím rozhraní slovníku, například: container_props["last_modified"]. Kromě toho je název kontejneru k dispozici jako container_props["name"].
ContainerSasPermissions	ContainerSasPermissions Třída pro použití s generate_container_sas funkcí a pro AccessPolicies používané s set_container_access_policy.
ContentSettings	Nastavení obsahu objektu blob.
CopyProperties	Vlastnosti kopírování objektů blob. Tyto vlastnosti budou žádné, pokud tento objekt blob nikdy nebyl cílem operace Kopírování objektu blob nebo pokud byl tento objekt blob změněn po dokončení operace Kopírování objektu blob, například pomocí nastavení vlastností objektu blob, nahrání objektu blob nebo potvrzení seznamu blokovaných objektů.
CorsRule	CORS je funkce HTTP, která umožňuje webové aplikaci spuštěné v jedné doméně přistupovat k prostředkům v jiné doméně. Webové prohlížeče implementují omezení zabezpečení označované jako zásada stejného původu, které webové stránce znemožňuje volat rozhraní API v jiné doméně. CORS přináší zabezpečený způsob, jak je možné jedné doméně (tj. původní doméně) povolit volání rozhraní API v jiné doméně.
CustomerProvidedEncryptionKey	Všechna uložená data ve službě Azure Storage se šifrují pomocí šifrovacího klíče na úrovni účtu. Ve verzích 2018-06-17 a novějších můžete spravovat klíč používaný k šifrování obsahu objektů blob a metadat aplikace pro jednotlivé objekty blob poskytnutím šifrovacího klíče AES-256 v požadavcích na službu úložiště. Když použijete klíč poskytnutý zákazníkem, Azure Storage váš klíč nespravuje ani neuchovává. Při zápisu dat do objektu blob se zadaný klíč použije k šifrování dat před jejich zápisem na disk. Hodnota hash SHA-256 šifrovacího klíče se zapisuje společně s obsahem objektu blob a používá se k ověření, že všechny následné operace s objektem blob používají stejný šifrovací klíč. Tuto hodnotu hash nejde použít k načtení šifrovacího klíče nebo dešifrování obsahu objektu blob. Při čtení objektu blob se zadaný klíč použije k dešifrování dat po přečtení z disku. V obou případech se zadaný šifrovací klíč bezpečně zahodí, jakmile se dokončí proces šifrování nebo dešifrování.
DelimitedJsonDialect	Definuje vstupní nebo výstupní serializaci JSON pro dotaz na data objektů blob. keyword str delimiter: Znak oddělovače řádků, výchozí hodnota je ' '
DelimitedTextDialect	Definuje serializaci vstupu nebo výstupu s oddělovači (CSV) pro požadavek dotazu objektu 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í.
FilteredBlob	Informace o objektech blob z volání rozhraní API pro filtrování objektů blob
ImmutabilityPolicy	Volitelné parametry pro nastavení zásad neměnnosti objektu blob, snímku objektu blob nebo verze objektu blob. Novinka ve verzi 12.10.0: Tato verze byla zavedena ve verzi rozhraní API '2020-10-02'.
LeaseProperties	Vlastnosti zapůjčení objektů blob.
LinearRetry	Lineární opakování. Vytvoří objekt lineárního opakování.
LocationMode	Určuje umístění, do které se má požadavek odeslat. Tento režim platí jenom pro účty RA-GRS, které umožňují sekundární přístup ke čtení. Všechny ostatní typy účtů musí používat PRIMÁRNÍ.
Metrics	Souhrn statistik žádostí seskupených podle rozhraní API v hodinových nebo minutových agregacích pro objekty blob.
ObjectReplicationPolicy	ID zásad a ID pravidel použitých u objektu blob
ObjectReplicationRule	ID zásad a ID pravidel použitých u objektu blob
PageRange	Rozsah stránek pro objekt blob stránky.
PartialBatchErrorException	V dávkových operacích došlo k částečnému selhání.
ResourceTypes	Určuje typy prostředků, které jsou přístupné pomocí SAS účtu.
RetentionPolicy	Zásady uchovávání informací, které určují, jak dlouho se mají přidružená data uchovávat.
StaticWebsite	Vlastnosti, které umožňují účtu hostovat statický web.
StorageStreamDownloader	Streamovací objekt ke stažení ze služby Azure Storage.
UserDelegationKey	Představuje klíč delegování uživatele, který uživateli poskytuje Azure Storage na základě jeho přístupového tokenu Azure Active Directory. Pole jsou uložena jako jednoduché řetězce, protože uživatel nemusí pracovat s tímto objektem; k vygenerování identifikačního SAS může uživatel jednoduše předat správnému rozhraní API.

Výčty

ArrowType
BlobImmutabilityPolicyMode	Určuje režim zásad neměnnosti, který se má nastavit v objektu blob. Hodnotu "Mutable" může vrátit pouze služba, není nastavená na hodnotu "Mutable".
BlobType
BlockState	Typy bloků objektů blob bloku.
PremiumPageBlobTier	Určuje úroveň objektu blob stránky, na které se má objekt blob nastavit. To platí jenom pro objekty blob stránky v účtech premium storage. Podrobné informace o odpovídajících vstupně-výstupních operacích za sekundu a propustnosti na PageBlobTier najdete tady https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets .
PublicAccess	Určuje, jestli se k datům v kontejneru může přistupovat veřejně, a úroveň přístupu.
QuickQueryDialect	Určuje rychlý vstupní/výstupní dialekt dotazu.
RehydratePriority	Pokud je objekt ve stavu čekání na dosazování, vrátí se tato hlavička s prioritou rehydratace. Platné hodnoty jsou Vysoká a Standardní.
SequenceNumberAction	Akce pořadových čísel.
StandardBlobTier	Určuje úroveň objektu blob, na které se má objekt blob nastavit. To platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.
StorageErrorCode

Funkce

download_blob_from_url

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

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 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

Určuje, 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 True, provede se pokus o zápis do existujícího souboru. Pokud je předán popisovač datového proudu, je tato hodnota ignorována.

max_concurrency

int

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

offset

int

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

length

int

Počet bajtů, které se mají číst z datového proudu Tato možnost je volitelná, ale pro zajištění optimálního výkonu by měla být dodána.

validate_content

bool

Pokud je hodnota true, vypočítá hodnotu hash MD5 pro každý blok objektu blob. Služba úložiště zkontroluje hodnotu hash doručeného obsahu s odeslanou hodnotou hash. 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 neukládá s objektem blob. Všimněte si také, že pokud je povolená, nebude použit algoritmus nahrávání efektivní z paměti, 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 poškodí účel algoritmu efektivního pro paměť.

Návratový typ

None

generate_account_sas

Vygeneruje sdílený přístupový podpis pro službu Blob Service.

Použijte vrácený podpis s parametrem přihlašovacích údajů libovolného objektu BlobServiceClient, ContainerClient nebo BlobClient.

generate_account_sas(account_name: str, account_key: str, resource_types: ResourceTypes | str, permission: AccountSasPermissions | str, expiry: datetime | str | None, start: datetime | str | None = None, ip: str | None = None, **kwargs: Any) -> str

Parametry

account_name

str

Vyžadováno

Název účtu úložiště použitý k vygenerování sdíleného přístupového podpisu.

account_key

str

Vyžadováno

Klíč účtu, označovaný také jako sdílený klíč nebo přístupový klíč, pro vygenerování sdíleného přístupového podpisu.

resource_types

str nebo ResourceTypes

Vyžadováno

Určuje typy prostředků, které jsou přístupné pomocí sdíleného přístupového podpisu účtu.

permission

str nebo AccountSasPermissions

Vyžadováno

Oprávnění spojená se sdíleným přístupovým podpisem. Uživatel je omezen na operace povolené oprávněními. Vyžaduje se, pokud není zadáno ID odkazující na uložené zásady přístupu, které obsahují toto pole. Toto pole musí být vynecháno, pokud bylo zadáno v přidružených uložených zásadách přístupu.

expiry

datetime nebo str

Vyžadováno

Čas, kdy se sdílený přístupový podpis stane neplatným. Vyžaduje se, pokud není zadáno ID odkazující na uložené zásady přístupu, které obsahují toto pole. Toto pole musí být vynecháno, pokud bylo zadáno v přidružených uložených zásadách přístupu. Azure vždy převede hodnoty na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC.

start

datetime nebo str

výchozí hodnota: None

Čas, kdy sdílený přístupový podpis nabývá platnosti. Pokud ho vynecháte, předpokládá se, že čas zahájení tohoto volání je čas, kdy služba úložiště přijme požadavek. Azure vždy převede hodnoty na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC.

ip

str

výchozí hodnota: None

Určuje IP adresu nebo rozsah IP adres, ze kterých se mají požadavky přijímat. Pokud IP adresa, ze které požadavek pochází, neodpovídá IP adrese nebo rozsahu adres zadaným v tokenu SAS, požadavek se neověří. Například zadání ip=168.1.5.65 nebo ip=168.1.5.60-168.1.5.70 v SAS omezí požadavek na tyto IP adresy.

protocol

str

Určuje protokol povolený pro provedený požadavek. Výchozí hodnota je https.

encryption_scope

str

Určuje obor šifrování pro požadavek provedený tak, aby všechny operace zápisu byly zašifrovány službou.

Návraty

Token sdíleného přístupového podpisu (SAS).

Návratový typ

str

generate_blob_sas

Vygeneruje sdílený přístupový podpis pro objekt blob.

Použijte vrácený podpis s parametrem přihlašovacích údajů libovolného objektu BlobServiceClient, ContainerClient nebo BlobClient.

generate_blob_sas(account_name: str, container_name: str, blob_name: str, snapshot: str | None = None, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: BlobSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parametry

account_name

str

Vyžadováno

Název účtu úložiště použitý k vygenerování sdíleného přístupového podpisu.

container_name

str

Vyžadováno

Název kontejneru.

blob_name

str

Vyžadováno

Název objektu blob.

snapshot

str

výchozí hodnota: None

Volitelné ID snímku objektu blob.

account_key

str

výchozí hodnota: None

Klíč účtu, označovaný také jako sdílený klíč nebo přístupový klíč, pro vygenerování sdíleného přístupového podpisu. Je nutné zadat account_key nebo user_delegation_key .

user_delegation_key

UserDelegationKey

výchozí hodnota: None

Místo sdíleného klíče účtu může uživatel předat klíč delegování uživatele. Klíč delegování uživatele je možné ze služby získat ověřením pomocí identity AAD. toho lze dosáhnout voláním get_user_delegation_keymetody . Pokud existuje, sas se místo toho podepíše pomocí klíče delegování uživatele.

permission

str nebo BlobSasPermissions

výchozí hodnota: None

Oprávnění spojená se sdíleným přístupovým podpisem. Uživatel je omezen na operace povolené oprávněními. Oprávnění musí být seřazená racwdxytmei. Vyžaduje se, pokud není zadáno ID odkazující na uložené zásady přístupu, které obsahují toto pole. Toto pole musí být vynecháno, pokud bylo zadáno v přidružených uložených zásadách přístupu.

expiry

datetime nebo str

výchozí hodnota: None

Čas, kdy se sdílený přístupový podpis stane neplatným. Vyžaduje se, pokud není zadáno ID odkazující na uložené zásady přístupu, které obsahují toto pole. Toto pole musí být vynecháno, pokud bylo zadáno v přidružených uložených zásadách přístupu. Azure vždy převede hodnoty na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC.

start

datetime nebo str

výchozí hodnota: None

Čas, kdy sdílený přístupový podpis nabývá platnosti. Pokud ho vynecháte, předpokládá se, že čas zahájení tohoto volání je čas, kdy služba úložiště přijme požadavek. Azure vždy převede hodnoty na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC.

policy_id

str

výchozí hodnota: None

Jedinečná hodnota o délce až 64 znaků, která koreluje s uloženými zásadami přístupu. K vytvoření uložených zásad přístupu použijte set_container_access_policy.

ip

str

výchozí hodnota: None

Určuje IP adresu nebo rozsah IP adres, ze kterých se mají požadavky přijímat. Pokud IP adresa, ze které požadavek pochází, neodpovídá IP adrese nebo rozsahu adres zadaným v tokenu SAS, požadavek se neověří. Například zadání ip=168.1.5.65 nebo ip=168.1.5.60-168.1.5.70 v SAS omezí požadavek na tyto IP adresy.

version_id

str

Volitelné ID verze objektu blob. Tento parametr se dá použít jenom pro účty úložiště s povolenou správou verzí. Všimněte si, že parametr dotazu versionid není součástí výstupního SAS. Proto při použití výstupního sdíleného přístupového podpisu pro provoz na konkrétní verzi poskytněte všem rozhraním API parametr version_id.

Novinka ve verzi 12.4.0: Tento argument klíčového slova byl zaveden ve verzi rozhraní API z 2019-12-12.

protocol

str

Určuje protokol povolený pro provedený požadavek. Výchozí hodnota je https.

cache_control

str

Hodnota hlavičky odpovědi pro Cache-Control při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

content_disposition

str

Hodnota hlavičky odpovědi pro Content-Disposition při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

content_encoding

str

Hodnota hlavičky odpovědi pro Content-Encoding při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

content_language

str

Hodnota hlavičky odpovědi pro Content-Language při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

content_type

str

Hodnota hlavičky odpovědi pro Content-Type při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

encryption_scope

str

Určuje obor šifrování pro požadavek provedený tak, aby všechny operace zápisu byly zašifrovány službou.

correlation_id

str

ID korelace pro korelaci protokolů auditu úložiště s protokoly auditu používanými objektem zabezpečení, který generuje a distribuuje SAS. Tuto možnost je možné použít pouze při generování sdíleného přístupového podpisu s klíčem delegování.

Návraty

Token sdíleného přístupového podpisu (SAS).

Návratový typ

str

generate_container_sas

Vygeneruje sdílený přístupový podpis pro kontejner.

Použijte vrácený podpis s parametrem přihlašovacích údajů libovolného objektu BlobServiceClient, ContainerClient nebo BlobClient.

generate_container_sas(account_name: str, container_name: str, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: ContainerSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parametry

account_name

str

Vyžadováno

Název účtu úložiště použitý k vygenerování sdíleného přístupového podpisu.

container_name

str

Vyžadováno

Název kontejneru.

account_key

str

výchozí hodnota: None

Klíč účtu, označovaný také jako sdílený klíč nebo přístupový klíč, pro vygenerování sdíleného přístupového podpisu. Je nutné zadat account_key nebo user_delegation_key .

user_delegation_key

UserDelegationKey

výchozí hodnota: None

Místo sdíleného klíče účtu může uživatel předat klíč delegování uživatele. Klíč delegování uživatele je možné ze služby získat ověřením pomocí identity AAD. toho lze dosáhnout voláním get_user_delegation_keymetody . Pokud existuje, sas se místo toho podepíše pomocí klíče delegování uživatele.

permission

str nebo ContainerSasPermissions

výchozí hodnota: None

Oprávnění spojená se sdíleným přístupovým podpisem. Uživatel je omezen na operace povolené oprávněními. Oprávnění musí být seřazená racwdxyltfmei. Vyžaduje se, pokud není zadáno ID odkazující na uložené zásady přístupu, které obsahují toto pole. Toto pole musí být vynecháno, pokud bylo zadáno v přidružených uložených zásadách přístupu.

expiry

datetime nebo str

výchozí hodnota: None

Čas, kdy se sdílený přístupový podpis stane neplatným. Vyžaduje se, pokud není zadáno ID odkazující na uložené zásady přístupu, které obsahují toto pole. Toto pole musí být vynecháno, pokud bylo zadáno v přidružených uložených zásadách přístupu. Azure vždy převede hodnoty na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC.

start

datetime nebo str

výchozí hodnota: None

Čas, kdy sdílený přístupový podpis nabývá platnosti. Pokud ho vynecháte, předpokládá se, že čas zahájení tohoto volání je čas, kdy služba úložiště přijme požadavek. Azure vždy převede hodnoty na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC.

policy_id

str

výchozí hodnota: None

Jedinečná hodnota o délce až 64 znaků, která koreluje s uloženými zásadami přístupu. K vytvoření uložených zásad přístupu použijte set_container_access_policy.

ip

str

výchozí hodnota: None

Určuje IP adresu nebo rozsah IP adres, ze kterých se mají požadavky přijímat. Pokud IP adresa, ze které požadavek pochází, neodpovídá IP adrese nebo rozsahu adres zadaným v tokenu SAS, požadavek se neověří. Například zadání ip=168.1.5.65 nebo ip=168.1.5.60-168.1.5.70 v SAS omezí požadavek na tyto IP adresy.

protocol

str

Určuje protokol povolený pro provedený požadavek. Výchozí hodnota je https.

cache_control

str

Hodnota hlavičky odpovědi pro Cache-Control při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

content_disposition

str

Hodnota hlavičky odpovědi pro Content-Disposition při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

content_encoding

str

Hodnota hlavičky odpovědi pro Content-Encoding při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

content_language

str

Hodnota hlavičky odpovědi pro Content-Language při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

content_type

str

Hodnota hlavičky odpovědi pro Content-Type při přístupu k prostředku pomocí tohoto sdíleného přístupového podpisu.

encryption_scope

str

Určuje obor šifrování pro požadavek provedený tak, aby všechny operace zápisu byly zašifrovány službou.

correlation_id

str

ID korelace pro korelaci protokolů auditu úložiště s protokoly auditu používanými objektem zabezpečení, který generuje a distribuuje SAS. Tuto možnost je možné použít pouze při generování sdíleného přístupového podpisu s klíčem delegování.

Návraty

Token sdíleného přístupového podpisu (SAS).

Návratový typ

str

upload_blob_to_url

Nahrání dat na danou adresu URL

Data se nahrají jako objekt blob bloku.

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

blob_url

str

Vyžadováno

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

data

bytes nebo str nebo Iterable

Vyžadováno

Data, která se mají nahrát. Může se jednat o bajty, text, objekt s možností iterace nebo objekt podobný souboru.

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. 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 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

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.

max_concurrency

int

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

length

int

Počet bajtů, které se mají číst z datového proudu Tato možnost je volitelná, ale pro zajištění optimálního výkonu by měla být dodána.

metadata

dict(str,str)

Páry název-hodnota přidružené k objektu blob jako metadata.

validate_content

bool

Pokud je hodnota true, vypočítá hodnotu hash MD5 pro každý blok objektu blob. Služba úložiště zkontroluje hodnotu hash doručeného obsahu s odeslanou hodnotou hash. 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 neukládá s objektem blob. Všimněte si také, že pokud je povolená, nebude použit algoritmus nahrávání efektivní z paměti, 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 poškodí účel algoritmu efektivního pro paměť.

encoding

str

Kódování, které se má použít, pokud je jako vstup zadán text. Výchozí hodnota je UTF-8.

Návraty

Dikt vlastnosti aktualizovaného objektu blob (značka Etag a poslední změna)

Návratový typ

dict(str, Any)