Ta bort blob

Artikel
07/10/2024

Åtgärden Delete Blob tar bort den angivna bloben eller ögonblicksbilden.

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

Förfrågan

Du kan skapa begäran på Delete Blob följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto.

URI för begäran om DELETE-metod	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 Azure Blob Storage port som 127.0.0.1:10000, följt av namnet på det emulerade lagringskontot.

URI för begäran om DELETE-metod	HTTP-version
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.1

Mer information finns i Använda Azurite-emulatorn för lokal Azure Storage-utveckling.

URI-parametrar

Du kan ange följande ytterligare parametrar för begärande-URI:n.

Parameter	Beskrivning
`snapshot`	Valfritt. Ögonblicksbildsparametern är ett täckande `DateTime` värde som när den finns anger blobögonblicksbilden som ska tas bort. 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 `DateTime` värde som när den finns anger vilken version av bloben som ska tas bort.
`timeout`	Valfritt. Parametern `timeout` uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Storage-åtgärder.
`deletetype`	Valfritt, version 2020-02-10 eller senare. Värdet för `deletetype` kan bara vara `permanent`.

Begärandehuvuden

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

Begärandehuvud	Beskrivning
`Authorization`	Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
`Date` eller `x-ms-date`	Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
`x-ms-version`	Krävs för alla auktoriserade begäranden. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
`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 anges i begäran misslyckas åtgärden med statuskoden 403 (Förbjuden).
`x-ms-delete-snapshots: {include, only}`	Krävs om bloben har associerade ögonblicksbilder. Ange något av följande alternativ: - `include`: Ta bort basbloben och alla dess ögonblicksbilder. - `only`: Ta bara bort blobens ögonblicksbilder och inte själva bloben. Ange endast det här huvudet för en begäran mot basblobresursen. Om det här huvudet anges på en begäran om att ta bort en enskild ögonblicksbild returnerar Blob Storage statuskod 400 (felaktig begäran). Om det här huvudet inte anges i begäran och bloben har associerade ögonblicksbilder returnerar Blob Storage statuskod 409 (konflikt).
`x-ms-client-request-id`	Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Blob Storage.

Den här åtgärden stöder också användning av villkorsstyrda rubriker för att endast ta bort bloben om ett angivet villkor uppfylls. Mer information finns i Ange villkorsstyrda rubriker för Blob Storage-å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 statuskoden 202 (accepterad). Information om statuskoder finns i Status och felkoder.

Svarshuvuden

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

Svarsrubrik	Description
`x-ms-request-id`	Det här huvudet identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
`x-ms-version`	Anger vilken version av Blob Storage som används för att köra begäran. Det här huvudet returneras för begäranden mot version 2009-09-19 och senare.
`x-ms-delete-type-permanent`	För version 2017-07-29 och senare returnerar `true` Blob Storage om bloben har tagits bort permanent och `false` om bloben har tagits bort mjukt.
`Date`	Ett UTC-datum/tid-värde som anger den tid då svaret initierades. Tjänsten genererar det här värdet.
`x-ms-client-request-id`	Du kan använda det här huvudet 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 `x-ms-client-request-id` huvudet, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. `x-ms-client-request-id` Om rubriken inte finns i begäran visas inte det här huvudet i svaret.

Auktorisering

Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden enligt beskrivningen Delete Blob nedan.

Viktigt

Microsoft rekommenderar att du använder Microsoft Entra ID med hanterade identiteter för att auktorisera begäranden till Azure Storage. Microsoft Entra ID ger överlägsen säkerhet och användarvänlighet jämfört med auktorisering av delad nyckel.

Azure Storage stöder användning av Microsoft Entra ID för att auktorisera begäranden till blobdata. Med Microsoft Entra ID kan du använda rollbaserad åtkomstkontroll i Azure (Azure RBAC) för att bevilja behörigheter till ett säkerhetsobjekt. Säkerhetsobjektet kan vara en användare, grupp, programtjänstens huvudnamn eller en hanterad Azure-identitet. Säkerhetsobjektet autentiseras av Microsoft Entra ID för att returnera en OAuth 2.0-token. Token kan sedan användas för att auktorisera en begäran mot Blob-tjänsten.

Mer information om auktorisering med Microsoft Entra ID finns i Auktorisera åtkomst till blobar med hjälp av Microsoft Entra ID.

Behörigheter

Nedan visas den RBAC-åtgärd som krävs för att en Microsoft Entra användare, grupp, hanterad identitet eller tjänstens huvudnamn ska anropa Delete Blob åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den här åtgärden:

Azure RBAC-åtgärd:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/delete
Minsta privilegierade inbyggda roll:Storage Blob Data-deltagare

Mer information om hur du tilldelar roller med hjälp av Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.

En signatur för delad åtkomst (SAS) ger säker delegerad åtkomst till resurser i ett lagringskonto. Med en SAS har du detaljerad kontroll över hur en klient kan komma åt data. Du kan ange vilken resurs klienten får åtkomst till, vilka behörigheter de har till dessa resurser och hur länge SAS är giltig.

Åtgärden Delete Blob stöder tre typer av signaturer för delad åtkomst: SAS för användardelegering, tjänst-SAS och konto-SAS.

Vi rekommenderar att du använder Microsoft Entra autentiseringsuppgifter i stället för lagringskontonyckeln, vilket är enklare att kompromettera. Om din programdesign kräver signaturer för delad åtkomst använder du Microsoft Entra autentiseringsuppgifter för att skapa en SAS för användardelegering när det är möjligt.

När åtkomst med delad nyckel inte tillåts för lagringskontot tillåts inte en SAS-token för tjänsten eller en SAS-token för kontot på en begäran till Blob Storage. Mer information finns i Förstå hur nekande av delad nyckel påverkar SAS-token.

SAS för användardelegering

En SAS för användardelegering skyddas med Microsoft Entra autentiseringsuppgifter och även av de behörigheter som anges för SAS.

Delete Blob Att anropa åtgärden med en SAS-token som delegerats till en container eller blobresurs kräver behörigheten Ta bort (d) som en del av SAS-token för användardelegering.

Mer information om SAS för användardelegering finns i Skapa en SAS för användardelegering.

Tjänst-SAS

En tjänst-SAS skyddas med lagringskontonyckeln. En tjänst-SAS delegerar åtkomst till en resurs i en enda Azure Storage-tjänst, till exempel bloblagring.

Delete Blob Att anropa åtgärden med en SAS-token som delegerats till en container eller blobresurs kräver behörigheten Ta bort (d) som en del av tjänstens SAS-token.

Mer information om tjänstens SAS finns i Skapa en tjänst-SAS.

Konto-SAS

Ett konto-SAS skyddas med lagringskontonyckeln. En konto-SAS delegerar åtkomst till resurser i en eller flera av lagringstjänsterna. Alla åtgärder som är tillgängliga via en sas för tjänst- eller användardelegering är också tillgängliga via ett konto-SAS.

Följande tabell anger den signerade resurstypen och de signerade behörigheter som ska anges när åtkomst delegeras:

Åtgärd	Signerad tjänst	Signerad resurstyp	Signerad behörighet
Ta bort blob	Blob (b)	Objekt (o)	Ta bort (d)

Mer information om kontots SAS finns i Skapa ett konto-SAS.

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 åtgärden överskrider tidsgränsen Delete Blob . Om detta inträffar bör klienten försöka begära igen.

För version 2013-08-15 och senare kan klienten anropa Delete Blob för att ta bort ogenomförda blobar. En icke-bekräftad blob är en blob som skapades med anrop till put block-åtgärden , men som aldrig checkades in med hjälp av åtgärden Placera blockeringslista . För tidigare versioner måste klienten checka in bloben först innan den tas bort.

Funktionen mjuk borttagning har inaktiverats

När en blob har tagits bort tas den omedelbart bort från lagringskontots index och är inte längre tillgänglig för klienter.

Funktionen mjuk borttagning är aktiverad

När en blob har tagits bort tas den bort mjukt och är inte längre tillgänglig för klienter. Blob Storage behåller bloben eller ögonblicksbilden för det antal dagar som angetts för DeleteRetentionPolicy egenskapen Blob Storage. Information om hur du läser Blob Storage-egenskaper finns i Ange bloblagringsegenskaper.

Efter det angivna antalet dagar tas blobens data bort från tjänsten. Du kan komma åt en mjukt borttagen include=deleted blob eller ögonblicksbild genom att anropa åtgärden Listblobar och ange alternativet .

Du kan återställa mjukt borttagna blobar eller ögonblicksbilder med hjälp av Ta bort blob. För andra åtgärder på mjukt borttagna blobar eller ögonblicksbilder returnerar Blob Storage fel 404 (resursen hittades inte).

Permanent borttagning

Med version 2020-02-10 och senare kan du permanent ta bort en mjukt borttagen ögonblicksbild eller version. Det gör du genom att aktivera funktionen. Mer information finns i Ange bloblagringsegenskaper.

Anteckning

Versionshantering eller ögonblicksbilder måste vara aktiverat för lagringskontot. Mjuk borttagning måste också aktiveras på lagringskontot för att mjuk borttagning av versioner eller ögonblicksbilder av blobar i kontot. Permanent borttagning tar endast bort mjukt borttagna ögonblicksbilder eller versioner.

Lagringskonton med permanent borttagning aktiverat kan använda deletetype=permanent frågeparametern för att permanent ta bort en mjukt borttagen ögonblicksbild eller borttagen blobversion.

Om frågeparametern visar något av följande returnerar Blob Storage ett 409-fel (konflikt):

Funktionen permanent borttagning är inte aktiverad för lagringskontot.
Varken eller versionidsnapshot tillhandahålls.
Den angivna ögonblicksbilden eller versionen tas inte bort mjukt.

Permanent borttagning innehåller också en signaturbehörighet för delad åtkomst för att permanent ta bort en blobögonblicksbild eller blobversion. Mer information finns i Skapa en tjänst-SAS.