Azure Storage REST API-referencia
A Microsoft Azure tárolási szolgáltatások REST API-jai programozás alapú hozzáférést biztosítanak a Blob-, az üzenetsor-, a tábla- vagy a fájlszolgáltatásokhoz az Azure-ban vagy a táremulátor használatával a fejlesztési környezetben.
Minden tárolási szolgáltatás REST API-kon keresztül érhető el. A tárolási szolgáltatások az Azure-ban futó szolgáltatáson belül, vagy közvetlenül az interneten keresztül érhetők el bármely olyan alkalmazásból, amely HTTP/HTTPS-kérést küldhet, és HTTP/HTTPS-választ kaphat.
Fontos
Az Azure Storage-szolgáltatások a HTTP-t és a HTTPS-t is támogatják; A HTTPS használata azonban erősen ajánlott.
Tárfiók
A társzolgáltatásokhoz való minden hozzáférés a tárfiókon keresztül történik. A tárfiók a névtér legmagasabb szintje az egyes alapvető szolgáltatások eléréséhez. Ez az engedélyezés alapja is.
A tárolási szolgáltatások REST API-jait a tárfiók erőforrásként teszi elérhetővé.
Blob szolgáltatás
A Blob szolgáltatás tárolót biztosít az entitásokhoz, például bináris fájlokhoz és szövegfájlokhoz. A Blob szolgáltatás REST API-ja két erőforrást tesz elérhetővé: a tárolókat és a blobokat. A tároló olyan, mint egy mappa, amely blobokat tartalmaz; minden blobnak tárolóban kell lennie. A Blob szolgáltatás három blobtípust határoz meg:
Streamelésre optimalizált blokkblobok. Ez a blobtípus az egyetlen olyan blobtípus, amely a 2009-09-19 előtti verziókkal érhető el.
Lapblobok, amelyek véletlenszerű olvasási/írási műveletekre vannak optimalizálva, és amelyek lehetővé teszik a blobok bájttartományba történő írását. A lapblobok a 2009-09-19-es és újabb verzióval érhetők el. Ezek elsősorban az AzureVM-eket biztonsági mentési VHD-fájlokhoz használják.
Hozzáfűző blobok, amelyek csak hozzáfűzési műveletekhez vannak optimalizálva. A hozzáfűző blobok csak a 2015-02-21-es és újabb verzióval érhetők el.
A tárolók és blobok támogatják a felhasználó által definiált metaadatokat a kérelemművelet fejléceiként megadott név-érték párok formájában.
A Blob szolgáltatás REST API-jának használatával a fejlesztők egy fájlrendszerhez hasonló hierarchikus névteret hozhatnak létre. A blobnevek egy konfigurálható elérésiút-elválasztó használatával kódolhatják a hierarchiát. A MyGroup/MyBlob1 és a MyGroup/MyBlob2 blobnevek például a blobok szervezetének egy virtuális szintjét jelentik. A blobok enumerálási művelete támogatja a virtuális hierarchia fájlrendszerhez hasonló módon történő bejárását, így egy csoport alatt rendezett blobkészletet adhat vissza. Számba vehet például minden blobot a MyGroup/.
A blokkblobok kétféleképpen hozhatók létre. Feltölthet egy blobot egyetlen Put Blob művelettel, vagy feltölthet egy blobot blokkok készleteként egy Put Block művelettel, és véglegesítheti a blokkokat egy Blobban egy Put Block List művelettel.
A lapblobok létrehozása és inicializálása maximális mérettel, a Blob elhelyezése hívással. Ha tartalmat szeretne írni egy lapblobba, meghívja az Oldal elhelyezése műveletet.
A hozzáfűző blobok a Put Blob meghívásával hozhatók létre. A Blob elhelyezése művelettel létrehozott hozzáfűző blob nem tartalmaz tartalmat. Ha egy hozzáfűző blobba szeretne tartalmat írni, blokkokat adhat hozzá a blob végéhez a Hozzáfűzési blokk művelet meghívásával. A meglévő blokkok frissítése vagy törlése nem támogatott. Minden blokk különböző méretű lehet, legfeljebb 4 MiB méretű. A hozzáfűző blobok maximális mérete 195 GiB, és a hozzáfűző blob legfeljebb 50 000 blokkot tartalmazhat.
A blobok támogatják a feltételes frissítési műveleteket, amelyek hasznosak lehetnek az egyidejűség-vezérléshez és a hatékony feltöltéshez.
A blobok a Blob lekérése művelet meghívásával olvashatók. Az ügyfél elolvashatja a teljes blobot, vagy tetszőleges bájttartományt.
A Blob szolgáltatás API-referenciáját lásd: Blob Service REST API.
Queue szolgáltatás
A Queue szolgáltatás megbízható, állandó üzenetküldést biztosít a szolgáltatásokon belül és között. A Queue szolgáltatás REST API-ja két erőforrást tesz elérhetővé: az üzenetsorokat és az üzeneteket.
Az üzenetsorok támogatják a felhasználó által megadott metaadatokat a kérelemművelet fejléceként megadott név-érték párok formájában.
Minden tárfiókhoz korlátlan számú üzenetsor tartozhat, amelyek egyedileg vannak elnevezve a fiókon belül. Minden üzenetsor korlátlan számú üzenetet tartalmazhat. Az üzenetek maximális mérete a 2011-08-18-es és a 8 KiB-es verzióra korlátozódik a korábbi verziókhoz.
Ha az üzenetsorból olvas be egy üzenetet, a fogyasztónak fel kell dolgoznia az üzenetet, majd törölnie kell azt. Az üzenet elolvasása után a rendszer egy adott időtartamig láthatatlanná teszi a többi felhasználó számára. Ha az üzenet még nem lett törölve az időköz lejártakor, a láthatósága helyreáll, hogy egy másik felhasználó feldolgozhassa.
További információ a Queue szolgáltatásról: Queue Service REST API.
Table szolgáltatás
A Table szolgáltatás strukturált tárolást biztosít táblák formájában. A Table szolgáltatás támogatja az OData protokollt implementáló REST API-t.
A tárfiókon belül a fejlesztő táblákat hozhat létre. A táblák entitásként tárolják az adatokat. Az entitás nevesített tulajdonságok és azok értékeinek gyűjteménye, hasonló egy sorhoz. A táblák particionálása támogatja a tárolócsomópontok közötti terheléselosztást. Minden tábla első tulajdonsága egy partíciókulcs, amely meghatározza, hogy az entitás mely partícióhoz tartozik. A második tulajdonság egy sorkulcs, amely egy adott partíción belüli entitást azonosít. A partíciókulcs és a sorkulcs kombinációja egy elsődleges kulcsot alkot, amely egyedileg azonosítja az egyes entitásokat a táblában.
A Table szolgáltatás nem kényszerít sémát. A fejlesztők dönthetnek úgy, hogy implementálnak és érvényesítenek egy sémát az ügyféloldalon. A Table szolgáltatással kapcsolatos további információkért lásd: Table Service REST API.
Fájlszolgáltatás
A kiszolgálói üzenetblokk (SMB) protokoll a helyszínen ma használt előnyben részesített fájlmegosztási protokoll. A Microsoft Azure File szolgáltatás lehetővé teszi az ügyfelek számára, hogy SMB-ügyfélalkalmazások átírása nélkül használják ki az Azure felhőinfrastruktúra szolgáltatásként (IaaS) SMB-jének rendelkezésre állását és méretezhetőségét.
Az Azure File szolgáltatás a hagyományos közvetlen csatlakoztatott tárolási (DAS) és a tárolóhálózati (SAN) megoldások meggyőző alternatívát is kínál, amelyek telepítése, konfigurálása és üzemeltetése gyakran bonyolult és költséges.
Az Azure File Service-megosztásokban tárolt fájlok az SMB protokollon, valamint REST API-kon keresztül érhetők el. A Fájlszolgáltatás a következő négy erőforrást kínálja: a tárfiókot, a megosztásokat, a könyvtárakat és a fájlokat. A megosztások lehetővé teszik a fájlok rendszerezését, és a felhőben üzemeltetett SMB-fájlmegosztásként is csatlakoztathatók.
Lásd még
Blob Service REST APIQueue Service REST APITable Service REST APIFile Service REST API