Dela via


Azure Blob Storage REST API

Azure Blob Storage lagrar text och binära data som objekt i molnet. Blob Storage erbjuder följande resurser: lagringskontot, containrarna och blobarna. Containrar i ditt lagringskonto är ett sätt att organisera uppsättningar med blobar.

Du kan lagra text och binära data i någon av följande typer av blobar:

  • Blockblobar, som är optimerade för strömning.

  • Tilläggsblobar, som är optimerade för tilläggsåtgärder.

  • 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.

Mer information finns i Förstå blockblobar, tilläggsblobar och sidblobar.

REST-API:et för Blob Storage definierar HTTP-åtgärder mot lagringskontot, containrarna och blobarna. API:et innehåller de åtgärder som anges i följande tabell.

Åtgärd Resurstyp Description
Lista containrar Konto Listor alla containrar i ett lagringskonto.
Ange egenskaper för Blob Storage Konto Anger egenskaperna för Blob Storage, inklusive loggnings- och måttinställningar och standardversionen av tjänsten.
Hämta bloblagringsegenskaper Konto Hämtar egenskaperna Blob Storage, inklusive loggnings- och måttinställningar och standardversionen av tjänsten.
Preflight Blob Request Konto Kör frågor mot CORS-reglerna (Cross-Origin Resource Sharing) för Blob Storage innan den faktiska begäran skickas.
Hämta bloblagringsstatistik Konto Hämtar statistik relaterad till replikering för Blob Storage. Den här åtgärden är endast tillgänglig på den sekundära platsslutpunkten när geo-redundant replikering med läsbehörighet är aktiverad för lagringskontot.
Hämta kontoinformation Konto Returnerar SKU-namnet och kontotyp för det angivna kontot.
Hämta nyckel för användardelegering Konto Hämtar en nyckel som kan användas för att signera en signatur för delad åtkomst för användardelegering. Den här signaturen ger åtkomst till resurser i Blob Storage med hjälp av Microsoft Entra autentiseringsuppgifter.
Skapa container Container Skapar en container i ett lagringskonto.
Hämta containeregenskaper Container Returnerar alla användardefinierade metadata och systemegenskaper för en container.
Hämta containermetadata Container Returnerar endast användardefinierade metadata för en container.
Ange containermetadata Container Anger användardefinierade metadata för en container.
Hämta container-ACL Container Hämtar principen för offentlig åtkomst och eventuella lagrade åtkomstprinciper för containern.
Ange container-ACL Container Anger principen för offentlig åtkomst och eventuella lagrade åtkomstprinciper för containern.
Lånecontainer Container Upprättar och hanterar ett lås på en container för borttagningsåtgärder.
Ta bort container Container Tar bort containern och eventuella blobar som den innehåller.
Lista blobar Container Listor alla blobar i en container.
Placera blob Block-, tilläggs- och sidblobar Skapar en ny blob eller ersätter en befintlig blob i en container.
Hämta blob Block-, tilläggs- och sidblobar Läser eller laddar ned en blob från Blob Storage, inklusive dess användardefinierade metadata och systemegenskaper.
Hämta blobegenskaper Block-, tilläggs- och sidblobar Returnerar alla systemegenskaper och användardefinierade metadata på bloben.
Ange blobegenskaper Block-, tilläggs- och sidblobar Anger systemegenskaper som definierats för en befintlig blob.
Ange förfallodatum för blob Blockblobar Anger förfallotid för en befintlig blob.
Hämta blobmetadata Block-, tilläggs- och sidblobar Hämtar alla användardefinierade metadata för en befintlig blob eller ögonblicksbild.
Ange blobmetadata Block-, tilläggs- och sidblobar Anger användardefinierade metadata för en befintlig blob.
Hämta blobbtaggar Block-, tilläggs- och sidblobar Hämtar användardefinierade taggar för en befintlig blob.
Ange blobtaggar Block-, tilläggs- och sidblobar Anger användardefinierade taggar för en befintlig blob som utgör ett sekundärt index.
Hitta blobar efter taggar Block-, tilläggs- och sidblobar Listor blobar efter deras användardefinierade taggar.
Ta bort blob Block-, tilläggs- och sidblobar Markerar en blob för borttagning.
Ta bort blob Blockera, lägga till och sidblobar Återställer innehållet och metadata för en mjuk borttagen blob eller alla associerade ögonblicksbilder med mjuk borttagning.
Låna blob Blockera, lägga till och sidblobar Upprättar och hanterar ett lås för skriv- och borttagningsåtgärder. Om du vill ta bort eller skriva till en låst blob måste en klient ange låne-ID:t.
Ta ögonblicksbild av blob Blockera, lägga till och sidblobar Skapar en skrivskyddad ögonblicksbild av en blob.
Kopiera blob Blockera, lägga till och sidblobar Kopierar en källblob till en målblob i det här lagringskontot eller i ett annat lagringskonto.
Avbryt kopieringsblob Blockera, lägga till och sidblobar Stoppar en väntande Copy Blob åtgärd och lämnar en målblob med noll längd och fullständiga metadata.
Placera block Blockera endast blobar Skapar ett nytt block som ska checkas in som en del av en blockblob.
Placera blockera från URL Blockera endast blobar Skapar ett nytt block som ska checkas in som en del av en blockblob där innehållet läse från en URL.
Put Block List Blockera endast blobar Genomför en blob genom att ange den uppsättning block-ID:t som utgör blockbloben.
Hämta blockeringslista Blockera endast blobar Hämtar listan över block som har laddats upp som en del av en blockblob.
Frågeblobinnehåll Blockera endast blobar Tillämpar en enkel Structured Query Language-instruktion (SQL) på en blobs innehåll och returnerar endast den efterfrågade delmängden av data.
Ange blobnivå Block- och sidblobar Anger nivån för en blob.
Placera sida Endast sidblobar Skriver ett sidintervall till en sidblob.
Hämta sidintervall Endast sidblobar Returnerar en lista över giltiga sidintervall för en sidblob eller en ögonblicksbild av en sidblob.
Inkrementell kopieringsblob Endast sidblobar Kopierar en ögonblicksbild av en källsideblob till en målsideblob. Endast differentiella ändringar överförs.
Lägg till block Endast tilläggsblobar Skriver ett datablock till slutet av en tilläggsblob.

Innehåll i det här avsnittet

Blob Storage-begrepp

Åtgärder för kontot (Blob Storage)

Åtgärder på containrar

Åtgärder på blobar

Åtgärder på blobar (hierarkiska namnområdesaktiverade konton)

Se även

REST för lagringstjänster