Azure Storage REST API referens

Med REST-API:erna för Microsoft Azure Storage Services får du programmeringsbaserad åtkomst till tjänsterna Blob, Queue, Table och File i Azure, eller i utvecklingsmiljöer via lagringsemulatorn.

Alla lagringstjänster är tillgängliga via REST-API:er. Storage-tjänster kan nås inifrån en tjänst som körs i Azure, eller direkt via Internet från alla program som kan skicka en HTTP/HTTPS-begäran och ta emot ett HTTP/HTTPS-svar.

Lagringskonto

All åtkomst till lagringstjänster sker via lagringskontot. Lagringskontot är den högsta nivån av namnområdet för åtkomst till var och en av de grundläggande tjänsterna. Det är också grunden för auktorisering.

REST-API:erna för lagringstjänster exponerar lagringskontot som en resurs.

Blob-tjänst

Blob-tjänsten tillhandahåller lagring för entiteter, till exempel binära filer och textfiler. I REST API för Blob Service exponeras två resurser: containrar och blobar. En container är som en mapp som innehåller en uppsättning blobar. varje blob måste finnas i en container. Blob-tjänsten definierar tre typer av blobar:

• Blockblobar som är optimerade för strömning. Den här typen av blob är den enda blob-typen som är tillgänglig med versioner före 2009-09-19.

• Sidblobar som är optimerade för slumpmässiga läs-/skrivåtgärder och som ger möjlighet att skriva till ett intervall med byte i en blob. Sidblobar är tillgängliga med version 2009-09-19 och senare. Dessa används främst för VHD-filer som backar upp AzureVM:erna.

• Tilläggsblobar som är optimerade för tilläggsåtgärder. Tilläggsblobar är endast tillgängliga med version 2015-02-21 och senare.

Containrar och blobar stöder användardefinierade metadata i form av namn/värde-par som anges som rubriker i en begärandeåtgärd.

Med hjälp REST API för Blob Service kan utvecklare skapa ett hierarkiskt namnområde som liknar ett filsystem. Blobnamn kan koda en hierarki med hjälp av en konfigurerbar sökvägsavgränsare. Till exempel innebär blobnamnen MyGroup/MyBlob1 och MyGroup/MyBlob2 en virtuell organisationsnivå för blobar. Uppräkningsåtgärden för blobar stöder traversering av den virtuella hierarkin på ett sätt som liknar det i ett filsystem, så att du kan returnera en uppsättning blobar som är ordnade under en grupp. Du kan till exempel räkna upp alla blobar som är ordnade under MyGroup/.

En blockblob kan skapas på något av två sätt. Du kan ladda upp en blob med en enda Put Blob-åtgärd, eller så kan du ladda upp en blob som en uppsättning block med en Put Block-åtgärd och genomföra blocken till en blob med åtgärden Placera blockeringslista.

Sidblobar skapas och initieras med en maximal storlek med ett anrop till Put Blob. Om du vill skriva innehåll till en sidblob anropar du åtgärden Placera sida.

Du kan skapa tilläggsblobar genom att anropa Put Blob. En tilläggsblob som skapats med åtgärden Put Blob innehåller inte något innehåll. Om du vill skriva innehåll till en tilläggsblob lägger du till block i slutet av bloben genom att anropa åtgärden Lägg till block. Uppdatering eller borttagning av befintliga block stöds inte. Varje block kan ha olika storlek, upp till högst 4 MiB. Den maximala storleken för en tilläggsblob är 195 GiB och en tilläggsblob kan innehålla högst 50 000 block.

Blobar har stöd för villkorsstyrda uppdateringsåtgärder som kan vara användbara för samtidighetskontroll och effektiv uppladdning.

Blobar kan läsas genom att anropa åtgärden Hämta blob. En klient kan läsa hela bloben eller ett godtyckligt byteintervall.

Referensen för BLOB Service-API:et finns i Blob Tjänst-REST-API.

Kötjänst

Den Kötjänst tillhandahåller tillförlitliga, beständiga meddelanden inom och mellan tjänster. Den REST API för Kötjänst exponerar två resurser: köer och meddelanden.

Köer stöder användardefinierade metadata i form av namn/värde-par som anges som rubriker för en begärandeåtgärd.

Varje lagringskonto kan ha ett obegränsat antal meddelandeköer som namnges unikt i kontot. Varje meddelandekö kan innehålla ett obegränsat antal meddelanden. Den maximala storleken för ett meddelande är begränsad till 64 KiB för version 2011-08-18 och 8 KiB för tidigare versioner.

När ett meddelande läses från kön förväntas konsumenten bearbeta meddelandet och sedan ta bort det. När meddelandet har lästs görs det osynligt för andra användare under ett angivet intervall. Om meddelandet ännu inte har tagits bort när intervallet upphör att gälla återställs dess synlighet, så att en annan konsument kan bearbeta det.

Mer information om Kötjänst finns i Queue Tjänst-REST-API.

Tabelltjänst

Tabelltjänsten tillhandahåller strukturerad lagring i form av tabeller. Table-tjänsten stöder en REST API som implementerar OData-protokollet.

I ett lagringskonto kan en utvecklare skapa tabeller. Tabeller lagrar data som entiteter. En entitet är en samling namngivna egenskaper och deras värden, ungefär som en rad. Tabeller partitioneras för att stödja belastningsutjämning mellan lagringsnoder. Varje tabell har som sin första egenskap en partitionsnyckel som anger den partition som en entitet tillhör. Den andra egenskapen är en radnyckel som identifierar en entitet inom en viss partition. Kombinationen av partitionsnyckeln och radnyckeln utgör en primärnyckel som identifierar varje entitet unikt i tabellen.

Tabelltjänsten framtvingar inte något schema. En utvecklare kan välja att implementera och framtvinga ett schema på klientsidan. Mer information om table-tjänsten finns i Table Tjänst-REST-API.

Filtjänst

Protokollet Server Message Block (SMB) är det föredragna filresursprotokollet som används lokalt idag. Tjänsten Microsoft Azure File gör det möjligt för kunder att utnyttja tillgängligheten och skalbarheten hos Azures Cloud Infrastructure as a Service (IaaS) SMB utan att behöva skriva om SMB-klientprogram.

Azure File Service erbjuder också ett övertygande alternativ till traditionella lösningar för direktkopplad Storage (DAS) och Storage Area Network (SAN), som ofta är komplexa och dyra att installera, konfigurera och använda.

Filer som lagras i Azure-filtjänstresurser är tillgängliga via SMB-protokollet och även via REST-API:er. Filtjänsten erbjuder följande fyra resurser: lagringskontot, resurser, kataloger och filer. Resurser är ett sätt att organisera uppsättningar av filer och kan även monteras som en SMB-filresurs som finns i molnet.

Se även

Blob-Tjänst-REST-API Kö Tjänst-REST-API Tabell Tjänst-REST-API Fil Tjänst-REST-API