Sdílet prostřednictvím

blob Balíček

  • Reference

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)