Referenční informace k rozhraní REST API služby Azure Storage

Článek
07/11/2023

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. Ke službám úložiště je možné přistupovat ze služby spuštěné v Azure nebo přímo přes internet z libovolné aplikace, která může odeslat požadavek HTTP/HTTPS a přijmout odpověď HTTP/HTTPS.

Důležité

Služby Azure Storage podporují protokoly HTTP i HTTPS. Použití protokolu HTTPS se však důrazně doporučuje.

Úč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šší úrovní oboru názvů pro přístup ke každé základní službě. Je také základem pro autorizaci.

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

Služba objektů blob

Služba Blob service poskytuje úložiště pro entity, jako jsou binární soubory a textové soubory. Rozhraní REST API pro službu Blob zpřístupňuje dva prostředky: kontejnery a objekty blob. Kontejner je jako složka, která obsahuje sadu objektů blob; Každý objekt blob se musí nacházet v kontejneru. Služba 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 starších než 2009-09-19.
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. Objekty blob stránky jsou dostupné ve verzi 2009-09-19 a novější. Primárně se 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 2015-02-21 a novější.

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

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

Objekt blob bloku může být vytvořen 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ů s operací Put Block a potvrdit bloky do objektu blob pomocí operace Put Block List .

Objekty blob stránky se vytvoří a inicializují s maximální velikostí pomocí volání Put Blob. Pokud chcete zapsat obsah do objektu blob stránky, zavolejte operaci Put Page .

Doplňovací objekty blob je možné vytvořit voláním put blob. Doplňovací objekt blob vytvořený operací 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 Připojit blok . Aktualizace nebo odstranění existujících bloků se nepodporuje. Každý blok může mít jinou velikost, maximálně 4 MiB. Maximální velikost doplňovacích objektů 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é můžou být užitečné pro řízení souběžnosti a efektivní nahrávání.

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

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

Služba front

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

Fronty podporují uživatelem definovaná metadata ve formě dvojic 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 jedinečně pojmenované. Každá fronta zpráv může obsahovat neomezený počet zpráv. Maximální velikost zprávy je omezená na 64 KiB pro verzi 2011-08-18 a 8 KiB pro předchozí verze.

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í se zpráva po zadaný interval ostatním příjemcům zobrazí jako neviditelná. Pokud zpráva ještě nebyla odstraněna v době vypršení intervalu, obnoví se její viditelnost, aby ji mohl zpracovat jiný příjemce.

Další informace o službě Queue Service najdete v tématu Rozhraní REST API služby front.

Služba Table service

Služba Table service poskytuje strukturované úložiště ve formě tabulek. Služba Table podporuje rozhraní 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 první vlastnost klíč oddílu, který určuje oddíl, do kterého entita patří. Druhá vlastnost je klíč řádku, který identifikuje entitu v rámci daného oddílu. Kombinace klíče oddílu a klíče řádku tvoří primární klíč, který jedinečně identifikuje každou entitu v tabulce.

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

Souborová služba

Upřednostňovaným protokolem sdílené složky, který se dnes používá místně, je protokol SMB (Server Message Block). Služba Microsoft Azure File umožňuje zákazníkům využívat dostupnost a škálovatelnost protokolu SMB cloudové infrastruktury jako služby (IaaS) Azure, aniž by museli přepisovat klientské aplikace SMB.

Služba Azure File také nabízí atraktivní alternativu k tradičním řešením das (Direct Attached Storage) a sítí SAN (Storage Area Network), která jsou často složitá a náročná na instalaci, konfiguraci a provoz.

Soubory uložené ve sdílených složkách služby Azure File jsou přístupné prostřednictvím protokolu 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, jak uspořádat sady souborů a také je možné je připojit jako sdílenou složku SMB hostovanou v cloudu.

Viz také

Fronta služby REST API služby REST API služby Rest Api Table Service REST API File Service REST API