azure.storage.blob.blockblobservice.BlockBlobService class

Přeruší čekající operaci copy_blob a ponechá cílový objekt blob s nulovou délkou a úplnými metadaty.

abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název cílového kontejneru.

blob_name: str

Vyžadováno

Název cílového objektu blob.

copy_id: str

Vyžadováno

Identifikátor kopírování zadaný v copy.id původní operace copy_blob.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má cílový objekt blob aktivní nekonečné zapůjčení.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách.

Požádá o nové zapůjčení. Pokud objekt blob nemá aktivní zapůjčení, služba Blob Service vytvoří zapůjčení objektu blob a vrátí nové ID zapůjčení.

acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

blob_name: str

Vyžadováno

Název existujícího objektu blob

lease_duration: int

výchozí hodnota: -1

Určuje dobu zapůjčení v sekundách nebo zápornou dobu (-1) pro zapůjčení, jehož platnost nikdy nevyprší. Nenekonečná zapůjčení může být mezi 15 a 60 sekund. Dobu trvání zapůjčení není možné změnit obnovením nebo změnou. Výchozí hodnota je -1 (nekonečné zapůjčení).

proposed_lease_id: str

výchozí hodnota: None

Navrhované ID zapůjčení ve formátu řetězce GUID Pokud navrhované ID zapůjčení není ve správném formátu, vrátí služba Blob Service hodnotu 400 (neplatný požadavek).

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného času změnil.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (*). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak (), který provede operaci pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách.

Návraty

Str

Požádá o nové zapůjčení. Pokud kontejner nemá aktivní zapůjčení, služba Blob Service vytvoří zapůjčení kontejneru a vrátí nové ID zapůjčení.

acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

lease_duration: int

výchozí hodnota: -1

Určuje dobu zapůjčení v sekundách nebo zápornou dobu (-1) pro zapůjčení, jehož platnost nikdy nevyprší. Nenekonečná zapůjčení může být mezi 15 a 60 sekund. Dobu trvání zapůjčení není možné změnit obnovením nebo změnou. Výchozí hodnota je -1 (nekonečné zapůjčení).

proposed_lease_id: str

výchozí hodnota: None

Navrhované ID zapůjčení ve formátu řetězce GUID Pokud navrhované ID zapůjčení není ve správném formátu, vrátí služba Blob Service hodnotu 400 (neplatný požadavek).

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného času změnil.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách.

Návraty

Str

Odešle dávku několika žádostí o odstranění objektů blob.

Metoda odstranění objektu blob odstraní zadaný objekt blob nebo snímek. Upozorňujeme, že odstraněním objektu blob se odstraní také všechny jeho snímky. Další informace najdete v tématu https://docs.microsoft.com/rest/api/storageservices/delete-blob.

batch_delete_blobs(batch_delete_sub_requests, timeout=None)

Parametry

batch_delete_sub_requests: list(BatchDeleteSubRequest)

Vyžadováno

Požadavky na odstranění objektu blob, které se mají odeslat jako dávky.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Odpověď HTTP na parsované dávkové odstranění

Návratový typ

list <xref:of> BatchSubResponse

Odesílá dávku požadavků na více úrovní objektů blob bloku. Toto rozhraní API se podporuje jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

batch_set_standard_blob_tier(batch_set_blob_tier_sub_requests, timeout=None)

Parametry

batch_set_blob_tier_sub_requests: list(BatchSetBlobTierSubRequest)

Vyžadováno

Nastavené požadavky na úroveň objektů blob bloku, které se mají odeslat jako dávka.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se bude vztahovat na každé volání zvlášť.

Návraty

Parsovaná odpověď HTTP vrstvy dávkové sady, která označuje, jestli je každý dílčí požadavek úspěšný.

Návratový typ

list <xref:of> BatchSubResponse

Pokud má objekt blob aktivní zapůjčení, přeruší zapůjčení. Jakmile je zapůjčení přerušeno, nelze ho obnovit. Jakákoli autorizovaná žádost může přerušit zapůjčení; požadavek není nutný k zadání odpovídajícího ID zapůjčení. Pokud je zapůjčení přerušené, může uplynout období přerušení zapůjčení, během kterého se s objektem blob nedají provádět žádné operace zapůjčení s výjimkou přerušení a uvolnění. Pokud je zapůjčení úspěšně přerušeno, odpověď indikuje interval v sekundách, dokud nebude možné získat nové zapůjčení.

Zapůjčení, které bylo přerušeno, může být také uvolněno. V takovém případě může zapůjčení objektu blob okamžitě získat jiný klient.

break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

lease_break_period: int

výchozí hodnota: None

U operace přerušení je to navrhovaná doba trvání sekund, po které by zapůjčení mělo pokračovat, než se přeruší, od 0 do 60 sekund. Toto období přestávky se použije pouze v případě, že je kratší než zbývající doba zapůjčení. Pokud je delší, použije se zbývající doba zapůjčení. Nové zapůjčení nebude k dispozici před vypršením doby přerušení, ale zapůjčení může být drženo déle, než je doba přerušení. Pokud se tato hlavička nezobrazí s operací přerušení, po uplynutí zbývající doby zapůjčení se přeruší zapůjčení na dobu určitou a nekonečné zapůjčení se okamžitě přeruší.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

int

Pokud má kontejner aktivní zapůjčení, přerušte zapůjčení. Jakmile je zapůjčení přerušeno, nelze ho obnovit. Jakákoli autorizovaná žádost může přerušit zapůjčení; požadavek není nutný k zadání odpovídajícího ID zapůjčení. Pokud je zapůjčení přerušeno, může uplynout období přerušení zapůjčení, během kterého se v kontejneru nedají provádět žádné operace zapůjčení s výjimkou přerušení a uvolnění. Pokud je zapůjčení úspěšně přerušeno, odpověď indikuje interval v sekundách, dokud nebude možné získat nové zapůjčení.

break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

lease_break_period: int

výchozí hodnota: None

Toto je navrhovaná doba trvání sekund, kterou by mělo zapůjčení pokračovat, než se přeruší, mezi 0 a 60 sekund. Toto období přestávky se použije pouze v případě, že je kratší než zbývající doba zapůjčení. Pokud je delší, použije se zbývající doba zapůjčení. Nové zapůjčení nebude k dispozici před vypršením doby přerušení, ale zapůjčení může být drženo déle, než je doba přerušení. Pokud se tato hlavička nezobrazí s operací přerušení, po uplynutí zbývající doby zapůjčení se přeruší zapůjčení na dobu určitou a nekonečné zapůjčení se okamžitě přeruší.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

int

Změní ID zapůjčení aktivního zapůjčení. Změna musí zahrnovat aktuální ID zapůjčení a nové ID zapůjčení.

change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

lease_id: str

Vyžadováno

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

proposed_lease_id: str

Vyžadováno

Navrhované ID zapůjčení ve formátu řetězce GUID Pokud navrhované ID zapůjčení není ve správném formátu, vrátí služba Blob Service hodnotu 400 (Neplatný požadavek).

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Změňte ID zapůjčení aktivního zapůjčení. Změna musí zahrnovat aktuální ID zapůjčení a nové ID zapůjčení.

change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

lease_id: str

Vyžadováno

ID zapůjčení pro aktivní zapůjčení

proposed_lease_id: str

Vyžadováno

Navrhované ID zapůjčení ve formátu řetězce GUID Pokud navrhované ID zapůjčení není ve správném formátu, vrátí služba Blob Service hodnotu 400 (Neplatný požadavek).

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Zkopíruje objekt blob. Tato operace vrátí objekt vlastností operace kopírování. Operace kopírování může být nakonfigurována tak, aby byla buď asynchronní, co se snaží, nebo synchronní operace.

Pokud má requires_sync hodnotu true, musí být zdrojem objekt blob bloku. Všechny existující cílové objekty blob se přepíšou. Cílový objekt blob nelze změnit, když probíhá operace kopírování.

Při kopírování z objektu blob bloku se zkopírují všechny potvrzené bloky a jejich ID bloků. Nepotvrzené bloky se nekopírují. Na konci operace kopírování bude mít cílový objekt blob stejný počet potvrzených bloků jako zdroj.

Můžete volat get_blob_properties v cílovém objektu blob a zkontrolovat stav operace kopírování. Konečný objekt blob se potvrdí po dokončení kopírování.

Název cílového kontejneru Kontejner musí existovat. :p aram str blob_name: Název cílového objektu blob. Pokud cílový objekt blob existuje, přepíše se. V opačném případě se vytvoří. :p aram str copy_source: Adresa URL o délce až 2 kB, která určuje soubor nebo objekt blob Azure. Hodnota by měla být zakódovaná jako adresa URL, jak by se zobrazovala v identifikátoru URI požadavku. Pokud je zdroj v jiném účtu, musí být buď veřejný, nebo musí být ověřený prostřednictvím sdíleného přístupového podpisu. Pokud je zdroj veřejný, nevyžaduje se žádné ověřování. Příklady: https://myaccount.blob.core.windows.net/mycontainer/myblob https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram metadata: Dvojice název-hodnota přidružené k objektu blob jako metadata. Pokud nejsou zadané žádné páry název-hodnota, operace zkopíruje metadata ze zdrojového objektu blob nebo souboru do cílového objektu blob. Pokud je zadána jedna nebo více dvojic název-hodnota, cílový objekt blob se vytvoří se zadanými metadaty a metadata se ze zdrojového objektu blob nebo souboru nezkopírují. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že zdrojový objekt blob byl od zadaného data a času změněn. :p aram datetime source_if_unmodified_since: Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že zdrojový objekt blob nebyl od zadaného data a času změněn. :p aram ETag source_if_match: Hodnota značky ETag nebo zástupný znak (). Zadáním této podmíněné hlavičky zkopírujete zdrojový objekt blob pouze v případě, že jeho značka ETag odpovídá zadané hodnotě. Pokud se hodnoty značky ETag neshodují, vrátí služba Blob service stavový kód 412 (Předběžná podmínka se nezdařila). Tuto hlavičku nelze zadat, pokud je zdrojem Soubor Azure. :p aram ETag source_if_none_match: Hodnota značky ETag nebo zástupný znak (). Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že jeho značka ETag neodpovídá zadané hodnotě. Pokud jsou hodnoty identické, vrátí služba Blob Service stavový kód 412 (Předběžná podmínka se nezdařila). Tuto hlavičku nelze zadat, pokud je zdrojem Soubor Azure. :p aram datetime destination_if_modified_since: Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že se cílový objekt blob od zadaného data a času změnil. Pokud se cílový objekt blob nezměnil, vrátí služba Blob service stavový kód 412 (Předběžná podmínka se nezdařila). :p aram datetime destination_if_unmodified_since: Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že cílový objekt blob nebyl od zadaného data a času změněn. Pokud se cílový objekt blob změnil, vrátí služba Blob service stavový kód 412 (Předběžná podmínka se nezdařila). :p aram ETag destination_if_match: Hodnota značky ETag nebo zástupný znak (). Zadáním hodnoty ETag pro tuto podmíněnou hlavičku zkopírujte objekt blob pouze v případě, že zadaná hodnota značky ETag odpovídá hodnotě ETag pro existující cílový objekt blob. Pokud značka ETag cílového objektu blob neodpovídá značkě ETag zadané pro If-Match, vrátí služba Blob service stavový kód 412 (Předběžná podmínka selhala). :p aram ETag destination_if_none_match: Hodnota značky ETag nebo zástupný znak (). Zadáním hodnoty ETag pro tuto podmíněnou hlavičku zkopírujte objekt blob pouze v případě, že zadaná hodnota značky ETag neodpovídá hodnotě ETag cílového objektu blob. Zadejte zástupný znak (*), který provede operaci pouze v případě, že cílový objekt blob neexistuje. Pokud zadaná podmínka není splněná, vrátí služba Blob service stavový kód 412 (Předběžná podmínka selhala). :p aram str destination_lease_id: ID zapůjčení zadané pro tuto hlavičku se musí shodovat s ID zapůjčení cílového objektu blob. Pokud požadavek neobsahuje ID zapůjčení nebo není platný, operace selže se stavovým kódem 412 (Předběžná podmínka selhala). :p aram str source_lease_id: Tuto možnost zadejte, pokud chcete operaci kopírování objektu blob provést pouze v případě, že zadané ID zapůjčení odpovídá ID aktivního zapůjčení zdrojového objektu blob. časový limit :p aram int: Parametr časového limitu se vyjadřuje v sekundách. :p aram bool requires_sync: Vynucuje, že služba nevrátí odpověď, dokud se kopírování nedokončí. :p aram StandardBlobTier standard_blob_tier: Standardní hodnota úrovně objektu blob, na kterou se objekt blob nastaví. Pro tuto verzi knihovny to platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard. :p aram RehydratePriority rehydrate_priority: Určuje prioritu, se kterou se má rehydrovat archivovaný objekt blob:return: Vlastnosti operace kopírování, jako jsou stav, zdroj a ID. :rtype: CopyProperties

copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None, requires_sync=None, standard_blob_tier=None, rehydrate_priority=None)

Parametry

container_name: str

Vyžadováno

blob_name

Vyžadováno

copy_source

Vyžadováno

metadata

výchozí hodnota: None

source_if_modified_since

výchozí hodnota: None

source_if_unmodified_since

výchozí hodnota: None

source_if_match

výchozí hodnota: None

source_if_none_match

výchozí hodnota: None

destination_if_modified_since

výchozí hodnota: None

destination_if_unmodified_since

výchozí hodnota: None

destination_if_match

výchozí hodnota: None

destination_if_none_match

výchozí hodnota: None

destination_lease_id

výchozí hodnota: None

source_lease_id

výchozí hodnota: None

timeout

výchozí hodnota: None

requires_sync

výchozí hodnota: None

standard_blob_tier

výchozí hodnota: None

rehydrate_priority

výchozí hodnota: None

Vytvoří nový objekt blob z pole bajtů nebo aktualizuje obsah existujícího objektu blob s automatickými oznámeními o blokování dat a průběhu.

create_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

blob_name: str

Vyžadováno

Název objektu blob, který se má vytvořit nebo aktualizovat.

blob: bytes

Vyžadováno

Obsah objektu blob jako pole bajtů

index: int

výchozí hodnota: 0

Spusťte index v poli bajtů.

count: int

výchozí hodnota: None

Počet bajtů k nahrání Pokud chcete nahrát všechny bajty počínaje indexem, nastavte možnost Žádné nebo záporná hodnota.

content_settings: ContentSettings

výchozí hodnota: None

Objekt ContentSettings použitý k nastavení vlastností objektu blob.

metadata: dict(str, str)

výchozí hodnota: None

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

validate_content: bool

výchozí hodnota: False

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.

progress_callback: <xref:func>(<xref:current>, <xref:total>)

výchozí hodnota: None

Zpětné volání pro průběh funkce signatury (aktuální, celkem), kde aktuální je počet dosud přenesených bajtů a celkový počet je velikost objektu blob, nebo Žádné, pokud je celková velikost neznámá.

max_connections: int

výchozí hodnota: 2

Maximální počet paralelních připojení, která se mají použít, když velikost objektu blob překročí 64 MB.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného času změnil.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (*). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak (), který provede operaci pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes protokol HTTPS. Vzhledem k tomu, že požadavek poskytuje samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se použije pro každé volání zvlášť.

standard_blob_tier: StandardBlobTier

výchozí hodnota: None

Standardní hodnota úrovně objektu blob, na kterou se objekt blob nastaví. Pro tuto verzi knihovny to platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

Návraty

Značka ETag a vlastnosti poslední změny objektu blob bloku

Návratový typ

ResourceProperties

Vytvoří nový objekt blob z cesty k souboru nebo aktualizuje obsah existujícího objektu blob s automatickými oznámeními o blokování dat a průběhu.

create_blob_from_path(container_name, blob_name, file_path, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název objektu blob, který se má vytvořit nebo aktualizovat.

file_path: str

Vyžadováno

Cesta k souboru, který se má nahrát jako obsah objektu blob.

content_settings: ContentSettings

výchozí hodnota: None

Objekt ContentSettings použitý k nastavení vlastností objektu blob.

metadata: dict(str, str)

výchozí hodnota: None

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

validate_content: bool

výchozí hodnota: False

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.

progress_callback: <xref:func>(<xref:current>, <xref:total>)

výchozí hodnota: None

Zpětné volání pro průběh s funkcí signatury (aktuální, celkem), kde aktuální je počet přenesených bajtů a celkový počet je velikost objektu blob, nebo Žádné, pokud je celková velikost neznámá.

max_connections: int

výchozí hodnota: 2

Maximální počet paralelních připojení, která se mají použít, když velikost objektu blob překročí 64 MB.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se bude vztahovat na každé volání zvlášť.

standard_blob_tier: StandardBlobTier

výchozí hodnota: None

Standardní hodnota úrovně objektu blob, na kterou se má objekt blob nastavit. Pro tuto verzi knihovny to platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

Návraty

Značky ETag a vlastnosti poslední změny objektu blob bloku

Návratový typ

ResourceProperties

Vytvoří nový objekt blob ze souboru nebo streamu nebo aktualizuje obsah existujícího objektu blob s automatickými oznámeními o blokování dat a průběhu.

create_blob_from_stream(container_name, blob_name, stream, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, use_byte_buffer=False, standard_blob_tier=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název objektu blob, který se má vytvořit nebo aktualizovat.

stream: IOBase

Vyžadováno

Byl otevřen soubor nebo stream, který se má nahrát jako obsah objektu blob.

count: int

výchozí hodnota: None

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.

content_settings: ContentSettings

výchozí hodnota: None

Objekt ContentSettings použitý k nastavení vlastností objektu blob.

metadata: dict(str, str)

výchozí hodnota: None

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

validate_content: bool

výchozí hodnota: False

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.

progress_callback: <xref:func>(<xref:current>, <xref:total>)

výchozí hodnota: None

Zpětné volání pro průběh s funkcí signatury (aktuální, celkem), kde aktuální je počet přenesených bajtů a celkový počet je velikost objektu blob, nebo Žádné, pokud je celková velikost neznámá.

max_connections: int

výchozí hodnota: 2

Maximální počet paralelních připojení, která se mají použít, když velikost objektu blob překročí 64 MB. Všimněte si, že paralelní nahrávání vyžaduje, aby byl datový proud vyhledatelný.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se bude vztahovat na každé volání zvlášť.

use_byte_buffer: bool

výchozí hodnota: False

Pokud je hodnota True, vynutíte to použití původní cesty pro uložení do vyrovnávací paměti s úplným blokem. Ve výchozím nastavení je tato hodnota False a bude používat algoritmus nahrávání streamování efektivní z paměti za následujících podmínek: Zadaný datový proud je vyhledatelný, "require_encryption" je False a MAX_BLOCK_SIZE >= MIN_LARGE_BLOCK_UPLOAD_THRESHOLD. Jeden by měl zvážit nevýhody použití tohoto přístupu. Za účelem dosažení efektivity paměti je datový proud IOBase nebo objekt podobný souboru segmentován do logických bloků pomocí obálky SubStream. Aby bylo možné číst správná data, musí každý substream získat zámek, aby mohl bezpečně hledat správnou pozici ve sdíleném podkladovém datovém proudu. Pokud max_connections > 1, souběžnost bude mít za následek značné množství hledání v podkladovém datovém proudu. U nejběžnějších vstupů, jako je objekt streamu podobného souboru, je hledání levnou operací, která není příliš starostí. U jiných variant datových proudů to ale nemusí být tento případ. Kompromis za efektivitu paměti se musí zvážit oproti nákladům na hledání se vstupním datovým proudem. Třída SubStream se pokusí ukládat do vyrovnávací paměti až 4 MB interně, aby se snížil počet volání hledání a čtení podkladového datového proudu. To je zvlášť užitečné při nahrávání větších bloků.

standard_blob_tier: StandardBlobTier

výchozí hodnota: None

Standardní hodnota úrovně objektu blob, na kterou se má objekt blob nastavit. Pro tuto verzi knihovny to platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

Návraty

Značky ETag a vlastnosti poslední změny objektu blob bloku

Návratový typ

ResourceProperties

Vytvoří nový objekt blob ze souboru str/unicode nebo aktualizuje obsah existujícího objektu blob s automatickými oznámeními o změnách dat a průběhu.

create_blob_from_text(container_name, blob_name, text, encoding='utf-8', content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název objektu blob, který se má vytvořit nebo aktualizovat.

text: str

Vyžadováno

Text, který se má nahrát do objektu blob.

encoding: str

výchozí hodnota: utf-8

Kódování Pythonu, které se má použít k převodu textu na bajty.

content_settings: ContentSettings

výchozí hodnota: None

Objekt ContentSettings použitý k nastavení vlastností objektu blob.

metadata: dict(str, str)

výchozí hodnota: None

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

validate_content: bool

výchozí hodnota: False

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

progress_callback: <xref:func>(<xref:current>, <xref:total>)

výchozí hodnota: None

Zpětné volání pro průběh s funkcí signatury (aktuální, celkem), kde aktuální je počet přenesených bajtů a celkový počet je velikost objektu blob, nebo Žádné, pokud je celková velikost neznámá.

max_connections: int

výchozí hodnota: 2

Maximální počet paralelních připojení, která se mají použít, když velikost objektu blob překročí 64 MB.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se bude vztahovat na každé volání zvlášť.

standard_blob_tier: StandardBlobTier

výchozí hodnota: None

Standardní hodnota úrovně objektu blob, na kterou se má objekt blob nastavit. Pro tuto verzi knihovny to platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

Návraty

Značky ETag a vlastnosti poslední změny objektu blob bloku

Návratový typ

ResourceProperties

Vytvoří nový kontejner pod zadaným účtem. Pokud kontejner se stejným názvem již existuje, operace selže, pokud fail_on_exist má hodnotu True.

create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)

Parametry

container_name: str

Vyžadováno

Název kontejneru, který chcete vytvořit. Název kontejneru může obsahovat pouze malá písmena, číslice a spojovníky a musí začínat písmenem nebo číslicí. Před i za každým spojovníkem musí být jiný znak než spojovník. Název musí mít délku 3 až 63 znaků.

metadata: dict(str, str)

výchozí hodnota: None

Dikt s name_value páry, které se přidružují ke kontejneru jako metadata. Příklad:{'Category':'test'}

public_access: PublicAccess

výchozí hodnota: None

Mezi možné hodnoty patří: kontejner, objekt blob.

fail_on_exist: bool

výchozí hodnota: False

Určete, jestli se má vyvolat výjimka, když kontejner existuje.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

True, pokud je kontejner vytvořen, false, pokud kontejner již existuje.

Návratový typ

bool

Označí zadaný objekt blob nebo snímek pro odstranění. Objekt blob se později odstraní během uvolňování paměti.

Upozorňujeme, že pokud chcete odstranit objekt blob, musíte odstranit všechny jeho snímky. Obojí můžete odstranit současně pomocí operace Odstranění objektu blob.

Pokud je pro službu povolená zásada uchovávání informací o odstranění, pak tato operace obnovitelné odstraní objekt blob nebo snímek a zachová objekt blob nebo snímek po zadaný počet dnů. Po zadaném počtu dnů se data objektu blob odeberou ze služby během uvolňování paměti. Obnovitelně odstraněný objekt blob nebo snímek je přístupný prostřednictvím rozhraní API seznamu objektů blob, které určuje možnost include=Include.Deleted. Obnovitelně odstraněný objekt blob nebo snímek je možné obnovit pomocí rozhraní API pro odstranění.

delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

snapshot: str

výchozí hodnota: None

Parametr snapshot je neprůsažná hodnota DateTime, která pokud je k dispozici, určuje snímek objektu blob, který se má odstranit.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

delete_snapshots: DeleteSnapshot

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob přidružené snímky.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Označí zadaný kontejner pro odstranění. Kontejner a všechny objekty blob v něm obsažené se později odstraní během uvolňování paměti.

delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název kontejneru, který chcete odstranit.

fail_not_exist: bool

výchozí hodnota: False

Určete, jestli má dojít k výjimce, když kontejner neexistuje.

lease_id: str

výchozí hodnota: None

Pokud je zadáno, delete_container bude úspěšná jenom v případě, že je zapůjčení kontejneru aktivní a odpovídá tomuto ID. Vyžaduje se, pokud má kontejner aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

True, pokud je kontejner odstraněný, kontejner False neexistuje.

Návratový typ

bool

Vrátí logickou hodnotu označující, jestli kontejner existuje (pokud je blob_name none), nebo jinou logickou hodnotu označující, jestli objekt blob existuje.

exists(container_name, blob_name=None, snapshot=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název kontejneru.

blob_name: str

výchozí hodnota: None

Název objektu blob. Pokud žádný, zkontroluje se existence kontejneru.

snapshot: str

výchozí hodnota: None

Parametr snapshot je neprůselná hodnota DateTime, která, pokud je k dispozici, určuje snímek.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Logická hodnota označující, jestli prostředek existuje.

Návratový typ

bool

static extract_date_and_request_id(retry_context)

Parametry

retry_context

Vyžadováno

Vygeneruje sdílený přístupový podpis pro službu Blob Service. Použijte vrácený podpis s parametrem sas_token libovolné služby BlobService.

generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)

Parametry

resource_types: <xref:ResourceTypes>

Vyžadováno

Určuje typy prostředků, které jsou přístupné pomocí SAS účtu.

permission: <xref:AccountPermissions>

Vyžadováno

Oprávnění přidružená ke sdílenému přístupovém podpisu. Uživatel je omezen na operace povolené oprávněními. Povinné, pokud není zadané ID odkazující na uložené zásady přístupu, které obsahují toto pole. Toto pole je nutné vynechat, pokud je zadané 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. Povinné, pokud není zadané ID odkazující na uložené zásady přístupu, které obsahují toto pole. Toto pole je nutné vynechat, pokud je zadané 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 se sdílený přístupový podpis stane platným. Pokud je vynechán, předpokládá se, že počáteční čas pro toto 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í přijímat požadavky. 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ím sip=168.1.5.65 nebo sip=168.1.5.60-168.1.5.70 v SAS omezíte požadavek na tyto IP adresy.

protocol: str

výchozí hodnota: None

Určuje protokol povolený pro provedený požadavek. Výchozí hodnota je https,http. Možné hodnoty najdete v tématu Protocol .

Návraty

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

Návratový typ

str

Vygeneruje sdílený přístupový podpis pro objekt blob nebo jeden z jeho snímků. Použijte vrácený podpis s parametrem sas_token libovolné služby BlobService.

generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

Parametry

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

Parametr snapshot je neprůzná hodnota DateTime, která pokud je k dispozici, určuje snímek objektu blob, který se má udělit oprávnění.

permission: BlobPermissions

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á pro čtení, zápis, odstranění a seznam. 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.

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

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ím sip=168.1.5.65 nebo sip=168.1.5.60-168.1.5.70 v SAS omezíte požadavek na tyto IP adresy.

protocol: str

výchozí hodnota: None

Určuje protokol povolený pro provedený požadavek. Výchozí hodnota je https,http. Možné hodnoty najdete v tématu Protocol .

cache_control: str

výchozí hodnota: None

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

výchozí hodnota: None

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

výchozí hodnota: None

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

výchozí hodnota: None

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

výchozí hodnota: None

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

user_delegation_key: UserDelegationKey

výchozí hodnota: None

Místo 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_key. Pokud existuje, sas se místo toho podepíše pomocí klíče delegování uživatele.

Návraty

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

Návratový typ

str

Vygeneruje sdílený přístupový podpis pro kontejner. Použijte vrácený podpis s parametrem sas_token libovolné služby BlobService.

generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

Parametry

container_name: str

Vyžadováno

Název kontejneru.

permission: ContainerPermissions

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á pro čtení, zápis, odstranění a seznam. 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.

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

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ím sip=168.1.5.65 nebo sip=168.1.5.60-168.1.5.70 v SAS omezíte požadavek na tyto IP adresy.

protocol: str

výchozí hodnota: None

Určuje protokol povolený pro provedený požadavek. Výchozí hodnota je https,http. Možné hodnoty najdete v tématu Protocol .

cache_control: str

výchozí hodnota: None

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

výchozí hodnota: None

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

výchozí hodnota: None

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

výchozí hodnota: None

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

výchozí hodnota: None

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

user_delegation_key: UserDelegationKey

výchozí hodnota: None

Místo 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_key. Pokud existuje, sas se místo toho podepíše pomocí klíče delegování uživatele.

Návraty

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

Návratový typ

str

Získá informace související s účtem úložiště. Tyto informace je také možné načíst, pokud má uživatel sas ke kontejneru nebo objektu blob.

get_blob_account_information(container_name=None, blob_name=None, timeout=None)

Parametry

container_name: str

výchozí hodnota: None

Název existujícího kontejneru Volitelné, pokud nepoužíváte token SAS ke konkrétnímu kontejneru nebo objektu blob. V takovém případě je to povinné.

blob_name: str

výchozí hodnota: None

Název existujícího objektu blob Volitelné, pokud nepoužíváte token SAS pro konkrétní objekt blob, v takovém případě je to povinné.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách.

Návraty

Hodnota AccountInformation

Vrátí všechna uživatelem definovaná metadata pro zadaný objekt blob nebo snímek.

get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

blob_name: str

Vyžadováno

Název existujícího objektu blob

snapshot: str

výchozí hodnota: None

Parametr snapshot je neprůžná hodnota, která pokud je k dispozici, určuje snímek objektu blob, který se má načíst.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného času změnil.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Dešifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Slovník představující název metadat objektu blob, páry hodnot.

Návratový typ

dict(str, str)

Vrátí všechna uživatelem definovaná metadata, standardní vlastnosti HTTP a systémové vlastnosti objektu blob. Nevrací obsah objektu blob. Vrátí příkaz Blob se BlobProperties diktem metadat a .

get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

snapshot: str

výchozí hodnota: None

Parametr snapshot je neprůselná hodnota DateTime, která při přítomnosti určuje snímek objektu blob, který se má načíst.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Dešifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

objekt blob včetně vlastností a metadat.

Návratový typ

Blob

Získá vlastnosti služby Blob service účtu úložiště, včetně Azure Analýza úložiště.

get_blob_service_properties(timeout=None)

Parametry

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Objekt blob ServiceProperties s připojenou vlastností target_version.

Načte statistiky související s replikací pro službu Blob Service. Je k dispozici pouze v případě, že je pro účet úložiště povolená geograficky redundantní replikace s přístupem pro čtení.

Díky geograficky redundantní replikaci azure storage udržuje vaše data odolná ve dvou umístěních. V obou umístěních Azure Storage neustále udržuje několik replik dat, které jsou v pořádku. Umístění, kde čtete, vytváříte, aktualizujete nebo odstraňujete data, je primární umístění účtu úložiště. Primární umístění existuje v oblasti, kterou zvolíte, v okamžiku vytvoření účtu prostřednictvím portálu Azure Management Azure Classic, například USA – středosever. Umístění, do kterého se data replikují, je sekundární umístění. Sekundární umístění je automaticky určeno na základě umístění primární; nachází se ve druhém datovém centru, které se nachází ve stejné oblasti jako primární umístění. Přístup jen pro čtení je k dispozici ze sekundárního umístění, pokud je pro váš účet úložiště povolená geograficky redundantní replikace s přístupem pro čtení.

get_blob_service_stats(timeout=None)

Parametry

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Statistiky služby Blob Service.

Návratový typ

ServiceStats

Stáhne objekt blob jako pole bajtů s oznámeními o automatickém vytváření bloků dat a průběhu. Vrátí instanci s Blob vlastnostmi, metadaty a obsahem.

get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

snapshot: str

výchozí hodnota: None

Parametr snapshot je neprůselná hodnota DateTime, která při přítomnosti určuje snímek objektu blob, který se má načíst.

start_range: int

výchozí hodnota: None

Začátek rozsahu bajtů, který se má použít ke stažení části objektu blob. Pokud není zadaný žádný end_range, stáhnou se všechny bajty po start_range. Start_range a end_range parametry jsou včetně. Příklad: start_range=0, end_range=511 stáhne prvních 512 bajtů objektu blob.

end_range: int

výchozí hodnota: None

Konec rozsahu bajtů, který se má použít ke stažení části objektu blob. Pokud end_range, je nutné zadat start_range. Start_range a end_range parametry jsou včetně. Příklad: start_range=0, end_range=511 stáhne prvních 512 bajtů objektu blob.

validate_content: bool

výchozí hodnota: False

Pokud je nastavená hodnota true, ověří hodnotu hash MD5 pro každou načtenou část objektu blob. 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 služba bude vracet pouze transakční md5 pro bloky dat o velikosti 4 MB nebo méně, takže první požadavek na získání bude mít vlastní velikost. MAX_CHUNK_GET_SIZE místo sebe sama. MAX_SINGLE_GET_SIZE. Pokud já. MAX_CHUNK_GET_SIZE byla nastavena na větší než 4 MB, vyvolá se chyba. Vzhledem k tomu, že výpočet md5 trvá zpracování a kvůli zmenšené velikosti bloků dat bude potřeba provést více požadavků, může dojít k určitému zvýšení latence.

progress_callback: <xref:func>(<xref:current>, <xref:total>)

výchozí hodnota: None

Zpětné volání pro průběh funkce signatury (aktuální, celkem), kde aktuální je počet dosud přenesených bajtů a celkový počet je velikost objektu blob, pokud je znám.

max_connections: int

výchozí hodnota: 2

Pokud je nastavená hodnota 2 nebo vyšší, provede se počáteční získání pro první sebe. MAX_SINGLE_GET_SIZE bajtů objektu blob. Pokud se jedná o celý objekt blob, vrátí metoda v tomto okamžiku. Pokud tomu tak není, stáhne zbývající data paralelně s použitím počtu vláken rovnajících se max_connections. Každý blok dat bude mít vlastní velikost. MAX_CHUNK_GET_SIZE. Pokud je nastavená hodnota 1, provede se jedna velká žádost o získání. To se obecně nedoporučuje, ale je k dispozici, pokud by se mělo použít velmi málo vláken, síťové požadavky jsou velmi nákladné nebo nevyhlednutelný datový proud brání paralelnímu stahování. To může být užitečné také v případě, že se očekává, že mnoho objektů blob bude prázdné, protože pro prázdné objekty blob se vyžaduje další požadavek, pokud je max_connections větší než 1.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Dešifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se bude vztahovat na každé volání zvlášť.

Návraty

Objekt blob s vlastnostmi a metadaty. Pokud je max_connections větší než 1, content_md5 (pokud je nastavený na objekt blob) se nevrátí. Pokud tuto hodnotu požadujete, použijte get_blob_properties nebo nastavte max_connections na hodnotu 1.

Návratový typ

Blob

Stáhne objekt blob do cesty k souboru s automatickým blokováním dat a oznámeními o průběhu. Vrátí instanci Blob s vlastnostmi a metadaty.

get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

file_path: str

Vyžadováno

Cesta k souboru, do které se má zapisovat.

open_mode: str

výchozí hodnota: wb

Režim, který se má použít při otevírání souboru. Všimněte si, že zadání pouze open_mode brání paralelnímu stahování. Pokud se tedy používá tato open_mode, musí být max_connections nastavená na hodnotu 1.

snapshot: str

výchozí hodnota: None

Parametr snapshot je neprůzná hodnota DateTime, která pokud je k dispozici, určuje snímek objektu blob, který se má načíst.

start_range: int

výchozí hodnota: None

Začátek rozsahu bajtů, který se použije ke stažení části objektu blob. Pokud není zadán žádný end_range, stáhnou se všechny bajty po start_range. Parametry start_range a end_range jsou inkluzivní. Příklad: start_range=0, end_range=511 stáhne prvních 512 bajtů objektu blob.

end_range: int

výchozí hodnota: None

Konec rozsahu bajtů, který se má použít ke stažení části objektu blob. Pokud je zadán end_range, je nutné zadat start_range. Parametry start_range a end_range jsou inkluzivní. Příklad: start_range=0, end_range=511 stáhne prvních 512 bajtů objektu blob.

validate_content: bool

výchozí hodnota: False

Pokud je nastavená hodnota true, ověří hodnotu hash MD5 pro každou načtenou část objektu blob. 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 služba vrátí transakční md5 pouze pro bloky dat o velikosti 4 MB nebo méně, takže první požadavek na získání bude mít vlastní velikost. MAX_CHUNK_GET_SIZE místo sebe sama. MAX_SINGLE_GET_SIZE. Pokud ano. MAX_CHUNK_GET_SIZE byla nastavena na větší než 4 MB, vyvolá se chyba. Vzhledem k tomu, že zpracování md5 vyžaduje čas a kvůli zmenšené velikosti bloku dat bude potřeba provést více požadavků, může dojít k určitému zvýšení latence.

progress_callback: <xref:func>(<xref:current>, <xref:total>)

výchozí hodnota: None

Zpětné volání pro průběh funkce signature (aktuální, celkem), kde current je počet dosud přenesených bajtů a celkový počet je velikost objektu blob, pokud je známa.

max_connections: int

výchozí hodnota: 2

Pokud je nastavená hodnota 2 nebo vyšší, provede se počáteční získání pro první já. MAX_SINGLE_GET_SIZE bajtů objektu blob. Pokud se jedná o celý objekt blob, vrátí metoda v tomto okamžiku. Pokud není, stáhne zbývající data paralelně s použitím počtu vláken, který se rovná max_connections. Každý blok bude mít vlastní velikost. MAX_CHUNK_GET_SIZE. Pokud je nastavená hodnota 1, provede se jedna velká žádost o získání. To se obecně nedoporučuje, ale je k dispozici, pokud by se mělo použít velmi málo vláken, síťové požadavky jsou velmi nákladné nebo nevyhledávající datový proud brání paralelnímu stahování. To může být užitečné také v případě, že se očekává, že mnoho objektů blob bude prázdných, protože pro prázdné objekty blob se vyžaduje další požadavek, pokud je max_connections větší než 1.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného času změnil.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (*). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak (), který provede operaci pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Dešifruje data na straně služby s daným klíčem. Klíče poskytnuté zákazníkem se musí používat přes protokol HTTPS. Vzhledem k tomu, že požadavek poskytuje samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se použije pro každé volání zvlášť.

Návraty

Objekt blob s vlastnostmi a metadaty Pokud je max_connections větší než 1, content_md5 (pokud je pro objekt blob nastavený) se nevrátí. Pokud tuto hodnotu požadujete, použijte get_blob_properties nebo nastavte max_connections na 1.

Návratový typ

Blob

Stáhne objekt blob do datového proudu s automatickým blokováním dat a oznámeními o průběhu. Vrátí instanci Blob s vlastnostmi a metadaty.

get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

blob_name: str

Vyžadováno

Název existujícího objektu blob

stream: IOBase

Vyžadováno

Otevřený stream pro zápis.

snapshot: str

výchozí hodnota: None

Parametr snapshot je neprůzná hodnota DateTime, která pokud je k dispozici, určuje snímek objektu blob, který se má načíst.

start_range: int

výchozí hodnota: None

Začátek rozsahu bajtů, který se použije ke stažení části objektu blob. Pokud není zadán žádný end_range, stáhnou se všechny bajty po start_range. Parametry start_range a end_range jsou inkluzivní. Příklad: start_range=0, end_range=511 stáhne prvních 512 bajtů objektu blob.

end_range: int

výchozí hodnota: None

Konec rozsahu bajtů, který se má použít ke stažení části objektu blob. Pokud je zadán end_range, je nutné zadat start_range. Parametry start_range a end_range jsou inkluzivní. Příklad: start_range=0, end_range=511 stáhne prvních 512 bajtů objektu blob.

validate_content: bool

výchozí hodnota: False

Pokud je nastavená hodnota true, ověří hodnotu hash MD5 pro každou načtenou část objektu blob. 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 služba vrátí transakční md5 pouze pro bloky dat o velikosti 4 MB nebo méně, takže první požadavek na získání bude mít vlastní velikost. MAX_CHUNK_GET_SIZE místo sebe sama. MAX_SINGLE_GET_SIZE. Pokud ano. MAX_CHUNK_GET_SIZE byla nastavena na větší než 4 MB, vyvolá se chyba. Vzhledem k tomu, že zpracování md5 vyžaduje čas a kvůli zmenšené velikosti bloku dat bude potřeba provést více požadavků, může dojít k určitému zvýšení latence.

progress_callback: <xref:func>(<xref:current>, <xref:total>)

výchozí hodnota: None

Zpětné volání pro průběh funkce signature (aktuální, celkem), kde current je počet dosud přenesených bajtů a celkový počet je velikost objektu blob, pokud je známa.

max_connections: int

výchozí hodnota: 2

Pokud je nastavená hodnota 2 nebo vyšší, provede se počáteční získání pro první já. MAX_SINGLE_GET_SIZE bajtů objektu blob. Pokud se jedná o celý objekt blob, vrátí metoda v tomto okamžiku. Pokud není, stáhne zbývající data paralelně s použitím počtu vláken, který se rovná max_connections. Každý blok bude mít vlastní velikost. MAX_CHUNK_GET_SIZE. Pokud je nastavená hodnota 1, provede se jedna velká žádost o získání. To se obecně nedoporučuje, ale je k dispozici, pokud by se mělo použít velmi málo vláken, síťové požadavky jsou velmi nákladné nebo nevyhledávající datový proud brání paralelnímu stahování. To může být užitečné také v případě, že se očekává, že mnoho objektů blob bude prázdných, protože pro prázdné objekty blob se vyžaduje další požadavek, pokud je max_connections větší než 1.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného času změnil.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (*). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak (), který provede operaci pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Dešifruje data na straně služby s daným klíčem. Klíče poskytnuté zákazníkem se musí používat přes protokol HTTPS. Vzhledem k tomu, že požadavek poskytuje samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se použije pro každé volání zvlášť.

Návraty

Objekt blob s vlastnostmi a metadaty Pokud je max_connections větší než 1, content_md5 (pokud je pro objekt blob nastavený) se nevrátí. Pokud tuto hodnotu požadujete, použijte get_blob_properties nebo nastavte max_connections na 1.

Návratový typ

Blob

Stáhne objekt blob jako text unicode s automatickými oznámeními o blokování dat a průběhu. Vrátí instanci s Blob vlastnostmi, metadaty a obsahem.

get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

blob_name: str

Vyžadováno

Název existujícího objektu blob

encoding: str

výchozí hodnota: utf-8

Kódování Pythonu, které se má použít při dekódování dat objektů blob.

snapshot: str

výchozí hodnota: None

Parametr snapshot je neprůzná hodnota DateTime, která pokud je k dispozici, určuje snímek objektu blob, který se má načíst.

start_range: int

výchozí hodnota: None

Začátek rozsahu bajtů, který se má použít ke stažení části objektu blob. Pokud není zadaný žádný end_range, stáhnou se všechny bajty po start_range. Start_range a end_range parametry jsou včetně. Příklad: start_range=0, end_range=511 stáhne prvních 512 bajtů objektu blob.

end_range: int

výchozí hodnota: None

Konec rozsahu bajtů, který se má použít ke stažení části objektu blob. Pokud end_range, je nutné zadat start_range. Start_range a end_range parametry jsou včetně. Příklad: start_range=0, end_range=511 stáhne prvních 512 bajtů objektu blob.

validate_content: bool

výchozí hodnota: False

Pokud je nastavená hodnota true, ověří hodnotu hash MD5 pro každou načtenou část objektu blob. 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 služba bude vracet pouze transakční md5 pro bloky dat o velikosti 4 MB nebo méně, takže první požadavek na získání bude mít vlastní velikost. MAX_CHUNK_GET_SIZE místo sebe sama. MAX_SINGLE_GET_SIZE. Pokud já. MAX_CHUNK_GET_SIZE byla nastavena na větší než 4 MB, vyvolá se chyba. Vzhledem k tomu, že výpočet md5 trvá zpracování a kvůli zmenšené velikosti bloků dat bude potřeba provést více požadavků, může dojít k určitému zvýšení latence.

progress_callback: <xref:func>(<xref:current>, <xref:total>)

výchozí hodnota: None

Zpětné volání pro průběh funkce signatury (aktuální, celkem), kde aktuální je počet dosud přenesených bajtů a celkový počet je velikost objektu blob, pokud je znám.

max_connections: int

výchozí hodnota: 2

Pokud je nastavená hodnota 2 nebo vyšší, provede se počáteční získání pro první sebe. MAX_SINGLE_GET_SIZE bajtů objektu blob. Pokud se jedná o celý objekt blob, vrátí metoda v tomto okamžiku. Pokud tomu tak není, stáhne zbývající data paralelně s použitím počtu vláken rovnajících se max_connections. Každý blok dat bude mít vlastní velikost. MAX_CHUNK_GET_SIZE. Pokud je nastavená hodnota 1, provede se jedna velká žádost o získání. To se obecně nedoporučuje, ale je k dispozici, pokud by se mělo použít velmi málo vláken, síťové požadavky jsou velmi nákladné nebo nevyhlednutelný datový proud brání paralelnímu stahování. To může být užitečné také v případě, že se očekává, že mnoho objektů blob bude prázdné, protože pro prázdné objekty blob se vyžaduje další požadavek, pokud je max_connections větší než 1.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Dešifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se bude vztahovat na každé volání zvlášť.

Návraty

Objekt blob s vlastnostmi a metadaty. Pokud je max_connections větší než 1, content_md5 (pokud je nastavený na objekt blob) se nevrátí. Pokud tuto hodnotu požadujete, použijte get_blob_properties nebo nastavte max_connections na hodnotu 1.

Návratový typ

Blob

Načte seznam bloků, které se nahrály jako součást objektu blob bloku. Pro objekt blob se uchovávají dva seznamy bloků:

Seznam potvrzených bloků: Seznam bloků, které byly úspěšně potvrzeny do daného objektu blob pomocí seznamu blokovaných položek.

Nepotvrzený seznam bloků: Seznam bloků, které se nahrály pro objekt blob pomocí příkazu Vložit blok, ale které ještě nebyly potvrzeny. Tyto bloky se ukládají v Azure ve spojení s objektem blob, ale zatím nejsou součástí objektu blob.

get_block_list(container_name, blob_name, snapshot=None, block_list_type=None, lease_id=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

snapshot: str

výchozí hodnota: None

Datum a čas pro určení času pro načtení bloků.

block_list_type: str

výchozí hodnota: None

Určuje, zda se má vrátit seznam potvrzených bloků, seznam nepotvrzených bloků nebo oba seznamy najednou. Platné hodnoty jsou: potvrzené, nepotvrzené nebo všechny.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

seznam potvrzených nebo nepotvrzených bloků pro objekt blob bloku

Návratový typ

BlobBlockList

Získá oprávnění pro zadaný kontejner. Oprávnění označují, jestli je možné veřejně přistupovat k datům kontejneru.

get_container_acl(container_name, lease_id=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

lease_id

výchozí hodnota: None

Pokud je zadáno, get_container_acl bude úspěšná jenom v případě, že je zapůjčení kontejneru aktivní a odpovídá tomuto ID.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Slovník zásad přístupu přidružených ke kontejneru. dict str to AccessPolicy a vlastnost public_access, pokud je zapnutý veřejný přístup

Vrátí všechna metadata definovaná uživatelem pro zadaný kontejner.

get_container_metadata(container_name, lease_id=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

lease_id: str

výchozí hodnota: None

Pokud je zadáno, get_container_metadata bude úspěšná jenom v případě, že je zapůjčení kontejneru aktivní a odpovídá tomuto ID.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Slovník představující název metadat kontejneru, páry hodnot.

Návratový typ

dict(str, str)

Vrátí všechna uživatelem definovaná metadata a systémové vlastnosti pro zadaný kontejner. Vrácená data nezahrnují seznam objektů blob kontejneru.

get_container_properties(container_name, lease_id=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

lease_id: str

výchozí hodnota: None

Pokud je zadáno, get_container_properties bude úspěšná jenom v případě, že je zapůjčení kontejneru aktivní a odpovídá tomuto ID.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

vlastnosti zadaného kontejneru v rámci objektu kontejneru.

Návratový typ

Container

Získejte klíč delegování uživatele pro účely podepisování tokenů SAS. Aby byl tento požadavek úspěšný, musí být v objektu služby k dispozici přihlašovací údaje tokenu.

get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)

Parametry

key_start_time: datetime

Vyžadováno

Hodnota DateTime. Označuje, kdy se klíč stane platným.

key_expiry_time: datetime

Vyžadováno

Hodnota DateTime. Označuje, kdy klíč přestane být platný.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Klíč delegování uživatele.

Návratový typ

UserDelegationKey

Vrátí generátor pro výpis názvů objektů blob v zadaném kontejneru. Generátor bude líně sledovat tokeny pokračování vrácené službou a zastaví se, jakmile se vrátí všechny objekty blob nebo se dosáhne num_results.

Pokud je zadána num_results a účet má více než tento počet objektů blob, generátor bude mít po dokončení vyplněné pole next_marker. Tuto značku je možné použít k vytvoření nového generátoru, pokud jsou požadované další výsledky.

list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

prefix: str

výchozí hodnota: None

Filtruje výsledky tak, aby vracely jenom objekty blob, jejichž názvy začínají zadanou předponou.

num_results: int

výchozí hodnota: None

Určuje maximální počet objektů blob, které se mají vrátit, včetně všech <xref:azure.storage.blob.blockblobservice.BlobPrefix> prvků. Pokud požadavek neurčuje num_results nebo určuje hodnotu větší než 5 000, server vrátí až 5 000 položek. Nastavení num_results na hodnotu menší nebo rovnou nule vede k chybě s kódem odpovědi na chybu 400 (chybný požadavek).

include: Include

výchozí hodnota: None

Určuje jednu nebo více dalších datových sad, které se mají zahrnout do odpovědi.

delimiter: str

výchozí hodnota: None

Pokud požadavek obsahuje tento parametr, operace vrátí BlobPrefix prvek v seznamu výsledků, který funguje jako zástupný symbol pro všechny objekty blob, jejichž názvy začínají stejným podřetěžcem až do vzhledu znaku oddělovače. Oddělovačem může být jeden znak nebo řetězec.

marker: str

výchozí hodnota: None

Neprůsledný pokračovací token. Tuto hodnotu lze načíst z pole next_marker předchozího objektu generátoru, pokud byl zadán num_results a tento generátor dokončil výčet výsledků. Pokud je tato hodnota zadána, začne tento generátor vracet výsledky z bodu, kde se předchozí generátor zastavil.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Vrátí generátor pro výpis objektů blob v zadaném kontejneru. Generátor bude líně sledovat tokeny pokračování vrácené službou a zastaví se, jakmile se vrátí všechny objekty blob nebo se dosáhne num_results.

Pokud je zadána num_results a účet má více než tento počet objektů blob, generátor bude mít po dokončení vyplněné pole next_marker. Tuto značku je možné použít k vytvoření nového generátoru, pokud jsou požadované další výsledky.

list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

prefix: str

výchozí hodnota: None

Filtruje výsledky tak, aby vracely jenom objekty blob, jejichž názvy začínají zadanou předponou.

num_results: int

výchozí hodnota: None

Určuje maximální počet objektů blob, které se mají vrátit, včetně všech <xref:azure.storage.blob.blockblobservice.BlobPrefix> prvků. Pokud požadavek neurčuje num_results nebo určuje hodnotu větší než 5 000, server vrátí až 5 000 položek. Nastavení num_results na hodnotu menší nebo rovnou nule vede k chybě s kódem odpovědi na chybu 400 (chybný požadavek).

include: Include

výchozí hodnota: None

Určuje jednu nebo více dalších datových sad, které se mají zahrnout do odpovědi.

delimiter: str

výchozí hodnota: None

Pokud požadavek obsahuje tento parametr, operace vrátí BlobPrefix prvek v seznamu výsledků, který funguje jako zástupný symbol pro všechny objekty blob, jejichž názvy začínají stejným podřetěžcem až do vzhledu znaku oddělovače. Oddělovačem může být jeden znak nebo řetězec.

marker: str

výchozí hodnota: None

Neprůsledný pokračovací token. Tuto hodnotu lze načíst z pole next_marker předchozího objektu generátoru, pokud byl zadán num_results a tento generátor dokončil výčet výsledků. Pokud je tato hodnota zadána, začne tento generátor vracet výsledky z bodu, kde se předchozí generátor zastavil.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Vrátí generátor pro výpis kontejnerů v zadaném účtu. Generátor bude líně sledovat tokeny pokračování vrácené službou a zastaví se, jakmile se vrátí všechny kontejnery nebo se dosáhne num_results.

Pokud je zadána num_results a účet má více než tento počet kontejnerů, generátor bude mít po dokončení vyplněné pole next_marker. Tuto značku je možné použít k vytvoření nového generátoru, pokud jsou požadované další výsledky.

list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)

Parametry

prefix: str

výchozí hodnota: None

Filtruje výsledky tak, aby vracely pouze kontejnery, jejichž názvy začínají zadanou předponou.

num_results: int

výchozí hodnota: None

Určuje maximální počet kontejnerů, které se mají vrátit. Jedna žádost o seznam může vrátit až 1 000 kondianerů a potenciálně token pokračování, který by měl být dodržen, aby se získaly další resutls.

include_metadata: bool

výchozí hodnota: False

Určuje, že se v odpovědi vrátí metadata kontejneru.

marker: str

výchozí hodnota: None

Neprůsledný pokračovací token. Tuto hodnotu lze načíst z pole next_marker předchozího objektu generátoru, pokud byl zadán num_results a tento generátor dokončil výčet výsledků. Pokud je tato hodnota zadána, začne tento generátor vracet výsledky z bodu, kde se předchozí generátor zastavil.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Vytvoří adresu URL pro přístup k objektu blob.

make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)

Parametry

container_name: str

Vyžadováno

Název kontejneru

blob_name: str

Vyžadováno

Název objektu blob.

protocol: str

výchozí hodnota: None

Protokol, který se má použít: http nebo https. Pokud není zadaný, použije protokol zadaný při inicializaci služby BaseBlobService.

sas_token: str

výchozí hodnota: None

Token sdíleného přístupových podpisů vytvořený pomocí generate_shared_access_signature.

snapshot: str

výchozí hodnota: None

Řetězcová hodnota, která jednoznačně identifikuje snímek. Hodnota tohoto parametru dotazu označuje verzi snímku.

Návraty

adresa URL přístupu k objektu blob.

Návratový typ

str

Vytvoří adresu URL pro přístup ke kontejneru.

make_container_url(container_name, protocol=None, sas_token=None)

Parametry

container_name: str

Vyžadováno

Název kontejneru

protocol: str

výchozí hodnota: None

Protokol, který se má použít: http nebo https. Pokud není zadaný, použije protokol zadaný při inicializaci služby BaseBlobService.

sas_token: str

výchozí hodnota: None

Token sdíleného přístupových podpisů vytvořený pomocí generate_shared_access_signature.

Návraty

přístupová adresa URL kontejneru.

Návratový typ

str

Vytvoří nový blok, který se potvrdí jako součást objektu blob.

put_block(container_name, blob_name, block, block_id, validate_content=False, lease_id=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název objektu blob.

block: IOBase nebo <xref:<xref:bytes Content> of <xref:the block.>>

Vyžadováno

Obsah bloku.

block_id: str

Vyžadováno

Řetězcová hodnota, která identifikuje blok. Velikost řetězce by měla být menší nebo rovna 64 bajtům. Pro daný objekt blob musí mít block_id stejnou velikost pro každý blok.

validate_content: bool

výchozí hodnota: False

Pokud je hodnota true, vypočítá hodnotu hash MD5 obsahu bloku. 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á.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Vytvoří nový blok, který se potvrdí jako součást objektu blob.

put_block_from_url(container_name, blob_name, copy_source_url, block_id, source_range_start=None, source_range_end=None, source_content_md5=None, lease_id=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název objektu blob.

copy_source_url: str

Vyžadováno

Adresa URL zdrojových dat. Může odkazovat na libovolný objekt blob nebo soubor Azure, který je veřejný nebo má připojený sdílený přístupový podpis.

source_range_start: int

výchozí hodnota: None

To označuje začátek rozsahu bajtů (včetně), který musí být převzat ze zdroje kopírování.

source_range_end: int

výchozí hodnota: None

To označuje konec rozsahu bajtů (včetně), který musí být převzat ze zdroje kopírování.

block_id: str

Vyžadováno

Řetězcová hodnota, která identifikuje blok. Velikost řetězce by měla být menší nebo rovna 64 bajtům. Pro daný objekt blob musí mít block_id stejnou velikost pro každý blok.

source_content_md5: str

výchozí hodnota: None

Pokud je daná, služba vypočítá hodnotu hash MD5 obsahu bloku a porovná ji s touto hodnotou.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Zapíše objekt blob zadáním seznamu ID bloků, která tvoří objekt blob. Aby se blok zapisoval jako součást objektu blob, musí být úspěšně zapsán na server v předchozí operaci Put Block.

K aktualizaci objektu blob můžete volat vložení seznamu blokovaných objektů tak, že nahrajete jenom ty bloky, které se změnily, a pak společně potvrdíte nový a existující blok. Můžete to udělat tak, že určíte, jestli chcete potvrdit blok ze seznamu potvrzených bloků nebo ze seznamu nepotvrzených bloků, nebo jestli chcete potvrdit naposledy nahranou verzi bloku podle toho, do kterého seznamu může patřit.

put_block_list(container_name, blob_name, block_list, content_settings=None, metadata=None, validate_content=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

block_list: list(BlobBlock)

Vyžadováno

Seznam obsahující <xref:azure.storeage.blob.models.BlobBlock> ID bloku a stav bloku.

content_settings: ContentSettings

výchozí hodnota: None

Objekt ContentSettings použitý k nastavení vlastností objektu blob.

metadata: dict(str, str)

výchozí hodnota: None

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

validate_content: bool

výchozí hodnota: False

Pokud je true, vypočítá hodnotu hash MD5 obsahu seznamu blokovaných položek. Služba úložiště zkontroluje hodnotu hash obsahu seznamu blokovaných, která byla doručena 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 kontrola je přidružená k obsahu seznamu blokovaných objektů blob, a ne k obsahu samotného objektu blob.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

standard_blob_tier: StandardBlobTier

výchozí hodnota: None

Standardní hodnota úrovně objektu blob, na kterou se má objekt blob nastavit. Pro tuto verzi knihovny to platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

Návraty

ETag a naposledy změněné vlastnosti aktualizovaného objektu blob bloku

Návratový typ

ResourceProperties

Uvolní zapůjčení. Zapůjčení může být uvolněno, pokud ID zapůjčení zadané v požadavku odpovídá id přidružené k objektu blob. Uvolnění zapůjčení umožní jinému klientovi okamžitě získat zapůjčení objektu blob, jakmile se vydání dokončí.

release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

lease_id: str

Vyžadováno

ID zapůjčení pro aktivní zapůjčení

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Uvolněte zapůjčení. Zapůjčení může být uvolněno, pokud zadaný lease_id odpovídá kontejneru. Uvolnění zapůjčení umožní jinému klientovi okamžitě získat zapůjčení kontejneru, jakmile se vydání dokončí.

release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

lease_id: str

Vyžadováno

ID zapůjčení pro aktivní zapůjčení

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Prodlouží zapůjčení. Zapůjčení je možné prodloužit, pokud ID zapůjčení zadané v žádosti odpovídá id zapůjčení přidruženému k objektu blob. Mějte na paměti, že zapůjčení může být prodlouženo i v případě, že jeho platnost vypršela, dokud se objekt blob od vypršení tohoto zapůjčení nezměnil nebo znovu nepronajal. Při prodloužení zapůjčení se doba trvání zapůjčení resetuje.

renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

lease_id: str

Vyžadováno

ID zapůjčení pro aktivní zapůjčení

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Str

Prodlouží zapůjčení. Zapůjčení lze prodloužit, pokud zadané ID zapůjčení odpovídá id přidružené ke kontejneru. Mějte na paměti, že zapůjčení může být prodlouženo i v případě, že vypršela jeho platnost, dokud od vypršení tohoto zapůjčení nebyl kontejner znovu zapůjčen. Při prodloužení zapůjčení se doba trvání zapůjčení resetuje.

renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

lease_id: str

Vyžadováno

ID zapůjčení pro aktivní zapůjčení

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Str

Nastaví uživatelem definovaná metadata pro zadaný objekt blob jako jednu nebo více dvojic název-hodnota.

set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

metadata: dict(str, str)

výchozí hodnota: None

Dict obsahující páry název a hodnota. Každé volání této operace nahradí všechna existující metadata připojená k objektu blob. Pokud chcete z objektu blob odebrat všechna metadata, zavolejte tuto operaci bez záhlaví metadat.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (*). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak (), který provede operaci pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes protokol HTTPS. Vzhledem k tomu, že požadavek poskytuje samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách.

Návraty

Značka ETag a naposledy změněné vlastnosti aktualizovaného objektu blob

Návratový typ

ResourceProperties

Nastaví systémové vlastnosti objektu blob. Pokud je pro content_settings nastavená jedna vlastnost, všechny vlastnosti se přepíšou.

set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

blob_name: str

Vyžadováno

Název existujícího objektu blob

content_settings: ContentSettings

výchozí hodnota: None

Objekt ContentSettings použitý k nastavení vlastností objektu blob.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného času změnil.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (*). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota ETag nebo zástupný znak (). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak (), který provede operaci pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes protokol HTTPS. Vzhledem k tomu, že požadavek poskytuje samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách.

Návraty

Značka ETag a naposledy změněné vlastnosti aktualizovaného objektu blob

Návratový typ

ResourceProperties

Nastaví vlastnosti služby Blob service účtu úložiště, včetně Azure Analýza úložiště. Pokud je prvek (např. Protokolování) ponechán jako None, stávající nastavení služby pro tuto funkci se zachovají.

set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)

Parametry

logging: Logging

výchozí hodnota: None

Seskupí nastavení protokolování Azure Analytics.

hour_metrics: Metrics

výchozí hodnota: None

Nastavení hodinových metrik poskytuje souhrn statistik žádostí seskupených podle rozhraní API v hodinové agregaci objektů blob.

minute_metrics: Metrics

výchozí hodnota: None

Nastavení minutových metrik poskytuje statistiku požadavků pro každou minutu pro objekty blob.

cors: list(CorsRule)

výchozí hodnota: None

Do seznamu můžete zahrnout až pět prvků CorsRule. Pokud zadáte prázdný seznam, odstraní se všechna pravidla CORS a CORS se pro službu zakáže.

target_version: str

výchozí hodnota: None

Určuje výchozí verzi, která se má použít pro požadavky, pokud není zadaná verze příchozího požadavku.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách.

delete_retention_policy: DeleteRetentionPolicy

výchozí hodnota: None

Zásada uchovávání informací o odstranění určuje, jestli se mají zachovat odstraněné objekty blob. Určuje také počet dnů a verze objektu blob, který se má zachovat.

static_website: StaticWebsite

výchozí hodnota: None

Určuje, jestli je povolená funkce statického webu, a pokud ano, označuje dokument indexu a dokument chyby 404, který se má použít.

Nastaví oprávnění pro zadaný kontejner nebo uložené zásady přístupu, které lze použít se sdílenými přístupovými podpisy. Oprávnění označují, jestli je možné k objektům blob v kontejneru přistupovat veřejně.

set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

signed_identifiers: dict(str, AccessPolicy)

výchozí hodnota: None

Slovník zásad přístupu, který se má přidružit ke kontejneru. Slovník může obsahovat až 5 prvků. Prázdný slovník vymaže zásady přístupu nastavené pro službu.

public_access: PublicAccess

výchozí hodnota: None

Mezi možné hodnoty patří: kontejner, objekt blob.

lease_id: str

výchozí hodnota: None

Pokud je zadaný parametr, set_container_acl bude úspěšný jenom v případě, že je zapůjčení kontejneru aktivní a odpovídá tomuto ID.

if_modified_since: datetime

výchozí hodnota: None

Hodnota data a času. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného data a času změnil.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota data a času. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách.

Návraty

Značka ETag a naposledy změněné vlastnosti aktualizovaného kontejneru

Návratový typ

ResourceProperties

Nastaví jednu nebo více uživatelsky definovaných dvojic název-hodnota pro zadaný kontejner. Každé volání této operace nahradí všechna existující metadata připojená ke kontejneru. Pokud chcete z kontejneru odebrat všechna metadata, zavolejte tuto operaci bez diktování metadat.

set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

metadata: dict(str, str)

výchozí hodnota: None

Dict obsahující páry název-hodnota, které se přidruží ke kontejneru jako metadata. Příklad: {'category':'test'}

lease_id: str

výchozí hodnota: None

Pokud je tato hodnota zadána, set_container_metadata bude úspěšná jenom v případě, že je zapůjčení kontejneru aktivní a odpovídá tomuto ID.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že předaná hodnota data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného času změnil.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách.

Návraty

Značka ETag a naposledy změněné vlastnosti aktualizovaného kontejneru

Návratový typ

ResourceProperties

Nastaví hostitele proxy serveru a port pro tunelování HTTP CONNECT.

set_proxy(host, port, user=None, password=None)

Parametry

host: str

Vyžadováno

Adresa proxy serveru. Příklad: 192.168.0.100

port: int

Vyžadováno

Port proxy serveru. Příklad: 6000

user: str

výchozí hodnota: None

Uživatel pro autorizaci proxy.

password: str

výchozí hodnota: None

Heslo pro autorizaci proxy.

Nastaví úrovně objektů blob bloku v objektu blob. Toto rozhraní API se podporuje pouze pro objekty blob bloku v účtech úložiště úrovně Standard.

:p aram RehydratePriority rehydrate_priority: Určuje prioritu, se kterou se má rehydrovat archivovaný objekt blob.

set_standard_blob_tier(container_name, blob_name, standard_blob_tier, timeout=None, rehydrate_priority=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

blob_name: str

Vyžadováno

Název objektu blob, který se má aktualizovat.

standard_blob_tier: StandardBlobTier

Vyžadováno

Standardní hodnota úrovně objektu blob, na kterou se objekt blob nastaví. Pro tuto verzi knihovny to platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

timeout: int

výchozí hodnota: None

Parametr časového limitu se vyjadřuje v sekundách. Tato metoda může provádět více volání služby Azure a časový limit se použije pro každé volání zvlášť.

rehydrate_priority

výchozí hodnota: None

Vytvoří snímek objektu blob jen pro čtení.

snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru

blob_name: str

Vyžadováno

Název existujícího objektu blob

metadata: dict(str, str)

výchozí hodnota: None

Určuje uživatelsky definovanou dvojici název-hodnota přidruženou k objektu blob. Pokud nejsou zadané žádné páry název-hodnota, operace zkopíruje základní metadata objektu blob do snímku. Pokud je zadán jeden nebo více dvojic název-hodnota, vytvoří se snímek se zadanými metadaty a metadata se nezkopírují ze základního objektu blob.

if_modified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že byl prostředek od zadaného času změněn.

if_unmodified_since: datetime

výchozí hodnota: None

Hodnota DateTime. Azure očekává, že hodnota předaného data bude UTC. Pokud je zahrnuté časové pásmo, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že je to UTC. Tuto hlavičku zadejte pro provedení operace pouze v případě, že prostředek nebyl od zadaného data a času změněn.

if_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (*). Tuto hlavičku zadejte pro provedení operace pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě.

if_none_match: str

výchozí hodnota: None

Hodnota značky ETag nebo zástupný znak (). Zadáním této hlavičky provedete operaci pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Zadejte zástupný znak () pro provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operaci se nezdaří.

lease_id: str

výchozí hodnota: None

Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

cpk: CustomerProvidedEncryptionKey

výchozí hodnota: None

Zašifruje data na straně služby pomocí daného klíče. Klíče poskytnuté zákazníkem se musí používat přes HTTPS. Vzhledem k tomu, že v požadavku je k dispozici samotný šifrovací klíč, musí být pro přenos klíče navázáno zabezpečené připojení.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

Návraty

Vlastnosti snímku

Návratový typ

Blob

Operace obnovení objektu blob obnoví obsah a metadata obnovitelného odstraněného objektu blob nebo snímku. Pokus o zrušení obnovení objektu blob nebo snímku, který není obnovitelného odstranění, proběhne úspěšně bez jakýchkoli změn.

undelete_blob(container_name, blob_name, timeout=None)

Parametry

container_name: str

Vyžadováno

Název existujícího kontejneru.

blob_name: str

Vyžadováno

Název existujícího objektu blob.

timeout: int

výchozí hodnota: None

Parametr časového limitu je vyjádřen v sekundách.

MAX_BLOCK_SIZE = 4194304

MAX_CHUNK_GET_SIZE = 4194304

MAX_SINGLE_GET_SIZE = 33554432

MAX_SINGLE_PUT_SIZE = 67108864

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD = 4194305

Sdílet prostřednictvím

BlockBlobService Třída

Konstruktor

Parametry

Proměnné

Metody

abort_copy_blob

Parametry

acquire_blob_lease

Parametry

Návraty

acquire_container_lease

Parametry

Návraty

batch_delete_blobs

Parametry

Návraty

Návratový typ

batch_set_standard_blob_tier

Parametry

Návraty

Návratový typ

break_blob_lease

Parametry

Návraty

break_container_lease

Parametry

Návraty

change_blob_lease

Parametry

change_container_lease

Parametry

copy_blob

Parametry

create_blob_from_bytes

Parametry

Návraty

Návratový typ

create_blob_from_path

Parametry

Návraty

Návratový typ

create_blob_from_stream

Parametry

Návraty

Návratový typ

create_blob_from_text

Parametry

Návraty

Návratový typ

create_container

Parametry

Návraty

Návratový typ

delete_blob

Parametry

delete_container

Parametry

Návraty

Návratový typ

exists

Parametry

Návraty

Návratový typ

extract_date_and_request_id

Parametry

generate_account_shared_access_signature

Parametry

Návraty

Návratový typ

generate_blob_shared_access_signature

Parametry

Návraty

Návratový typ

generate_container_shared_access_signature

Parametry

Návraty

Návratový typ

get_blob_account_information

Parametry