Azure Storage REST API referenční informace

Rozhraní REST API pro služby Microsoft Azure Storage nabízí programový přístup ke službám Blob, Queue, Table a File v Azure nebo ve vývojovém prostředí prostřednictvím emulátoru úložiště.

Všechny služby úložiště jsou přístupné prostřednictvím rozhraní REST API. Storage služby mohou být přístupné ze služby běžící v Azure nebo přímo přes internet z jakékoli aplikace, která může odeslat požadavek HTTP/HTTPS a přijmout odpověď HTTP/HTTPS.

Účet úložiště

Veškerý přístup ke službám úložiště probíhá prostřednictvím účtu úložiště. Účet úložiště je nejvyšší úroveň oboru názvů pro přístup ke každé ze základních služeb. Je to také základ pro autorizaci.

Rozhraní REST API pro služby úložiště zpřístupňuje účet úložiště jako prostředek.

Služba objektů blob

Úložiště Blob service úložiště pro entity, jako jsou binární soubory a textové soubory. Funkce REST API pro Blob service zveřejňuje dva prostředky: kontejnery a objekty blob. Kontejner je jako složka obsahující sadu objektů blob. Každý objekt blob se musí nacházet v kontejneru. Následující Blob service definuje tři typy objektů blob:

• Objekty blob bloku, které jsou optimalizované pro streamování. Tento typ objektu blob je jediným typem objektu blob dostupným ve verzích před 19. 9. 2009.

• Objekty blob stránky, které jsou optimalizované pro náhodné operace čtení a zápisu a umožňují zapisovat do rozsahu bajtů v objektu blob. Objekty blob stránky jsou k dispozici ve verzi 2009-09-19 a novější. Ty se primárně používají pro soubory VHD, které zálohují virtuální počítače Azure.

• Doplňovací objekty blob, které jsou optimalizované pouze pro operace připojení. Doplňovací objekty blob jsou k dispozici pouze ve verzi 21. 2. 2015 a novější.

Kontejnery a objekty blob podporují uživatelem definovaná metadata ve formě párů název-hodnota zadaných jako hlavičky v operaci požadavku.

Pomocí REST API pro Blob service mohou vývojáři vytvořit hierarchický obor názvů podobný systému souborů. Názvy objektů blob mohou zakódovat hierarchii pomocí konfigurovatelného oddělovače cest. Například názvy objektů blob MyGroup/MyBlob1 a MyGroup/MyBlob2 implují virtuální úroveň organizace pro objekty blob. Operace výčtu pro objekty blob podporuje procházení virtuální hierarchie podobným způsobem jako systém souborů, abyste mohli vrátit sadu objektů blob uspořádaných pod skupinou. Můžete například vytvořit výčet všech objektů blob uspořádaných v části MyGroup/.

Objekt blob bloku je možné vytvořit jedním ze dvou způsobů. Objekt blob můžete nahrát pomocí jedné operace Put Blob nebo můžete nahrát objekt blob jako sadu bloků pomocí operace Put Block a potvrdit bloky do objektu blob pomocí operace Put Block List.

Objekty blob stránky se vytvářejí a inicializovaly s maximální velikostí voláním metody Put Blob. Pokud chcete zapisovat obsah do objektu blob stránky, zavoláte operaci Put Page.

Doplňovací objekty blob je možné vytvořit voláním metody Put Blob. Doplňovací objekt blob vytvořený pomocí operace Put Blob neobsahuje žádný obsah. Pokud chcete zapisovat obsah do doplňovacího objektu blob, přidejte bloky na konec objektu blob voláním operace Append Block (Připojit blok). Aktualizace nebo odstranění existujících bloků se nepodporuje. Každý blok může mít různou velikost až do maximální velikosti 4 MiB. Maximální velikost doplňovacího objektu blob je 195 GiB a doplňovací objekt blob může obsahovat maximálně 50 000 bloků.

Objekty blob podporují operace podmíněné aktualizace, které mohou být užitečné pro řízení souběžnosti a efektivní nahrávání.

Objekty blob je možné číst voláním operace Get Blob. Klient může číst celý objekt blob nebo libovolný rozsah bajtů.

Referenční informace k Blob service API najdete v tématu Blob rozhraní REST API služby.

Služba front

Služba Služba front spolehlivé a trvalé zasílání zpráv v rámci služeb a mezi nimi. Funkce REST API pro Služba front zveřejňuje dva prostředky: fronty a zprávy.

Fronty podporují uživatelem definovaná metadata ve formě párů název-hodnota zadaných jako hlavičky v operaci požadavku.

Každý účet úložiště může mít neomezený počet front zpráv, které jsou v rámci účtu pojmenovány jedinečně. Každá fronta zpráv může obsahovat neomezený počet zpráv. Maximální velikost zprávy je omezená na 64 KiB pro předchozí verze 2011-08-18 a 8 KiB.

Při čtení zprávy z fronty se očekává, že příjemce zprávu zpracuje a pak ji odstraní. Po přečtení je zpráva po zadanou dobu neviditelná ostatním spotřebitelům. Pokud zpráva ještě nebyla v době vypršení platnosti intervalu odstraněna, její viditelnost se obnoví, aby ji mohl zpracovat jiný příjemce.

Další informace o této Služba front v tématu Queue rozhraní REST API služby.

Služba Table service

Služba Table Service poskytuje strukturované úložiště ve formě tabulek. Služba Table Service podporuje REST API který implementuje protokol OData.

V rámci účtu úložiště může vývojář vytvářet tabulky. Tabulky ukládají data jako entity. Entita je kolekce pojmenovaných vlastností a jejich hodnot, podobně jako řádek. Tabulky jsou rozdělené na oddíly, aby podporovaly vyrovnávání zatížení mezi uzly úložiště. Každá tabulka má jako svou první vlastnost klíč oddílu, který určuje oddíl, do který entita patří. Druhá vlastnost je klíč řádku, který identifikuje entitu v daném oddílu. Kombinace klíče oddílu a klíče řádku tvoří primární klíč, který jednoznačně identifikuje každou entitu v tabulce.

Služba Table Service nevynucuje žádné schéma. Vývojář se může rozhodnout implementovat a vynucovat schéma na straně klienta. Další informace o službě Table service najdete v tématu Table rozhraní REST API služby.

Souborová služba

Protokol SMB (Server Message Block) je upřednostňovaný protokol sdílené složky, který se dnes používá místně. Služba Microsoft Azure File umožňuje zákazníkům využívat dostupnost a škálovatelnost protokolu SMB Cloud Infrastructure as a Service (IaaS) Azure bez nutnosti přepisovat klientské aplikace SMB.

Služba Azure File také nabízí přesvědčivou alternativu k tradičním řešením DAS (Direct Attached Storage) a Storage Area Network (SAN), která jsou často složitá a nákladná na instalaci, konfiguraci a provoz.

Soubory uložené ve sdílených složce Azure File Service jsou přístupné přes protokol SMB a také prostřednictvím rozhraní REST API. Služba File nabízí následující čtyři prostředky: účet úložiště, sdílené složky, adresáře a soubory. Sdílené složky poskytují způsob uspořádání sad souborů a lze je připojit také jako sdílené složky SMB hostované v cloudu.

Viz také

Blob rozhraní REST API služby Fronta rozhraní REST API služby Tabulka rozhraní REST API služby Soubor rozhraní REST API služby