Sdílet prostřednictvím


Azure Blob Storage REST API

Azure Blob Storage ukládá textová a binární data jako objekty v cloudu. Blob Storage nabízí následující prostředky: účet úložiště, kontejnery a objekty blob. Kontejnery v rámci vašeho účtu úložiště poskytují způsob, jak uspořádat sady objektů blob.

Textová a binární data můžete ukládat do jednoho z následujících typů objektů blob:

  • Objekty blob bloku, které jsou optimalizované pro streamování.

  • Doplňovací objekty blob, které jsou optimalizované pro operace připojení.

  • Objekty blob stránky, které jsou optimalizované pro náhodné operace čtení a zápisu a poskytují možnost zápisu do rozsahu bajtů v objektu blob.

Další informace najdete v tématu Principy objektů blob bloku, doplňovacích objektů blob a objektů blob stránky.

Rozhraní REST API pro Blob Storage definuje operace HTTP pro účet úložiště, kontejnery a objekty blob. Rozhraní API obsahuje operace uvedené v následující tabulce.

Operace Typ prostředku Description
Vypsat kontejnery Účet Seznamy všechny kontejnery v účtu úložiště.
Nastavení vlastností služby Blob Storage Účet Nastaví vlastnosti služby Blob Storage, včetně nastavení protokolování a metrik a výchozí verze služby.
Získání vlastností služby Blob Storage Účet Získá vlastnosti Blob Storage, včetně nastavení protokolování a metrik, a výchozí verzi služby.
Předběžná žádost o objekty blob Účet Před odesláním skutečné žádosti se dotazuje na pravidla sdílení prostředků mezi zdroji (CORS) pro službu Blob Storage.
Získání statistik služby Blob Storage Účet Načte statistiky související s replikací služby Blob Storage. Tato operace je k dispozici pouze v sekundárním koncovém bodu umístění, pokud je pro účet úložiště povolená geograficky redundantní replikace s přístupem pro čtení.
Získání informací o účtu Účet Vrátí název skladové položky a druh účtu pro zadaný účet.
Získání klíče delegování uživatele Účet Získá klíč, který lze použít k podepsání sdíleného přístupového podpisu delegování uživatele. Tento podpis uděluje přístup k prostředkům ve službě Blob Storage pomocí přihlašovacích údajů Microsoft Entra.
Vytvoření kontejneru Kontejner Vytvoří nový kontejner v účtu úložiště.
Získání vlastností kontejneru Kontejner Vrátí všechna uživatelem definovaná metadata a systémové vlastnosti kontejneru.
Získání metadat kontejneru Kontejner Vrátí pouze uživatelem definovaná metadata kontejneru.
Nastavení metadat kontejneru Kontejner Nastaví uživatelem definovaná metadata kontejneru.
Získání seznamu ACL kontejneru Kontejner Získá zásady veřejného přístupu a všechny uložené zásady přístupu pro kontejner.
Nastavit seznam ACL kontejneru Kontejner Nastaví zásady veřejného přístupu a všechny uložené zásady přístupu pro kontejner.
Zapůjčení kontejneru Kontejner Vytvoří a spravuje zámek kontejneru pro operace odstranění.
Odstranění kontejneru Kontejner Odstraní kontejner a všechny objekty blob, které obsahuje.
Výpis objektů blob Kontejner Seznamy všechny objekty blob v kontejneru.
Vložení objektu blob Objekty blob bloku, připojení a stránky Vytvoří nový objekt blob nebo nahradí existující objekt blob v kontejneru.
Získání objektu blob Objekty blob bloku, připojení a stránky Načte nebo stáhne objekt blob ze služby Blob Storage, včetně jeho uživatelem definovaných metadat a systémových vlastností.
Získání vlastností objektu blob Objekty blob bloku, připojení a stránky Vrátí všechny systémové vlastnosti a uživatelem definovaná metadata objektu blob.
Nastavení vlastností objektu blob Objekty blob bloku, připojení a stránky Nastaví systémové vlastnosti definované pro existující objekt blob.
Nastavení vypršení platnosti objektu blob Objekty blob bloku Nastaví dobu vypršení platnosti existujícího objektu blob.
Získání metadat objektů blob Objekty blob bloku, připojení a stránky Načte všechna uživatelem definovaná metadata existujícího objektu blob nebo snímku.
Nastavení metadat objektů blob Objekty blob bloku, připojení a stránky Nastaví uživatelem definovaná metadata existujícího objektu blob.
Získání značek objektů blob Objekty blob bloku, připojení a stránky Načte uživatelem definované značky existujícího objektu blob.
Nastavení značek objektů blob Objekty blob bloku, připojení a stránky Nastaví uživatelem definované značky existujícího objektu blob, které tvoří sekundární index.
Hledání objektů blob podle značek Objekty blob bloku, připojení a stránky Seznamy objekty blob podle jejich uživatelsky definovaných značek.
Odstranění objektu blob Objekty blob bloku, připojení a stránky Označí objekt blob pro odstranění.
Zrušit odstranění objektu blob Objekty blob bloku, doplňování a objekty blob stránky Obnoví obsah a metadata obnovitelně odstraněného objektu blob nebo všech přidružených obnovitelně odstraněných snímků.
Operace Lease Blob Objekty blob bloku, doplňování a objekty blob stránky Vytváří a spravuje uzamčení operací zápisu a odstranění. Pokud chcete odstranit uzamčený objekt blob nebo do ho zapisovat, musí klient zadat ID zapůjčení.
Pořízení snímku objektu blob Objekty blob bloku, doplňování a objekty blob stránky Vytvoří snímek objektu blob jen pro čtení.
Zkopírování objektu blob Objekty blob bloku, doplňování a objekty blob stránky Zkopíruje zdrojový objekt blob do cílového objektu blob v tomto účtu úložiště nebo v jiném účtu úložiště.
Přerušení kopírování objektu blob Objekty blob bloku, doplňování a objekty blob stránky Zastaví čekající Copy Blob operaci a ponechá cílový objekt blob s nulovou délkou a úplnými metadaty.
Put Block Pouze objekty blob bloku Vytvoří nový blok, který se potvrdí jako součást objektu blob bloku.
Put Block From URL Pouze objekty blob bloku Vytvoří nový blok, který se potvrdí jako součást objektu blob bloku, kde se obsah načte z adresy URL.
Put Block List Pouze objekty blob bloku Potvrdí objekt blob zadáním sady ID bloku, která tvoří objekt blob bloku.
Získat seznam blokovaných Pouze objekty blob bloku Načte seznam bloků, které se nahrály jako součást objektu blob bloku.
Dotaz na obsah objektu blob Pouze objekty blob bloku Použije jednoduchý příkaz jazyk SQL (Structured Query Language) (SQL) na obsah objektu blob a vrátí pouze dotazovanou podmnožinu dat.
Nastavení úrovně objektu blob Objekty blob bloku a stránky Nastaví úroveň objektu blob.
Vložit stránku Pouze objekty blob stránky Zapíše rozsah stránek do objektu blob stránky.
Získat rozsahy stránek Pouze objekty blob stránky Vrátí seznam platných rozsahů stránek pro objekt blob stránky nebo snímek objektu blob stránky.
Přírůstkové kopírování objektu blob Pouze objekty blob stránky Zkopíruje snímek objektu blob zdrojové stránky do cílového objektu blob stránky. Přenesou se pouze rozdílové změny.
Připojit blok Pouze doplňovací objekty blob Zapíše blok dat na konec doplňovacího objektu blob.

V této části

Koncepty služby Blob Storage

Operace s účtem (Blob Storage)

Operace s kontejnery

Operace s objekty blob

Operace s objekty blob (hierarchické účty s povoleným oborem názvů)

Viz také

Rest služby Storage