rozhraní REST API Azure Blob Storage
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 úč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 službu Blob Storage definuje operace HTTP pro účet úložiště, kontejnery a objekty blob. Rozhraní API zahrnuje operace uvedené v následující tabulce.
| Operace | Typ prostředku | Description |
|---|---|---|
| Výpis kontejnerů | Účet | Zobrazí seznam všech kontejnerů 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í verzi 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ý požadavek na objekty blob | Účet | Před odesláním vlastního požadavku 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í pro službu 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 jen 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 pro 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ů Azure Active Directory (Azure AD). |
| 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 | Zobrazí seznam všech objektů blob v kontejneru. |
| Vložení objektu blob | Objekty blob bloku, doplňování a objekty blob stránky | Vytvoří nový objekt blob nebo nahradí existující objekt blob v rámci kontejneru. |
| Získání objektu blob | Objekty blob bloku, doplňování a objekty blob 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, doplňování a objekty blob stránky | Vrátí všechny systémové vlastnosti a uživatelem definovaná metadata objektu blob. |
| Nastavení vlastností objektu blob | Objekty blob bloku, doplňování a objekty blob stránky | Nastaví systémové vlastnosti definované pro existující objekt blob. |
| Nastavit vypršení platnosti objektu blob | Objekty blob bloku | Nastaví čas vypršení platnosti pro existující objekt blob. |
| Získání metadat objektu blob | Objekty blob bloku, doplňování a objekty blob stránky | Načte všechna uživatelem definovaná metadata existujícího objektu blob nebo snímku. |
| Nastavení metadat objektu blob | Objekty blob bloku, doplňování a objekty blob stránky | Nastaví uživatelem definovaná metadata existujícího objektu blob. |
| Získání značek objektů blob | Objekty blob bloku, doplňování a objekty blob stránky | Načte uživatelem definované značky existujícího objektu blob. |
| Nastavení značek objektů blob | Objekty blob bloku, doplňování a objekty blob 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, doplňování a objekty blob stránky | Vypíše objekty blob podle jejich uživatelsky definovaných značek. |
| Odstranění objektu blob | Objekty blob bloku, doplňování a objekty blob stránky | Označí objekt blob k odstranění. |
| Zrušit odstranění objektu blob | Objekty blob bloku, připojení a stránky | Obnoví obsah a metadata obnovitelného odstraněného objektu blob nebo všechny přidružené obnovitelné odstraněné snímky. |
| Operace Lease Blob | Objekty blob bloku, připojení a stránky | Vytvoří a spravuje uzamčení operací zápisu a odstranění. K odstranění nebo zápisu do uzamčeného objektu blob musí klient zadat ID zapůjčení. |
| Pořízení snímku objektu blob | Objekty blob bloku, připojení a stránky | Vytvoří snímek objektu blob jen pro čtení. |
| Zkopírování objektu blob | Objekty blob bloku, připojení a 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, připojení a stránky | Zastaví čekající Copy Blob operaci a ponechá cílový objekt blob s nulovou délkou a úplnými metadaty. |
| Vložit blok | Pouze objekty blob bloku | Vytvoří nový blok, který se potvrdí jako součást objektu blob bloku. |
| Vložit blok z adresy URL | Pouze objekty blob bloku | Vytvoří nový blok, který se má potvrdit jako součást objektu blob bloku, kde se obsah přeč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 položek | Pouze objekty blob bloku | Načte seznam bloků, které se nahrály jako součást objektu blob bloku. |
| Dotazování na obsah objektů 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 | Jenom objekty blob stránky | Zapíše rozsah stránek do objektu blob stránky. |
| Získání rozsahů stránek | Jenom 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 | Jenom 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ů)