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
Operace s účtem (Blob Storage)
Operace s objekty blob (hierarchické účty s povoleným oborem názvů)