Ta bort blob

  • Artikel
  • 5 minuter för att läsa

Åtgärden Delete Blob markerar den angivna bloben eller ögonblicksbilden för borttagning. Bloben tas senare bort under skräpinsamlingen.

Observera att du måste ta bort alla dess ögonblicksbilder för att kunna ta bort en blob. Du kan ta bort båda samtidigt med Delete Blob åtgärden .

Förfrågan

Begäran Delete Blob kan konstrueras på följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto:

URI för DELETE-metodbegäran HTTP-version
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>		 HTTP/1.1

Emulerad lagringstjänst-URI

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Blob Service-port som följt av namnet på det 127.0.0.1:10000 emulerade lagringskontot:

URI för DELETE-metodbegäran HTTP-version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

Mer information finns i Använda Azure Storage Emulator för utveckling och testning.

URI-parametrar

Följande ytterligare parametrar kan anges för URI:en för begäran.

Parameter Beskrivning
snapshot Valfritt. Parametern snapshot är ett täckande DateTime värde som anger vilken blobögonblicksbild som ska tas bort när den finns. Mer information om hur du arbetar med blobögonblicksbilder finns i Skapa en ögonblicksbild av en blob.
versionid Valfritt, version 2019-12-12 och senare. Parametern versionid är ett täckande värde som anger vilken version av bloben som ska tas bort när den DateTime finns.
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Service-åtgärder.
deletetype Valfritt, version 2020-02-10 eller senare. Värdet för deletetype kan bara vara permanent . Mer information finns i Kommentarer nedan.

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud Description
Authorization Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Authorize requests to Azure Storage.
Date eller x-ms-date Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Authorize requests to Azure Storage.
x-ms-version Krävs för alla auktoriserade begäranden. Mer information finns i Versionshantering för Azure Storage Services.
x-ms-lease-id:<ID> Krävs om bloben har ett aktivt lån.

Om du vill utföra den här åtgärden på en blob med ett aktivt lån anger du det giltiga låne-ID:t för det här huvudet. Om ett giltigt låne-ID inte har angetts på begäran misslyckas åtgärden med statuskod 403 (förbjudet).
x-ms-delete-snapshots: {include, only} Krävs om bloben har associerade ögonblicksbilder. Ange något av följande två alternativ:

- include: Ta bort basbloben och alla dess ögonblicksbilder.
- only: Ta bara bort blobens ögonblicksbilder och inte själva bloben.

Det här huvudet ska endast anges för en begäran mot basblobresursen. Om det här huvudet anges i en begäran om att ta bort en enskild ögonblicksbild returnerar Blob Service statuskod 400 (felaktig begäran).

Om det här huvudet inte anges i begäran och bloben har associerade ögonblicksbilder returnerar Blob Service statuskod 409 (konflikt).
x-ms-client-request-id Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 KiB som registreras i analysloggarna när loggning av lagringsanalys är aktiverat. Användning av det här huvudet rekommenderas starkt för korrelering av aktiviteter på klientsidan med begäranden som tas emot av servern. Mer information finns i About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests (Om Storage Analytics-loggning och Azure Logging: Using Logs to Track Storage Requests (Använda loggar för att spåra Storage begäranden).

Den här åtgärden stöder också användning av villkorsstyrda huvuden för att ta bort bloben endast om ett angivet villkor uppfylls. Mer information finns i Ange villkorsstyrda huvuden för Blob Service-åtgärder.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskod 202 (accepterad).

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

Svaret för den här åtgärden innehåller följande huvuden. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden följer protokollspecifikationen HTTP/1.1.

Svarshuvud Description
x-ms-request-id Det här huvudet identifierar unikt begäran som har gjorts och kan användas för felsökning av begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version Anger vilken version av blobtjänsten som används för att köra begäran. Det här huvudet returneras för begäranden som görs mot version 2009-09-19 och senare.
x-ms-delete-type-permanent För version 2017-07-29 och senare returnerar Blob Service true om bloben har tagits bort permanent och false om bloben har mjuk borttagning.
Date Ett datum-/tidsvärde för UTC som genererats av tjänsten och som anger vid vilken tid svaret initierades.
x-ms-client-request-id Det här huvudet kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för -huvudet om det finns i begäran och värdet är högst x-ms-client-request-id 1 024 synliga ASCII-tecken. Om x-ms-client-request-id -huvudet inte finns i begäran finns det här huvudet inte i svaret.

Auktorisering

Den här åtgärden kan utföras av kontoägaren eller av någon som använder en signatur för delad åtkomst som har behörighet att ta bort bloben.

Kommentarer

Om bloben har ett aktivt lån måste klienten ange ett giltigt låne-ID för begäran för att kunna ta bort den.

Om en blob har ett stort antal ögonblicksbilder är det möjligt att Delete Blob åtgärdens time out. Om detta inträffar bör klienten försöka utföra begäran igen.

För version 2013-08-15 och senare kan klienten anropa för att Delete Blob ta bort ej inlästa blobar. En ogenomsagd blob är en blob som har skapats med anrop till Put Block-åtgärden men som aldrig har utförts med åtgärden Placera blockeringslista. För tidigare versioner måste klienten först bekräfta bloben innan den tas bort.

Funktionen mjuk borttagning är inaktiverad

När en blob tas bort tas den omedelbart bort från lagringskontots index och är inte längre tillgänglig för klienter. Blobens data tas senare bort från tjänsten under skräpinsamlingen.

Funktionen mjuk borttagning är aktiverad

När en blob tas bort tas den bort mjukt och är inte längre tillgänglig för klienter. Blob-tjänsten behåller bloben eller ögonblicksbilden under det antal dagar som anges för egenskapen DeleteRetentionPolicy för blobtjänsten. Information om hur du läser egenskaper för Blob Service finns i Ange egenskaper för Blob Service.

Efter det angivna antalet dagar tas blobens data bort från tjänsten under skräpinsamlingen. En mjukt borttagna blob eller ögonblicksbild är tillgänglig genom att anropa åtgärden Listblobar och ange include=deleted alternativet .

Mjuk borttagning av blob eller ögonblicksbild kan återställas med hjälp av Undelete Blob.

För andra åtgärd på mjukt borttagna blobar eller ögonblicksbilder returnerar Blob Service fel 404 (ResourceNotFound).

Permanent borttagning

En funktion för att permanent ta bort en ögonblicksbild/version har lagts till i ta bort blob-API med version 2020-02-10 och senare. För att kunna utnyttja funktionen måste lagringskontot ha permanent borttagning aktiverat. Mer information finns i Ange Egenskaper för Blob Service.

Storage-konton med permanent borttagning aktiverat kan använda frågeparametern för att permanent ta bort en mjukt borttagna deletetype=permanent ögonblicksbilder eller en borttagna blobversion. Blob Service returnerar 409 (konflikt) om frågeparametern visar något av följande:

  • Den permanenta borttagningen är inte aktiverad för lagringskontot.
  • Varken versionid eller snapshot tillhandahålls.
  • Den angivna ögonblicksbilden eller versionen tas inte bort (mjuk).

Permanent borttagning innehåller också en ny SAS-behörighet (y) som ger behörighet att permanent ta bort en blobögonblicksbild eller blobversion. Mer information finns i Skapa en tjänst-SAS.

Se även

Auktorisera begäranden till Azure Storage
Status och felkoder
Felkoder för Blob Service Undelete Blob List Blobs